{"id":10499,"date":"2021-01-27T08:16:01","date_gmt":"2021-01-27T16:16:01","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=10499"},"modified":"2025-06-13T17:32:23","modified_gmt":"2025-06-14T00:32:23","slug":"query-couchbase-data-structures-with-n1ql-sql-for-json","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/query-couchbase-data-structures-with-n1ql-sql-for-json\/","title":{"rendered":"Estruturas de dados e consultas com o Couchbase N1QL (SQL para JSON)"},"content":{"rendered":"

No <\/span>Estruturas de dados para aplicativos NoSQL<\/span><\/a> postar, usamos o acesso simplificado a dados JSON por meio de cole\u00e7\u00f5es nativas, mapas e muito mais. <\/span>Esta postagem demonstra a consulta desses dados usando consultas N1QL de n\u00edvel superior, a linguagem baseada em SQL para JSON.<\/span><\/p>\n

\"chart<\/a>

Resumo dos tipos de estrutura de dados do Couchbase e amostras de JSON.<\/p><\/div>\n

Os desenvolvedores podem se concentrar no gerenciamento de estruturas de dados b\u00e1sicas e tipos de dados usando linguagens de programa\u00e7\u00e3o. Enquanto isso, os DBAs e os analistas podem acessar os mesmos dados usando uma linguagem de consulta. O Couchbase faz isso usando m\u00e9todos de indexa\u00e7\u00e3o de dados NoSQL e servi\u00e7os de consulta N1QL.<\/span><\/p>\n

As consultas de pesquisa com o mecanismo de pesquisa de texto completo do Couchbase tamb\u00e9m s\u00e3o poss\u00edveis e ser\u00e3o abordadas em um post futuro.<\/span><\/p>\n

O que \u00e9 indexa\u00e7\u00e3o de banco de dados NoSQL?\u00a0<\/span><\/h2>\n

A indexa\u00e7\u00e3o examina os dados e determina como encontrar esses elementos novamente. A indexa\u00e7\u00e3o pode ser aplicada a documentos JSON, chaves\/campos ou valores em campos. As chaves em documentos JSON funcionam como nomes de colunas em sistemas de indexa\u00e7\u00e3o de bancos de dados tabulares.<\/span><\/p>\n

O banco de dados gerencia essas cole\u00e7\u00f5es de elementos e valores como \u00edndices que apontam para a fonte. O backend do banco de dados atualiza a indexa\u00e7\u00e3o \u00e0 medida que os documentos s\u00e3o alterados durante o armazenamento de dados. Enquanto isso, os DBAs podem otimizar a indexa\u00e7\u00e3o para casos de uso espec\u00edficos, como grava\u00e7\u00f5es ou consultas de alto volume.<\/span><\/p>\n

Com o uso de \u00edndices, as consultas N1QL podem encontrar rapidamente os valores de campo correspondentes sem precisar examinar os dados originais. Esse m\u00e9todo tamb\u00e9m se aplica \u00e0s estruturas de dados comuns, <\/span>cole\u00e7\u00f5es e escopos introduzidos em <\/span>Couchbase 7.0<\/b><\/a>.<\/span><\/p>\n

Consulta de estruturas de dados do Couchbase com N1QL<\/span><\/h2>\n

O console da Web do Couchbase \u00e9 uma maneira f\u00e1cil de visualizar documentos de estrutura de dados no banco de dados. Observe como os documentos de estrutura de dados geralmente s\u00e3o muito mais simples do que os documentos JSON mais complexos.<\/span><\/p>\n

\"data

Lista de documentos de estrutura de dados no bucket<\/p><\/div>\n

Para come\u00e7ar a escrever consultas N1QL, \u00e9 necess\u00e1rio indexar os dados de sua estrutura de dados. \u00c9 necess\u00e1rio, no m\u00ednimo, um \u00edndice prim\u00e1rio em todo o bucket para opera\u00e7\u00f5es b\u00e1sicas.<\/span><\/p>\n

CREATE PRIMARY INDEX ON `travel-sample`;<\/pre>\n
Para documentos que usam os novos recursos de cole\u00e7\u00f5es de <\/span>Couchbase 7.0<\/b>eles tamb\u00e9m devem ser indexados.<\/span><\/p>\n
CREATE PRIMARY INDEX ON `travel-sample`.`scope1`.`col1`<\/pre>\n
P<\/strong>\u00edndices secund\u00e1rios <\/b>dificuldade com grandes conjuntos de dados mas s\u00e3o excelentes para explorar rapidamente pequenas quantidades de dados. Use os \u00edndices secund\u00e1rios globais (GSI) ao passar para a produ\u00e7\u00e3o em um projeto de Big Data.<\/span><\/p>\n
Listagem de todos os documentos de dados e IDs<\/h2>\n
Entretanto, uma indexa\u00e7\u00e3o mais direcionada nem sempre \u00e9 poss\u00edvel, pois as estruturas de dados podem n\u00e3o ter chaves nomeadas. <\/span>Por exemplo, um contador \u00e9 apenas um ID e um valor inteiro sem nome de campo. Por\u00e9m, se voc\u00ea tiver um mapa, poder\u00e1 criar um \u00edndice que tenha como alvo uma chave interna.<\/span><\/p>\n
Uma consulta b\u00e1sica para o ID do documento pode retornar todos os documentos e mostrar os nomes de campo que est\u00e3o sendo usados.<\/span><\/p>\n
SELECT META().id, * FROM `travel-sample`<\/pre>\n
\"query<\/a><\/p>\n
CurrentScore <\/span><\/i>\u00e9 um contador b\u00e1sico, enquanto <\/span>gameList <\/span><\/i>\u00e9 uma lista\/cole\u00e7\u00e3o, etc.<\/span><\/p>\n
Consulta de escopos\/cole\u00e7\u00f5es para estruturas de dados<\/h3>\n
Se estiver usando escopos e cole\u00e7\u00f5es, adicione-os \u00e0 cl\u00e1usula from.<\/span><\/p>\n
SELECT * FROM `travel-sample`.`scope1`.`col1`<\/pre>\n
Recupere um valor espec\u00edfico de um objeto de estrutura de dados nomeado, adicionando-o \u00e0 cl\u00e1usula where.<\/span><\/p>\n
SELECT META().id, * FROM `travel-sample` WHERE META().id = 'currentScore'<\/pre>\n
\"JSON<\/a><\/p>\n
Ao especificar nomes de campo (e nenhum ID), a consulta retorna valores correspondentes em todos os documentos.<\/span><\/p>\n
SELECT nome, contato FROM `travel-sample`<\/pre>\n
\"JSON<\/a><\/p>\n
A consulta retorna objetos com os campos espec\u00edficos e seus valores. Nos resultados acima, apenas uma das estruturas de dados tinha o campo <\/span>contato <\/span><\/i>campo. Dois outros tinham um <\/span>nome <\/span><\/i>mas v\u00e1rios objetos em branco mostram que n\u00e3o havia campos correspondentes.<\/span><\/p>\n
Para serem dimension\u00e1veis, todos os aplicativos de consulta tamb\u00e9m devem usar \u00edndices secund\u00e1rios globais (GSI) para campos espec\u00edficos.<\/span><\/p>\n
Isso <\/span>Pr\u00e1ticas recomendadas de indexa\u00e7\u00e3o de banco de dados<\/span><\/a> O artigo aborda mais cen\u00e1rios de ci\u00eancia da computa\u00e7\u00e3o usados na engenharia de software de Big Data.<\/span><\/p>\n
Reunindo tudo isso<\/span><\/h2>\n
Como voc\u00ea pode ver, a consulta de documentos e subcomponentes relacionados \u00e9 muito simples com o Couchbase. O uso estrat\u00e9gico de m\u00e9todos de indexa\u00e7\u00e3o sofisticados oferece ainda mais maneiras de acessar os dados que seus aplicativos est\u00e3o criando.<\/span><\/p>\n
O Couchbase simplifica drasticamente as arquiteturas de sistema, permitindo que os desenvolvedores comecem a trabalhar sem muito trabalho pesado. Essas refer\u00eancias o ajudar\u00e3o a come\u00e7ar rapidamente.<\/span><\/p>\n