{"id":1866,"date":"2015-01-28T09:12:42","date_gmt":"2015-01-28T09:12:42","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=1866"},"modified":"2025-06-13T23:49:52","modified_gmt":"2025-06-14T06:49:52","slug":"n1ql-dp4-java-sdk","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/n1ql-dp4-java-sdk\/","title":{"rendered":"Visualiza\u00e7\u00e3o usando o N1QL DP4 do Java SDK"},"content":{"rendered":"

Como alguns de voc\u00eas devem saber, a equipe de consulta do Couchbase tem trabalhado arduamente em um recurso novo e interessante, N1QL<\/a>que traz o poder das linguagens de consulta (como SQL) para o Couchbase.<\/p>\n

Eles acabaram de lan\u00e7ar o Developer Preview 4 do N1QL (consulte a postagem no blog aqui<\/a>), com uma s\u00e9rie de melhorias, APIs REST, etc...<\/p>\n

Temos o prazer de anunciar que j\u00e1 est\u00e1 dispon\u00edvel uma Developer Preview do Java SDK compat\u00edvel com o N1QL DP4. O gerenciamento de consultas passou por uma s\u00e9rie de altera\u00e7\u00f5es nesta vers\u00e3o, que reflete melhor o estado em que estar\u00e1 na vers\u00e3o 2.1 (quando o N1QL tamb\u00e9m dever\u00e1 ganhar estabilidade de disponibilidade geral).<\/p>\n

Como obter o c\u00f3digo e usar o recurso<\/h2>\n

Para obter o N1QL e ativ\u00e1-lo, consulte o documenta\u00e7\u00e3o de introdu\u00e7\u00e3o<\/a><\/strong>! Existem etapas espec\u00edficas para ativar a indexa\u00e7\u00e3o N1QL em seus buckets.<\/p>\n

ATUALIZA\u00c7\u00c3O:\u00a0<\/b>Uma segunda pr\u00e9via do SDK para desenvolvedores foi lan\u00e7ada, o pom e os links abaixo foram atualizados de acordo. Role at\u00e9 o final para ver as altera\u00e7\u00f5es...<\/p>\n

Para obter o c\u00f3digo para essa Developer Preview, use o seguinte snippet em seu Maven pom.xml<\/code> ou fa\u00e7a o download do n\u00facleo-io<\/a> e cliente java<\/a> jarros diretamente.<\/p>\n

\n
\r\n    \r\n        com.couchbase.client\r\n        java-client\r\n        2.1.0-dp2\r\n    \r\n\r\n\r\n\r\n    \r\n        couchbase\r\n        couchbase repo\r\n        https:\/\/files.couchbase.com\/maven2\r\n        false\r\n    \r\n\r\n<\/code><\/pre>\n
\n
Como esse \u00e9 um recurso experimental, voc\u00ea precisa ativ\u00e1-lo explicitamente no SDK. Isso pode ser feito de duas maneiras: passando -Dcom.couchbase.queryEnabled=true<\/code> como um par\u00e2metro da JVM ou usando Ambiente principal<\/code> ao inicializar o Aglomerado<\/code> em c\u00f3digo:<\/p>\n
Para reproduzir os exemplos deste blog (que se baseiam uns nos outros, ou seja, copie todos os trechos em uma classe Java para obter um exemplo funcional completo<\/em>), voc\u00ea tamb\u00e9m pode usar o c\u00f3digo abaixo para gerar dois documentos que podem ser consultados:<\/p>\n
O que mudou desde a vers\u00e3o 2.0.3 \/ N1QL DP3?<\/h2>\n
As altera\u00e7\u00f5es mais not\u00e1veis est\u00e3o descritas abaixo.<\/p>\n
Consulta<\/code> interface renomeada para Declara\u00e7\u00e3o<\/code><\/h3>\n
No N1QL, uma consulta completa \u00e9 composta, no m\u00ednimo, de uma Declara\u00e7\u00e3o (por exemplo. SELECT * FROM default<\/code>), mas tamb\u00e9m pode ter valores posicionais\/nomeados e par\u00e2metros de solicita\u00e7\u00e3o adicionais (como tempos limite do lado do servidor, consist\u00eancia da varredura, etc.).<\/p>\n
O Consulta<\/code> nas vers\u00f5es anteriores representava apenas esse componente de declara\u00e7\u00e3o e, portanto, foi renomeada para Declara\u00e7\u00e3o<\/code>.<\/p>\n
Consulta<\/code> hierarquia de classes introduzida<\/h3>\n
Consulta<\/code> foi de fato mantido, mas para representar a consulta N1QL inteira. Uma hierarquia de classes foi introduzida, representando consultas desde as mais simples (uma \u00fanica instru\u00e7\u00e3o, SimplesQuery<\/code>) a outros mais avan\u00e7ados (Consulta Parametrizada<\/code>, Consulta Preparada<\/code>).<\/p>\n
As consultas podem ser criadas por meio de m\u00e9todos de f\u00e1brica no Consulta<\/code> classe abstrata.<\/p>\n
\u00c9 poss\u00edvel emitir consultas com instru\u00e7\u00f5es avan\u00e7adas n\u00e3o cobertas pela DSL usando os m\u00e9todos que recebem uma String como instru\u00e7\u00e3o, por exemplo, para garantir que haja um \u00edndice N1QL em nosso bucket de destino:<\/p>\n
Par\u00e2metros para declara\u00e7\u00f5es e consultas<\/h3>\n
O DP4 introduz o conceito de declara\u00e7\u00f5es parametrizadas. Essas declara\u00e7\u00f5es t\u00eam espa\u00e7os reservados que podem ser preenchidos pelo servidor passando seus valores na consulta. Os espa\u00e7os reservados s\u00e3o nomeados (com a tag $name<\/code> ) ou posicional (com o formato $1<\/code> formato).<\/p>\n
Essas consultas s\u00e3o representadas por um Consulta Parametrizada<\/code>assumindo valores na forma de a JsonObject<\/code> de pares nome-valor para placeholders nomeados ou JsonArray<\/code> de valores para placeholders posicionais. Observa\u00e7\u00e3o:<\/strong> Atualmente, h\u00e1 um bug no N1QL DP4 que impede que os par\u00e2metros nomeados funcionem; em vez disso, use par\u00e2metros posicionais.<\/em><\/p>\n
Al\u00e9m disso, QueryParams<\/code> descreve todos os par\u00e2metros de consulta restantes que s\u00e3o compat\u00edveis com o SDK: ID de contexto do cliente, tempos limite do lado do servidor, consist\u00eancias de varredura. Eles podem ser adicionados a qualquer solicita\u00e7\u00e3o usando a fun\u00e7\u00e3o ad-hoc Consulta<\/code> m\u00e9todo de f\u00e1brica.<\/p>\n
Declara\u00e7\u00f5es preparadas<\/h3>\n
Outro grande recurso novo do N1QL DP4 \u00e9 a introdu\u00e7\u00e3o de instru\u00e7\u00f5es preparadas. Esses comandos s\u00e3o criados em duas etapas: - analisar a instru\u00e7\u00e3o e produzir um plano de consulta. - executar o plano de consulta e retornar os resultados.<\/p>\n
A etapa de prepara\u00e7\u00e3o, que retorna um plano de consulta, pode ser ignorada ap\u00f3s a primeira ocorr\u00eancia, desde que o plano tenha sido armazenado em cache em algum lugar pelo usu\u00e1rio. Isso permite que o servidor pule uma etapa, o que representa um ganho de tempo.<\/p>\n
A Plano de consulta<\/code> pode ser obtido do servidor chamando Bucket.prepare(s)<\/code>, s<\/strong> sendo qualquer Declara\u00e7\u00e3o<\/code>. Esse objeto pode ser armazenado em cache e reutilizado v\u00e1rias vezes posteriormente.<\/p>\n
Para executar um plano, use Bucket.query(Query.prepared(plan))<\/code>. Observe que o preparado<\/code> O m\u00e9todo de f\u00e1brica tamb\u00e9m pode aceitar par\u00e2metros de consulta e valores de espa\u00e7o reservado (desde que a declara\u00e7\u00e3o original tenha os espa\u00e7os reservados correspondentes).<\/p>\n
Altera\u00e7\u00f5es no formato dos resultados<\/h3>\n
O DP4 introduziu v\u00e1rias altera\u00e7\u00f5es no formato da resposta do servidor, que foram refletidas no SDK, em Resultado de consulta ass\u00edncrona<\/code> (a vers\u00e3o s\u00edncrona Resultado da consulta<\/code> tem altera\u00e7\u00f5es semelhantes):<\/p>\n