{"id":13854,"date":"2022-11-03T13:43:33","date_gmt":"2022-11-03T20:43:33","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=13854"},"modified":"2024-09-12T01:42:30","modified_gmt":"2024-09-12T08:42:30","slug":"from-n1ql-to-javascript-and-back-part-7","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/from-n1ql-to-javascript-and-back-part-7\/","title":{"rendered":"De N1QL a JavaScript y viceversa - Parte 7: Almacenamiento jer\u00e1rquico en JavaScript"},"content":{"rendered":"

En blogs anteriores, cubrimos la ejecuci\u00f3n de N1QL (SQL++) desde JavaScript\u00a0funciones<\/a>Tramitaci\u00f3n de documentos\u00a0a trav\u00e9s de iteradores<\/a>,\u00a0manipular datos,<\/a> gesti\u00f3n de errores<\/a>, declaraciones preparadas<\/a> y otros temas avanzados<\/a>. El \u00faltimo tema a tratar es una nueva caracter\u00edstica a\u00f1adida a 7.1 que permite opciones de almacenamiento de bibliotecas JavaScript.<\/span><\/p>\n

Almacenamiento jer\u00e1rquico de bibliotecas JavaScript<\/span><\/h2>\n

Otro cambio importante en 7.1 es que el almacenamiento de la biblioteca JavaScript ha pasado de ser plano a jer\u00e1rquico.<\/span><\/p>\n

Esto significa que, junto a las bibliotecas globales, ahora puedes tener bibliotecas creadas bajo un bucket y un scope.<\/span><\/p>\n

Las bibliotecas globales est\u00e1n disponibles para su uso como UDF globales y de \u00e1mbito, mientras que las bibliotecas de \u00e1mbito s\u00f3lo est\u00e1n disponibles para su uso para UDF de \u00e1mbito creadas bajo el mismo \u00e1mbito que la biblioteca.<\/span><\/p>\n

Esto significa que mientras que, al utilizar bibliotecas globales, puede seguir tratando las bibliotecas como una extensi\u00f3n de su aplicaci\u00f3n, y al publicar una nueva biblioteca modifica autom\u00e1ticamente todas sus instancias en distintos buckets y \u00e1mbitos, si s\u00f3lo se le ha concedido la licencia gestionar_funciones_de_alcance_externo<\/em> y quieres crear bibliotecas para tu propio uso, puedes hacerlo.<\/span><\/p>\n

O puede que, como desarrollador de aplicaciones, quieras crear implementaciones espec\u00edficas de ciertas bibliotecas globales, por ejemplo, una instancia local con c\u00f3digo nuevo que est\u00e1s implementando para la pr\u00f3xima versi\u00f3n de tu aplicaci\u00f3n.<\/span><\/p>\n

Manipulaci\u00f3n de bibliotecas<\/span><\/h2>\n

En jsevaluator<\/em> El punto final REST utilizado para manipular las bibliotecas mostradas al principio de este blog se ha ampliado para aceptar buckets y scope.<\/span><\/p>\n

Esto se hace as\u00ed:<\/span><\/p>\n

Biblioteca mundial<\/strong><\/p>\n

curl -v -X POST https:\/\/localhost:8093\/evaluator\/v1\/libraries\/math -u Administrador:contrase\u00f1a -d 'function add(a, b) { let data = a + b; return data; }'<\/pre>\n
Biblioteca<\/strong><\/p>\n
curl -v -X POST 'https:\/\/localhost:8093\/evaluator\/v1\/libraries\/math?bucket=b1&scope=s1' -u Administrador:contrase\u00f1a -d 'function add(a, b) { let data = a + b; return data; }'<\/pre>\n
Es evidente que el usuario autenticado debe tener los privilegios adecuados para crear bibliotecas en cada nivel: <\/span>gestionar_funciones_externas<\/span><\/em> para bibliotecas mundiales y <\/span>gestionar_funciones_de_alcance_externo<\/span><\/em> para las bibliotecas de \u00e1mbito.<\/span><\/p>\n
Adem\u00e1s, el cubo y el \u00e1mbito referenciados ya deben existir.<\/span><\/p>\n
A costa de repetirme, el comando curl debe contener toda la biblioteca, no s\u00f3lo cualquier nueva funci\u00f3n que desee definir: recuerde que cualquier cambio que realice se reflejar\u00e1 en todas las UDFs que utilicen la biblioteca, y cualquier funci\u00f3n que pueda soltar por error afectar\u00e1 potencialmente a m\u00faltiples \u00e1mbitos y UDFs, as\u00ed que tenga cuidado.<\/span><\/p>\n
Para evitar dudas, esto tambi\u00e9n se aplica a la interfaz de usuario.\u00a0<\/span><\/p>\n
Referencias a bibliotecas en UDFs<\/span><\/h2>\n
Todos los ejemplos de <\/span>CREAR FUNCI\u00d3N<\/span> vistos hasta ahora utilizan un simple identificador de cadena para la biblioteca, lo que significa que utilizan una biblioteca global.<\/span><\/p>\n
CREAR FUNCI\u00d3N ... LENGUAJE JAVASCRIPT<\/span><\/em> admite los tres formatos siguientes para los nombres de las bibliotecas:<\/span><\/p>\n