Escreva SQL com a assistência do Gemini

Visualizar

Este produto é coberto pelos Termos de ofertas pré-GA dos Termos de Serviço do Google Cloud . Os produtos pré-disponibilidade geral podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Saiba mais nas descrições da fase de lançamento.

Neste documento, descrevemos como usar a Gemini, uma colaboradora com tecnologia de IA no Google Cloud, para ajudar você a realizar as seguintes tarefas no AlloyDB para PostgreSQL:

• Gerar consultas SQL usando comandos de linguagem natural.
• Explicar consultas SQL no editor de consultas.

Saiba como e quando o Gemini para Google Cloud usa seus dados.

Este documento é destinado a administradores de banco de dados e engenheiros de dados que conhecem o AlloyDB e têm alguma familiaridade com SQL e análise de dados. Se você não conhece o AlloyDB, consulte a Visão geral do AlloyDB.

Observação: a assistência de programação faz parte do Gemini Code Assist e está disponível sem custos financeiros até ser incluída na edição Standard do Gemini Code Assist. Essa mudança será comunicada em uma data futura. Nesse momento, você precisará adquirir uma licença da edição Standard do Gemini Code Assist para continuar usando a assistência de programação no AlloyDB para PostgreSQL Studio.

Antes de começar

1. Verifique se o Gemini Cloud Assist está configurado para sua conta de usuário e projeto do Google Cloud .

2. Opcional: se você quiser acompanhar os exemplos neste documento, crie a tabela Singers usando o esquema a seguir:

   CREATE TABLE Singers (
     BirthDate  TIMESTAMPTZ,
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo BYTEA
   );
   

   Depois de criar a tabela Singers, clique em atualizarAtualizar para atualizar o esquema do banco de dados.

Para desativar os recursos do Gemini no AlloyDB, repita esta etapa e desmarque os recursos que você quer desativar.

Papéis e permissões necessárias

Atenção:os usuários com amplo acesso ao banco de dados podem perder dados ao usar o Gemini. Recomendamos usar uma conta com menos privilégios de banco de dados ao usar o Gemini.

Para usar o Gemini com o AlloyDB, você precisa das seguintes permissões:

• alloydb.clusters.get
• alloydb.databases.list
• alloydb.instances.executeSql
• alloydb.instances.list
• alloydb.users.list
• cloudaicompanion.companions.generateCode
• cloudaicompanion.instances.generateCode
• serviceusage.services.get ou serviceusage.services.list

É possível receber essa permissão com o papel roles/alloydb.admin. Se você não tiver esse papel, entre em contato com o administrador da organização para solicitar o acesso. Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Além disso, verifique se você tem permissões no nível do banco de dados para o banco de dados que está usando na autenticação.

Gerar consultas SQL usando comandos de linguagem natural

Como uma tecnologia em estágio inicial, os produtos do Gemini para Google Cloudpodem gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide todas as saídas dos produtos do Gemini para Google Cloud antes de usá-las. Para mais informações, consulte Gemini para Google Cloud e IA responsável.

É possível fornecer comentários (ou solicitações) em linguagem natural do Gemini para gerar consultas baseadas no seu esquema. Por exemplo, é possível solicitar que o Genmini para gerar SQL em resposta aos seguintes comandos:

• "Crie uma tabela que acompanhe os resultados da pesquisa de satisfação do cliente".
• "Adicione uma coluna de data chamada data de nascimento à tabela de cantores".
• "Quantos cantores nasceram nos anos 90?"

Se o esquema mudar, como a adição de uma nova tabela ou coluna, clique em atualizarAtualizar para atualizar seu esquema antes de usar o Gemini.

Observação: quando você insere um comando, as informações sobre o esquema do banco de dados são incluídas nele. Isso pode incluir nomes de tabelas e colunas, tipos de dados e descrições de colunas. O esquema e os dados do banco de dados permanecem no AlloyDB e não são enviados para o Gemini.

Para gerar SQL no AlloyDB com a assistência do Gemini, siga estas etapas:

1. No console do Google Cloud , abra a página AlloyDB.

   Acessar o AlloyDB

2. Selecione um cluster na lista.

3. No menu de navegação, clique em AlloyDB.

4. Selecione um banco de dados e um usuário e digite a senha dele.

5. Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no seu banco de dados.

6. Para consultar seu banco de dados, clique em nova guia do editor de SQL. Verifique se a geração de SQL está ativada.

7. Para gerar SQL, digite um comentário no editor de consultas começando com -- seguido por um comentário de linha única e pressione Return.

   Por exemplo, se você inserir o comando -- add a row to table singers e pressionar Return, o Gemini vai gerar um SQL semelhante ao seguinte:

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   Para continuar o exemplo usando a tabela Singers, se você inserir o comando -- show all singers born in the 70s, o Gemini vai gerar um SQL semelhante a este:

   SELECT *
   FROM Singers
   WHERE Singers.BirthDate
   BETWEEN '1970-01-01' AND '1979-12-31'
   

   Observação: o Gemini pode sugerir uma sintaxe diferente sempre que você inserir o mesmo comando.

8. Revise a sugestão do SQL e realize uma das seguintes ações:

   Atenção: como as consultas de linguagem de manipulação de dados (DML) e linguagem de definição de dados (DDL) geradas pelo Gemini podem substituir dados, recomendamos que você valide as consultas SQL geradas antes de executá-las.
   • Para ver as opções de aceitação do SQL gerado pelo Gemini, mantenha o ponteiro sobre a consulta. As seguintes opções são exibidas:
     • Aceitar: para aceitar a consulta sugerida, pressione Tab e clique em Executar.
     • Aceitar palavra: para aceitar a consulta sugerida parcialmente, pressione Control+Right arrow (ou Command+Right arrow no macOS). Em seguida, clique em Executar.
   • Para editar o SQL original, pressione Tab, edite o SQL e clique em Executar.
   • Para dispensar a sugestão, pressione Esc ou continue digitando.

Ferramenta "Preciso de ajuda com o código"

Para usar a ferramenta Me ajude a codificar, siga estas etapas:

1. No console do Google Cloud , abra a página AlloyDB.

   Acessar o AlloyDB

2. Selecione um cluster na lista.

3. No menu de navegação, clique em AlloyDB.

4. Selecione um banco de dados e um usuário e digite a senha dele.

5. Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no seu banco de dados.

6. Para consultar seu banco de dados, clique na Nova guia.

7. Clique em pen_spark Me ajude a codificar ao lado do editor de consultas.

8. Na ferramenta Preciso de ajuda com o código, digite um comando. Por exemplo, add a row to table singers e clique em Gerar.

   O Gemini gera um SQL semelhante a este:

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   Observação: o Gemini pode sugerir uma sintaxe diferente sempre que você inserir o mesmo comando.

9. Analise o SQL gerado e realize uma das seguintes ações:

   Atenção: como as consultas de linguagem de manipulação de dados (DML) e linguagem de definição de dados (DDL) geradas pelo Gemini podem substituir dados, recomendamos que você valide as consultas geradas antes de executá-las.
   • Para aceitar o SQL gerado pelo Gemini, clique em Inserir para inserir a instrução no editor de consultas. Em seguida, clique em Executar para executar o SQL sugerido.
   • Para pedir que o Gemini gere uma nova consulta, clique em Editar. Depois de editar seu comando, clique em Atualizar. Você pode aceitar a nova instrução gerada ou dispensar a sugestão.
   • Para dispensar a sugestão, feche a janela Me ajude a codificar.

Explicar instruções SQL no editor de consultas

Você pode inserir consultas em linguagem natural para pedir explicações sobre consultas SQL. Essas explicações podem ajudar você a entender a sintaxe, o esquema subjacente e o contexto comercial de consultas complexas ou longas.

1. No console do Google Cloud , abra a página AlloyDB.

   Acessar o AlloyDB

2. Selecione um cluster na lista.

3. No menu de navegação, clique em AlloyDB.

4. Selecione um banco de dados e um usuário e digite a senha dele.

5. Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no seu banco de dados.

6. Para consultar seu banco de dados, clique na Nova guia.

7. No editor de consultas, cole a consulta.

8. Destaque a consulta que você quer que o Gemini explique e clique em pen_spark Explicar esta consulta.

   A explicação do SQL aparece na janela Chat do Gemini.

Usar o Gemini para corrigir erros em consultas

Pré-lançamento — Gemini Code Assist

Este recurso está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. É possível tratar dados pessoais para esse recurso conforme descrito no Aditivo sobre Tratamento de Dados do Cloud, sujeito às obrigações e restrições descritas no contrato que rege o acesso ao Google Cloud. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

O Gemini oferece um recurso avançado que ajuda você a corrigir erros nas consultas do AlloyDB sem sair do editor de consultas.

Os recursos do Gemini com tecnologia de IA estão integrados ao editor de consultas para oferecer os seguintes benefícios:

• Fornece uma comparação linha a linha da consulta original ao lado de uma nova consulta com mudanças recomendadas usando o editor de consultas.
• Destaca segmentos da consulta original que podem estar causando o problema e fornece um resumo das mudanças em linguagem natural.
• Faz referência à mensagem de erro exata e às informações de esquema associadas à consulta para fornecer correções precisas e relevantes.
• Elimina a necessidade de usar LLMs de terceiros e de uso geral que podem fornecer ajuda menos detalhada e expor seus dados a possíveis riscos de segurança.
• Oferece uma solução de problemas mais rápida e eficiente para problemas comuns, como erros de sintaxe, esquema e ambiente de execução.

Permissões necessárias

Antes de começar, confirme se você tem as seguintes permissões:

• As permissões descritas em Permissões necessárias.
• A permissão da API Gemini para Google Cloud, cloudaicompanion.googleapis.com/instances.generateCode.

Corrigir sua consulta usando o Gemini

Para usar os recursos do Gemini e corrigir determinados erros em uma consulta, faça o seguinte:

1. No console do Google Cloud , abra a página AlloyDB para PostgreSQL.

   Acessar o AlloyDB

2. Selecione um cluster na lista.

3. No menu de navegação, clique em AlloyDB Studio.

4. Selecione um banco de dados e um usuário e digite a senha dele.

5. Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no seu banco de dados.

6. Na barra de tarefas, clique em pen_sparkGemini para ver os recursos do Gemini no AlloyDB.

7. Para consultar seu banco de dados, clique em Nova guia.

8. No editor de consultas, insira uma consulta que possa estar incorreta ou incompleta.

9. Clique em Executar.

   Se a consulta tiver um problema, um erro será retornado na guia Resultados.

10. Clique em Corrigir.

    Na janela de consulta, um editor de diferenças ("editor de diff") é aberto na guia, mostrando uma comparação linha por linha da consulta atual com as mudanças recomendadas. O editor de consultas também oferece um resumo das edições sugeridas.

11. Revise as mudanças sugeridas na consulta e atualize conforme necessário.

12. Para aceitar as mudanças e executar a nova consulta, clique em Aceitar e executar.

Limitações

• Esse recurso só está acessível no editor de consultas do AlloyDB Studio no consoleGoogle Cloud .
• Os limites atuais da janela de contexto do Gemini se aplicam.

A seguir

• Leia Visão geral do Gemini para Google Cloud .
• Saiba como o Gemini usa seus dados.
• Saiba como analisar seus dados no Google Cloud usando o Gemini.