Escreva SQL com a assistência do Gemini

MySQL   |  PostgreSQL   |  SQL Server

Prévia — Gemini Code Assist

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Você pode gerenciar dados pessoais para este recurso conforme descrito no Aditivo sobre Tratamento de Dados do Cloud, sujeito às obrigações e restrições descritas no contrato que rege seu acesso ao 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 das fases de lançamento.

Neste documento, descrevemos como usar 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
• 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 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.

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

Antes de começar

1. Para concluir as tarefas neste documento, verifique se você tem as permissões necessárias do Identity and Access Management (IAM).
2. 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.

3. 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 VARBINARY(MAX),
     BirthDate  DATETIMEOFFSET
   );
   

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

Papéis e permissões necessárias

Para receber as permissões necessárias para concluir as tarefas neste documento, solicite ao administrador que conceda a você o papel Cloud SQL Admin (roles/cloudsql.admin) 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 personalizados papéis ou outros predefinidos papéis.

Você também precisa das seguintes permissões:

• Permissões serviceusage.services.list ou serviceusage.services.get para recursos de leitura
• Permissão cloudaicompanion.companions.generateChat para usar instruções SQL no editor de consultas
• Permissão cloudaicompanion.companions.generateCode para usar Me ajude com o código

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

• "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 Google Cloud console, 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 settings_suggestionGemini 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:

   **Cuidado** :como as consultas de linguagem de manipulação de dados (DML) e de 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 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 com o código, siga estas etapas:

1. No Google Cloud console, 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 settings_suggestion Me ajude com o código ao lado do editor de consultas.

7. Na janela Me ajude 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:

   **Cuidado** :como as consultas de linguagem de manipulação de dados (DML) e de 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 com o código.

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 Google Cloud console, 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 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

Prévia — Gemini Code Assist

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Você pode gerenciar dados pessoais para este recurso conforme descrito no Aditivo sobre Tratamento de Dados do Cloud, sujeito às obrigações e restrições descritas no contrato que rege seu acesso ao 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 das fases de lançamento.

O Gemini agora oferece um recurso estendido que ajuda a corrigir erros nas consultas do Cloud SQL sem precisar sair do Cloud SQL Studio.

Os recursos com tecnologia de IA do Gemini são integrados ao Cloud SQL Studio para oferecer os seguintes benefícios:

• Fornece uma comparação linha por linha da consulta original ao lado de uma nova consulta com mudanças recomendadas usando o editor do Cloud SQL Studio.
• Destaca segmentos da consulta original que podem estar causando o problema e fornece um resumo das mudanças em linguagem natural.
• Referencia a mensagem de erro exata e as informações de esquema associadas à consulta para fornecer correções precisas e relevantes.
• Elimina a necessidade de usar LLMs de uso geral de terceiros que podem fornecer ajuda menos detalhada e também expor seus dados a possíveis riscos de segurança
• Fornece solução de problemas mais rápida e eficiente para problemas comuns, como erros de sintaxe, esquema e 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 a consulta usando o Gemini e o Cloud SQL Studio

Para usar os recursos do Gemini para corrigir determinados erros em uma consulta no Cloud SQL Studio, faça o seguinte:

1. No Google Cloud console, 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 settings_suggestionGemini para ver os recursos do Gemini no Cloud SQL.

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

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

8. Clique em Executar.

   Se a consulta contiver um problema, um erro será retornado.

   Por exemplo, a mensagem retornada pode ser um erro de validação na guia Executar ou uma mensagem de erro na guia Resultados.

9. Clique em Corrigir.

10. 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. Revise as mudanças sugeridas na consulta e atualize conforme necessário. Em seguida, aceite e execute a nova consulta:

    Clique em Aceitar e executar.

Limitações

• Esse recurso só pode ser acessado no Cloud SQL Studio no Google Cloud console.
• Os limites atuais da janela de contexto do Gemini se aplicam.

A seguir

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