Este blog anterior repasa los fundamentos de la ejecución de sentencias N1QL dentro de funciones JavaScript.
Ahora pasamos a...
Iteradores/Valores de procesamiento
Hasta ahora hemos evitado a propósito las declaraciones que devuelven datos, y la devolución de datos de la función.
Aquí es donde empezamos a explorar la recopilación de datos.
En N1QL() referenciada directamente o a través de la magia del transpilador, devuelve un manejador de sentencia. El manejador viene en forma de objeto JavaScript y tiene un iterador asociado, por ejemplo:
|
1 |
var q = SELECCIONAR * DESDE b1; |
No voy a dedicar mucho tiempo a describir los iteradores, así que aquí están los conceptos básicos:
- Puede obtener el siguiente valor de un iterador utilizando la función next() método.
- En hecho es verdadera si no hay más documentos que obtener.
- Aunque puede utilizar el iterador next() y hecho en un bucle while para obtener todos los documentos, una construcción más legible es el método para..de bucle sobre el propio manejador de sentencia.
- No es necesario recuperar todos los valores: puede descartar una sentencia en cualquier momento llamando a la función de la sentencia cerrar() aunque, como veremos más adelante, no es necesario hacerlo.
Ponerlo todo junto:
y la función correspondiente:
|
1 |
CREAR FUNCIÓN doSelect() IDIOMA JAVASCRIPT AS "doSelect" EN "udfblog"; |
En este ejemplo, una matriz denominada res acumula los documentos que obtenemos de b1 a través del iterador qy, a continuación, se utiliza para devolverlos a la persona que los solicita.
Un par de notas al margen
En términos generales, probablemente sea mejor procesar los valores de la consulta a medida que se reciben en el archivo para en lugar de acumularlos en una matriz, ya que esto tiene implicaciones de uso de memoria transitoria.
A la inversa, devolver un valor de matriz desde una función permite que una sentencia seleccione de la función, por ejemplo:
|
1 |
SELECCIONAR * DESDE doSelect() AS funcDocs; |
Esto es muy parecido a lo que haría con las funciones de tabla o las tablas derivadas de colecciones que ha encontrado en el mundo relacional.
En el mundo N1QL se conocen como exploraciones de expresión.
Por supuesto, va por sí mismo que si todo lo que quieres que tu función haga es devolver algunos documentos de un espacio clave sin más lógica, probablemente sea mejor escribir una función en línea.
De vuelta al iterador
Una vez que haya terminado de procesar los valores, el iterador se cierra automáticamente, por lo que no tiene que hacer nada.
Si el iterador no se vacía, es una buena práctica cerrarlo, aunque no es estrictamente necesario, ya que se cerrará automáticamente cuando la función regrese, así como en otras circunstancias como veremos más adelante.
Dentro de la para ... de ... es perfectamente válido tener otras declaraciones N1QL: algunas cosas a tener en cuenta se describirán en secciones posteriores.
Valores de procesamiento
Intentemos utilizar los valores devueltos por el select, en lugar de devolverlos sin más:
|
1 2 3 4 5 6 7 8 9 |
función doSelect() { var q = SELECCIONAR * DESDE b1 LÍMITE 2; var res = []; para (const doc de q) { deje f1 = doc.f1; res.pulse(f1); } devolver res; } |
Nada especialmente sofisticado, sólo extraer un campo del documento.
Ejecutando esta función se obtiene:
|
1 2 3 4 5 6 |
[ [ null, null ] ] |
¿Qué ocurre? ¿Por qué no vuelve f1?
Podemos adivinar la respuesta ejecutando:
|
1 |
SELECCIONAR * DESDE b1 LÍMITE 2 |
Y viendo, en la IU:
|
1 2 3 4 5 6 7 8 9 10 11 12 |
[ { "b1": { "f1": 1 } }, { "b1": { "f1": 2 } } ] |
f1 es un campo de b1y no el documento seleccionado.
Cualquiera de ellos hace lo que quieres:
|
1 2 3 4 5 6 7 8 9 |
función doSelect() { var q = SELECCIONE * DESDE b1 LÍMITE 2; var res = []; para (const doc de q) { deje f1 = doc.b1.f1; res.pulse(f1); } devolver res; } |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
función doSelect() { var q = SELECCIONE en bruto b1 DESDE b1 LÍMITE 2; var res = []; para (const doc de q) { deje f1 = doc.f1; res.pulse(f1); } devolver res; } función doSelect() { var q = SELECCIONE f1 DESDE b1 LÍMITE 2; var res = []; para (const doc de q) { deje f1 = doc.f1; res.pulse(f1); } devolver res; } |
Sentencias DML
Considera la siguiente función:
|
1 2 3 4 |
función doCopy() { var q1 = INSERTAR EN b1 (CLAVE UUID(), VALOR v) SELECCIONE b1 AS v DESDE b1; var q2 = BORRAR DESDE b1 DONDE LONGITUD(meta().id) = 2; } |
|
1 |
CREAR FUNCIÓN doCopy() IDIOMA JAVASCRIPT AS "doCopy" EN "udfblog" |
Esta función crea nuevos documentos en b1 copiándolos de los documentos existentes y elimina los documentos antiguos.
El hecho de que q1 y q2 son iteradores, incluso cuando las sentencias no devuelven valores no debería sorprendernos demasiado: como veremos más adelante, las sentencias DML pueden devolver valores, y lo que es peor, el transpilador no siempre puede determinar si se están devolviendo valores o no, de ahí que la sentencia N1QL() siempre devuelve un iterador.
La implicación de esto es que una vez que el N1QL() la sentencia N1QL puede estar ejecutándose de forma asíncrona en segundo plano, dejando la función JavaScript libre para ejecutar otro código antes de obtener los datos.
En jsevaluator elimina cualquier ambigüedad de comportamiento obligando a las sentencias que no devuelven valores a ejecutarse inmediatamente y en serie, lo que significa que esperará a que se complete cada sentencia DML antes de que comience la siguiente.
No es necesaria ninguna acción sobre el iterador, ni siquiera cerrarlo.
Esto es coherente con el comportamiento que instintivamente esperamos: queremos terminar de insertar una copia de los documentos existentes antes de empezar a borrar los antiguos - ¡o puede que no estemos haciendo una copia de todos los documentos originales!
Sentencias DML que devuelven valores
Se puede hacer que las sentencias DML de N1QL devuelvan valores, como en la función siguiente:
|
1 2 3 4 5 6 7 8 9 |
función doCopy() { var q1 = INSERTAR EN b1 (CLAVE UUID(), VALOR v) SELECCIONE b1 AS v DESDE b1 DEVOLVER meta().id, b1; var res = [] para (const doc de q1) { res.pulse(doc); } var q2 = BORRAR DESDE b1 DONDE LONGITUD(meta().id) = 2; devolver res; } |
Los resultados devueltos se procesan de forma muy similar a los de SELECCIONE declaraciones.
La principal diferencia respecto a las sentencias DML que no devuelven resultados es que cuando no se devuelven resultados, todos los cambios al disco se realizan en cuanto la sentencia devuelve, mientras que cuando se devuelven resultados la sentencia avanza a medida que se recoge cada documento individual del iterador: hay que procesar todos los valores devueltos para que todos los cambios lleguen al disco.
De nuevo, la sentencia se ejecuta de forma asíncrona, por lo que, al recopilar cada resultado individual, no debe asumir que es la última modificación realizada en el disco: podrían haberse realizado más, con los resultados relevantes en cola a la espera de ser recopilados.
Al igual que con las sentencias DML que no devuelven resultados, las que sí lo hacen se ejecutan en serie, lo que significa que si no se procesan todos los resultados en cola en el iterador para cuando se inicie la siguiente sentencia, el jsevaluator completará la sentencia actual descartando todos los valores no procesados.
Conclusión
Hemos cubierto el procesamiento de documentos a través de N1QL y la ejecución de la manipulación de datos.
A continuación, vamos a ver cómo gestionar los errores.
