El lenguaje de consulta N1QL dispone de un rico conjunto de facilidades para trabajar con arrays JSON. En este art\u00edculo, cubriremos constantes de arrays, facilidades para buscar en arrays, formas de transformar arrays, y algunas funciones \u00fatiles de N1QL para arrays. El formato es interactivo; abre una instancia de Couchbase y prueba los ejemplos t\u00fa mismo.<\/p>\n
Para empezar, ve a la consola de administraci\u00f3n de tu instancia de Couchbase y crea un bucket llamado \"test\".<\/p>\n
Alternativamente, puede crear el cubo desde la l\u00ednea de comandos, de la siguiente manera:<\/p>\n
Con\u00e9ctese a la instancia utilizando el shell CBQ de la siguiente manera:<\/p>\n A continuaci\u00f3n, en CBQ, cree un \u00edndice primario en su nuevo bucket:<\/p>\n Ahora estamos listos para empezar.<\/p>\n En primer lugar, N1QL te permite crear valores de array directamente como constantes de array, as\u00ed:<\/p>\n Las constantes pueden incluir incluso valores extra\u00eddos de la base de datos: Tambi\u00e9n se admite la selecci\u00f3n de elementos por \u00edndice basado en cero:<\/p>\n La cl\u00e1usula IN se utiliza para comprobar la pertenencia.<\/p>\n La cl\u00e1usula ANY se utiliza para verificar que al menos un elemento de la matriz coincide con alguna condici\u00f3n:<\/p>\n La cl\u00e1usula EVERY se utiliza para verificar que todos los elementos de un array cumplen alguna condici\u00f3n:<\/p>\n ANY AND EVERY es muy similar a EVERY, pero EVERY es verdadero para matrices vac\u00edas, pero ANY AND EVERY es falso:<\/p>\n El operador [:] sirve para trocear, es decir, tomar trozos de matrices.<\/p>\n El primer valor de la expresi\u00f3n slice es el \u00edndice por el que se debe empezar (basado en cero); el segundo es el primer \u00edndice que se debe excluir. Esta convenci\u00f3n deber\u00eda resultarle familiar de otros lenguajes de programaci\u00f3n.<\/p>\n Deben indicarse tanto el inicio como el final de la porci\u00f3n. Los valores negativos enumeran desde el final de la matriz:<\/p>\n La expresi\u00f3n ARRAY permite transformar una matriz en otra.<\/p>\n La expresi\u00f3n ARRAY tambi\u00e9n admite la selecci\u00f3n:<\/p>\n La expresi\u00f3n de destino puede incluir no s\u00f3lo cada valor, sino tambi\u00e9n los \u00edndices:<\/p>\n Para obtener m\u00e1s informaci\u00f3n sobre las operaciones con matrices en N1QL, consulte la documentaci\u00f3n aqu\u00ed<\/a>.<\/p>\n N1QL dispone de un amplio conjunto de funciones para operar con matrices JSON.<\/p>\n ARRAY_LENGTH devuelve la longitud de una matriz.<\/p>\n ARRAY_APPEND a\u00f1ade elementos al final de una matriz.<\/p>\n ARRAY_CONCAT es similar, pero une dos matrices.<\/p>\n ARRAY_SORT ordena los elementos de una matriz.<\/p>\n Por \u00faltimo, ARRAY_DISTINCT elimina los duplicados de una matriz.<\/p>\n Hay muchas m\u00e1s funciones de array \u00fatiles en N1QL, demasiadas para cubrirlas aqu\u00ed. Puedes encontrar la lista completa aqu\u00ed<\/a>.<\/p>\ncurl -X POST -u Administrador:contrase\u00f1a -d name=prueba -d ramQuotaMB=100 -d authType=sasl -d saslPassword=donotuse -d proxyPort=11224 -d bucketType=couchbase https:\/\/localhost:8091\/pools\/default\/buckets<\/code><\/p>\ncbq -e https:\/\/localhost:8091 -u Administrador -p contrase\u00f1a<\/code><\/p>\ncbq> crear \u00edndice primario en test;<\/code><\/p>\nConstantes de matriz de Couchbase<\/h4>\n
cbq> select [1,2,3] as num_array, [\"a\", \"b\", \"c\"] as string_array, [\"1\", 2, [3, \"4\"], {\"a\": \"b\"}] as mixed_array;<\/code><\/p>\n \"results\": [\r\n {\r\n \"mixed_array\": [\r\n \"1\",\r\n 2,\r\n [\r\n 3,\r\n \"4\"\r\n ],\r\n {\r\n \"a\": \"b\"\r\n }\r\n ],\r\n \"num_array\": [\r\n 1,\r\n 2,\r\n 3\r\n ],\r\n \"string_array\": [\r\n \"a\",\r\n \"b\",\r\n \"c\"\r\n ]\r\n }\r\n ]\r\n<\/pre>\n
\ncbq> insert into prueba (clave, valor) values (\"ex1\", {\"v1\" : 7, \"v2\" : \"p\u00e1jaro\", \"v3\" : 99});<\/code><\/p>\ncbq> select [1, v1, 3] as num_array, [\"a\", v2, \"c\"] as string_array from test where v3 = 99;<\/code><\/p>\n \"results\": [\r\n {\r\n \"num_array\": [\r\n 1,\r\n 7,\r\n 3\r\n ],\r\n \"string_array\": [\r\n \"a\",\r\n \"bird\",\r\n \"c\"\r\n ]\r\n }\r\n ]\r\n<\/pre>\ncbq> select [\"manzana\", \"pl\u00e1tano\", \"cereza\", \"d\u00e1til\", \"baya del sa\u00faco\"][1] as val;<\/code><\/p>\n \"results\": [\r\n {\r\n \"val\": \"banana\"\r\n }\r\n ]\r\n<\/pre>\nCouchbase Query Arrays y B\u00fasqueda en Arrays<\/h4>\n
cbq> select (9 IN [1, 2, 3, 4]) as not_found, (9 in [7, 8, 9]) as is_found;<\/code><\/p>\n \"results\": [\r\n {\r\n \"is_found\": true,\r\n \"not_found\": false\r\n }\r\n ]\r\n<\/pre>\ncbq> select (CUALQUIER v EN [1, 2, 3, 4, 5] CUMPLE v > 4 END) as is_found, (CUALQUIER v EN [1, 2, 3, 4, 5] CUMPLE v = 7 END) as not_found;<\/code><\/p>\n \"results\": [\r\n {\r\n \"is_found\": true,\r\n \"not_found\": false\r\n }\r\n ]\r\n<\/pre>\ncbq> select (EVERY v IN [1, 2, 3, 4, 5] SATISFIES v > 0 END) as is_found, (EVERY v in [-1, 0, 1, 2, 3] SATISFIES v > 0 END ) as not_found;<\/code><\/p>\n \"results\": [\r\n {\r\n \"is_found\": true,\r\n \"not_found\": false\r\n }\r\n ]\r\n<\/pre>\ncbq> select (ANY AND EVERY v IN [] SATISFIES v > 0 END) as any_every_res, (EVERY v IN [] SATISFIES v > 0 END) as every_res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"any_every_res\": false,\r\n \"every_res\": true\r\n }\r\n ]\r\n<\/pre>\nRebanar<\/h4>\n
cbq> select [1, 2, 3, 4, 5][1: 3] as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": [\r\n 2,\r\n 3\r\n ]\r\n }\r\n ]\r\n<\/pre>\ncbq> select [1, 2, 3, 4, 5][1: -1] as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": [\r\n 2,\r\n 3,\r\n 4\r\n ]\r\n }\r\n ]\r\n<\/pre>\nTransformaci\u00f3n de matrices Couchbase<\/h4>\n
cbq> select ARRAY v*2 FOR v IN [1, 2, 3, 4, 5] END as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": [\r\n 2,\r\n 4,\r\n 6,\r\n 8,\r\n 10\r\n ]\r\n }\r\n ]\r\n<\/pre>\ncbq> select ARRAY v*2 FOR v IN [1, 2, 3, 4, 5] WHEN v > 2 END as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": [\r\n 6,\r\n 8,\r\n 10\r\n ]\r\n }\r\n ]\r\n<\/pre>\ncbq> SELECT ARRAY {v:pos} FOR pos:v IN [ \"uno\", \"dos\", \"tres\" ] END;<\/code><\/p>\n \"results\": [\r\n {\r\n \"$1\": [\r\n {\r\n \"one\": 0\r\n },\r\n {\r\n \"two\": 1\r\n },\r\n {\r\n \"three\": 2\r\n }\r\n ]\r\n }\r\n ]\r\n<\/pre>\nFunciones Array de Couchbase<\/h4>\n
cbq> select ARRAY_LENGTH([1, 2, 3, 4, 5]) as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": 5\r\n }\r\n ]\r\n<\/pre>\ncbq> select ARRAY_APPEND([1, 2, 3, 4, 5], 9, 10) as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": [\r\n 1,\r\n 2,\r\n 3,\r\n 4,\r\n 5,\r\n 9,\r\n 10\r\n ]\r\n }\r\n ]\r\n<\/pre>\ncbq> select ARRAY_CONCAT([1, 2, 3, 4, 5], [7, 8]) as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": [\r\n 1,\r\n 2,\r\n 3,\r\n 4,\r\n 5,\r\n 7,\r\n 8\r\n ]\r\n }\r\n ]\r\n<\/pre>\ncbq> select ARRAY_SORT([2, 1, 3, 5, 4]) as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": [\r\n 1,\r\n 2,\r\n 3,\r\n 4,\r\n 5\r\n ]\r\n }\r\n ]\r\n<\/pre>\ncbq> select ARRAY_DISTINCT([1, 2, 3, 3, 4, 5, 4, 5]) as res;<\/code><\/p>\n \"results\": [\r\n {\r\n \"res\": [\r\n 5,\r\n 1,\r\n 4,\r\n 2,\r\n 3\r\n ]\r\n }\r\n ]\r\n<\/pre>\nRendimiento<\/h4>\n