Escreva SQL com a assistência do Gemini

Neste documento, descrevemos como usar o Gemini Code Assist para receber assistência com tecnologia de IA com o seguinte no Spanner:

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 Spanner, o SQL e a análise de dados. Se você não conhece o Spanner, consulte Criar e consultar um banco de dados usando o console Google Cloud .

Antes de começar

  1. Opcional: configure o Gemini Code Assist.

  2. Para concluir as tarefas neste documento, verifique se você tem as permissões necessárias do Identity and Access Management (IAM).

  3. No console Google Cloud , acesse a página Spanner.

    Acessar o Spanner

  4. Selecione uma instância na lista.

  5. Selecione um banco de dados.

  6. No menu de navegação, clique em Spanner Studio.

  7. No Spanner Studio, clique no botão settings_suggestion Gemini Code Assist para conferir os recursos do Gemini no Spanner.

  8. Selecione os recursos do Gemini que você quer ativar, por exemplo, Geração de comentários para consulta. Você pode selecionar e testar recursos sem afetar outras pessoas que trabalham no seu projeto.

  9. Opcional: se você quiser acompanhar os exemplos neste documento, primeiro crie a tabela Singers conforme descrito em Criar um esquema para seu banco de dados.

Para desativar os recursos do Gemini no Spanner, repita essas etapas e desmarque os recursos que você quer desativar.

Funções exigidas

Para receber as permissões necessárias para concluir as tarefas neste documento, peça ao administrador para conceder a você o papel Usuário do Gemini para Google Cloud (roles/cloudaicompanion.user) do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Gerar consultas SQL usando comandos de linguagem natural

É 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?"

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

  1. No console Google Cloud , acesse a página Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista.

  3. Selecione um banco de dados.

  4. No painel de navegação, clique em Spanner Studio. O painel Explorer mostra uma lista de objetos no seu banco de dados.

  5. Para consultar seu banco de dados, clique na Nova guia. Verifique se a geração de SQL está ativada.

  6. 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'

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

    • Para aceitar o SQL gerado pelo Gemini, pressione Tab e clique em Executar para iniciar o SQL sugerido.
    • Para editar o SQL gerado pelo Gemini, pressione Tab, edite o SQL e clique em Executar.
    • Para dispensar a sugestão, pressione Esc ou continue digitando.

Explicar instruções SQL no editor de consultas

Use o Gemini no Spanner para explicar consultas SQL com linguagem natural. Essa explicação pode ajudar você a entender a sintaxe, o esquema subjacente e o contexto comercial de consultas complexas ou longas.

  1. No console Google Cloud , acesse a página Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista.

  3. Selecione um banco de dados.

  4. No painel de navegação, clique em Spanner Studio.

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

  6. No editor de consultas, cole a consulta.

  7. Destaque a consulta que você quer que o Gemini explique e clique em astrophotography_mode Explicar esta consulta selecionada.

    A explicação do SQL aparece no painel do Gemini Cloud Assist.

Usar o Gemini para corrigir erros em consultas

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

Os recursos do Gemini com tecnologia de IA estão integrados ao Spanner Studio 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 refinada e expor seus dados a possíveis riscos de segurança.
  • Oferece uma solução de problemas mais rápida e eficiente para questões 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:

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 editor de consultas, execute sua consulta.

    Se a consulta tiver um erro, uma mensagem vai aparecer em um banner na parte de baixo do editor.

  2. 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 fornece um resumo das edições sugeridas.

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

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

Limitações

A seguir