Escreva SQL com a assistência do Gemini

MySQL   |  PostgreSQL   |  SQL Server

Visualização — Gemini Code Assist

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. É possível processar dados pessoais para esse recurso conforme descrito no Adendo sobre processamento de dados do Cloud, sujeito às obrigações e restrições descritas no contrato em que você acessa o Google Cloud. 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.

Como uma tecnologia em estágio inicial, o Gemini pode gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide toda a saída do Genmini antes de usá-la. Para mais informações, consulte Gemini no Google Cloud e IA responsável.

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 Cloud SQL Studio:

• Gerar consultas SQL usando comandos de linguagem natural
• Concluir instruções SQL no editor de consultas
• Explicar consultas SQL no editor de consultas

O Gemini não usa seus comandos nem as respostas deles como dados para treinar os modelos. Para mais informações, consulte Como o Gemini para o Google Cloud usa seus dados.

Este documento é destinado a administradores de banco de dados e engenheiros de dados familiarizados com SQL, análise de dados e o Cloud SQL. Se você começou a usar o Cloud SQL agora, consulte Visão geral do Cloud SQL.

Antes de começar

1. Verifique se você configurou o Gemini em bancos de dados.
2. Para concluir as tarefas neste documento, verifique se você tem as permissões necessárias do Identity and Access Management (IAM).
3. Confirme o acesso ao Cloud SQL Studio. Se você não tiver acesso ao Cloud SQL Studio, consulte Papéis e permissões necessários do Cloud SQL Studio.

4. Opcional: para acompanhar os exemplos neste documento, crie uma tabela Singers usando o esquema a seguir:

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

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

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 em bancos de dados. Recomendamos usar uma conta com menos privilégios de banco de dados ao usar o Gemini em bancos de dados.

Para receber as permissões necessárias para concluir as tarefas neste documento, solicite ao administrador o papel Cloud SQL Admin (roles/cloudsql.admin) do IAM no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

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

Você também precisa da permissão cloudaicompanion.companions.generateChat para usar explicar as instruções SQL no editor de consultas e cloudaicompanion.companions.generateCode para usar Preciso de ajuda com o código.

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

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 para o Gemini no Cloud SQL, as informações sobre o esquema do banco de dados são incluídas no comando. Esse metadados pode incluir nomes de tabelas e colunas, tipos de dados e descrições de colunas. Os dados do banco de dados permanecem no Cloud SQL e não são enviados para o Gemini.

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

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

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

4. Faça login no Cloud SQL Studio usando o nome do seu banco de dados, nome de usuário e senha. O painel Explorer mostra uma lista de objetos no seu banco de dados.

5. Na barra de tarefas, clique em pen_sparkGemini para ver os recursos do Gemini no Cloud SQL.

6. Verifique se a Geração de comentários para consulta está ativada.

7. Para consultar o banco de dados, clique em Nova guia do editor SQL.

8. 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 ou Enter.

   Por exemplo, insira o seguinte comando:

   -- add a row to table singers
   

   Pressione Return ou Enter. Gemini gera 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, digite o seguinte comando:

   -- show all singers born in the 70s
   

   Gemini gera 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 consultas diferentes sempre que você insere o mesmo comando.

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

   • 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 Quero ajuda para codificar, siga estas etapas:

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

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

4. Faça login no Cloud SQL Studio usando o nome do seu banco de dados, nome de usuário e senha. O painel Explorer mostra uma lista de objetos no seu banco de dados.

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

Concluir instruções SQL no editor de consultas

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

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

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

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

4. Faça login no Cloud SQL Studio usando o nome do seu banco de dados, nome de usuário e senha. O painel Explorer mostra uma lista de objetos no seu banco de dados.

5. Na barra de tarefas, clique em pen_sparkGemini para ver os recursos do Gemini no Cloud SQL.

6. Selecione Conclusão do SQL.

7. Para consultar seu banco de dados, clique em nova guia do editor de SQL.

8. 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 a seguinte consulta:

   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 consultas diferentes cada vez que você insere a mesma instrução.

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

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

Explicar instruções SQL no editor de consultas

Use o Gemini no Cloud SQL 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 do Google Cloud, acesse a página Cloud SQL.

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

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

4. Faça login no Cloud SQL Studio usando o nome do seu banco de dados, nome de usuário e senha. O painel Explorer mostra uma lista de objetos no seu banco de dados.

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

6. No editor de consultas, cole a consulta que você quer explicar.

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

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

A seguir

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