Escreva SQL com a assistência do Gemini

Visualização — Gemini in Spanner

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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

• Gerar consultas SQL usando comandos de linguagem natural.
• Concluir instruções SQL no editor de consultas.
• 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 Spanner, o SQL e a análise de dados. Se você é novo no Spanner, consulte Criar e consultar um banco de dados usando o console do Google Cloud .

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

Antes de começar

1. Opcional: configurar 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 do 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. Na barra de tarefas, clique em pen_spark Gemini para conferir os recursos do Gemini no Spanner.

8. Selecione os recursos do Gemini que você quer ativar, como preenchimento de SQL e geração de comentários para consultas. 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, crie primeiro a tabela Singers conforme descrito em Criar um esquema para seu banco de dados.

Para desativar os recursos do Gemini no Spanner, repita estas 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 o papel do IAM de Gemini para Google Cloud Usuário (roles/cloudaicompanion.user) 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 por meio de papéis personalizados ou de outros papéis predefinidos.

Gerar consultas SQL usando comandos de linguagem natural

Como uma tecnologia em estágio inicial, os produtos do Gemini para Google Cloud podem gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide todos os resultados do Gemini para produtos do Google Cloud antes de usá-los. 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?"

Observação: quando você insere um comando para o Gemini no Spanner, as informações sobre o esquema do banco de dados são incluídas no comando. 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 Spanner e não são enviados para o Gemini.

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

1. No console do 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 em nova guia do editor de SQL. 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ê digitar o comando -- show all singers born in the 70s, o Gemini vai gerar um SQL semelhante ao seguinte:

   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.

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 executar 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.

Concluir instruções SQL no editor de consultas

Para ajudar você a escrever código SQL, o Gemini no Spanner oferece sugestões de preenchimento de código assistido por IA. Com o Gemini ativado, quando você insere texto no editor de consultas do Spanner Studio, o Gemini prevê e preenche automaticamente o código SQL.

Sugestões de código inline

Para usar sugestões de código inline, siga estas etapas:

1. No console do 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 o banco de dados, clique em Nova guia do editor SQL. Verifique se a conclusão do SQL está ativada.

6. Digite uma consulta e um espaço ou uma nova linha no final da linha. Ao inserir o texto, o Gemini mostra o SQL sugerido com base nos objetos compatíveis no esquema do banco de dados selecionado.

   Por exemplo, para adicionar uma linha à tabela Singers, comece a escrever o seguinte SQL: INSERT INTO Singers.

   Gemini sugere um SQL semelhante ao seguinte:

   INSERT INTO Singers
   (SingerId, FirstName, LastName, BirthDate)
   VALUES
     (1, 'Marc', 'Singer', '1970-03-24')
   

   Observação: o Gemini pode sugerir uma sintaxe SQL diferente sempre que você insere a mesma instrução SQL.

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

   • Para aceitar o SQL gerado pelo Gemini, pressione Tab e clique em Executar para executar 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.

Ferramenta "Preciso de ajuda com o código"

Para usar a ferramenta Quero ajuda para codificar, siga estas etapas:

1. No console do 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. Clique em pen_spark Quero ajuda para codificar ao lado do editor de consultas.

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

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

   • 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 Quero ajuda para codificar.

Explicar instruções SQL no editor de consultas

Use o Gemini no Spanner para explicar consultas SQL em 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 do 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 pen_spark Explicar esta consulta.

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

A seguir

• Leia as Informações gerais do Gemini para Google Cloud .
• Saiba como o Gemini usa seus dados.