{"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\/pt\/from-n1ql-to-javascript-and-back-part-7\/","title":{"rendered":"De N1QL para JavaScript e vice-versa - Parte 7: Armazenamento hier\u00e1rquico em JavaScript"},"content":{"rendered":"

Em blogs anteriores, abordamos a execu\u00e7\u00e3o do N1QL (SQL++) a partir do JavaScript\u00a0fun\u00e7\u00f5es<\/a>, processamento de documentos\u00a0por meio de iteradores<\/a>,\u00a0manipula\u00e7\u00e3o de dados,<\/a> tratamento de erros<\/a>, declara\u00e7\u00f5es preparadas<\/a> e outros t\u00f3picos avan\u00e7ados<\/a>. O \u00faltimo t\u00f3pico a ser abordado \u00e9 um recurso rec\u00e9m-adicionado \u00e0 vers\u00e3o 7.1 que permite op\u00e7\u00f5es de armazenamento de bibliotecas JavaScript.<\/span><\/p>\n

Armazenamento hier\u00e1rquico de bibliotecas JavaScript<\/span><\/h2>\n

Outra grande mudan\u00e7a na vers\u00e3o 7.1 \u00e9 o fato de o armazenamento da biblioteca JavaScript ter mudado de plano para hier\u00e1rquico.<\/span><\/p>\n

Isso significa que, al\u00e9m das bibliotecas globais, agora voc\u00ea pode ter bibliotecas criadas em um bucket e um escopo.<\/span><\/p>\n

As bibliotecas globais est\u00e3o dispon\u00edveis para uso como UDFs globais e de escopo, enquanto as bibliotecas de escopo s\u00f3 est\u00e3o dispon\u00edveis para uso em UDFs de escopo criados no mesmo escopo da biblioteca.<\/span><\/p>\n

Isso significa que, ao usar bibliotecas globais, voc\u00ea pode continuar a tratar as bibliotecas como uma extens\u00e3o do seu aplicativo e, ao publicar uma nova biblioteca, voc\u00ea altera automaticamente todas as suas inst\u00e2ncias em diferentes compartimentos e escopos, se voc\u00ea s\u00f3 tiver recebido o manage_external_scope_functions<\/em> e quiser criar bibliotecas para seu pr\u00f3prio uso, voc\u00ea pode.<\/span><\/p>\n

Ou talvez, como desenvolvedor de aplicativos, voc\u00ea queira criar implementa\u00e7\u00f5es espec\u00edficas de escopo de determinadas bibliotecas globais, por exemplo, uma inst\u00e2ncia local com o novo c\u00f3digo que voc\u00ea est\u00e1 implementando para a pr\u00f3xima vers\u00e3o do seu aplicativo.<\/span><\/p>\n

Manipula\u00e7\u00e3o de bibliotecas<\/span><\/h2>\n

O jsevaluator<\/em> O endpoint REST usado para manipular as bibliotecas mostradas no in\u00edcio deste blog foi ampliado para aceitar buckets e escopo.<\/span><\/p>\n

Isso \u00e9 feito da seguinte forma:<\/span><\/p>\n

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

curl -v -X POST https:\/\/localhost:8093\/evaluator\/v1\/libraries\/math -u Administrator:password -d 'function add(a, b) { let data = a + b; return data; }'<\/pre>\n
Biblioteca de escopo<\/strong><\/p>\n
curl -v -X POST 'https:\/\/localhost:8093\/evaluator\/v1\/libraries\/math?bucket=b1&scope=s1' -u Administrator:password -d 'function add(a, b) { let data = a + b; return data; }'<\/pre>\n
\u00c9 evidente que o usu\u00e1rio autenticado precisa ter os privil\u00e9gios adequados para criar bibliotecas em cada n\u00edvel: <\/span>manage_external_functions<\/span><\/em> para bibliotecas globais e <\/span>manage_external_scope_functions<\/span><\/em> para bibliotecas de escopo.<\/span><\/p>\n
Al\u00e9m disso, o bucket e o escopo referenciados j\u00e1 devem existir.<\/span><\/p>\n
Para n\u00e3o me repetir, o comando curl deve conter toda a biblioteca, e n\u00e3o apenas qualquer nova fun\u00e7\u00e3o que voc\u00ea queira definir: lembre-se de que qualquer altera\u00e7\u00e3o que voc\u00ea fizer ser\u00e1 refletida em todos os UDFs que usam a biblioteca, e qualquer fun\u00e7\u00e3o que voc\u00ea descartar por engano poder\u00e1 afetar v\u00e1rios escopos e UDFs, portanto, tenha cuidado.<\/span><\/p>\n
Para evitar d\u00favidas, isso tamb\u00e9m se aplica \u00e0 interface do usu\u00e1rio.\u00a0<\/span><\/p>\n
Refer\u00eancia a bibliotecas em UDFs<\/span><\/h2>\n
Todos os exemplos de <\/span>CRIAR FUN\u00c7\u00c3O<\/span> vistos at\u00e9 agora usam um identificador de string simples para a biblioteca, o que significa que eles usam uma biblioteca global.<\/span><\/p>\n
CRIAR FUN\u00c7\u00c3O ... LINGUAGEM JAVASCRIPT<\/span><\/em> suporta os tr\u00eas formatos a seguir para nomes de bibliotecas:<\/span><\/p>\n