Escreva SQL com a ajuda do Gemini

MySQL   |  PostgreSQL   |  SQL Server

Pré-visualização — Gemini Code Assist

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Pode tratar dados pessoais para esta funcionalidade conforme descrito na Alteração ao Tratamento de Dados do Cloud, sujeito às obrigações e restrições descritas no contrato ao abrigo do qual acede ao Google Cloud. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Este documento descreve como pode usar o Gemini, um colaborador com tecnologia de IA no Google Cloud, para ajudar a fazer o seguinte no Cloud SQL Studio:

• Gere consultas SQL com comandos de linguagem natural
• Explicar consultas SQL no editor de consultas

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

Este documento destina-se a administradores de bases de dados e engenheiros de dados que estão familiarizados com SQL, análise de dados e Cloud SQL. Se não conhece o Cloud SQL, consulte a vista geral do Cloud SQL.

Nota: a assistência na programação faz parte do Gemini Code Assist e está disponível sem custo financeiro até ser incluída na edição Standard do Gemini Code Assist. Esta alteração vai ser comunicada numa data posterior. Nessa altura, tem de adquirir uma licença do Gemini Code Assist Standard edition para continuar a usar a assistência de programação no Cloud SQL Studio.

Antes de começar

1. Para concluir as tarefas neste documento, certifique-se de que tem as autorizações de gestão de identidade e acesso (IAM) necessárias.
2. Confirme o acesso ao Cloud SQL Studio. Se não tiver acesso ao Cloud SQL Studio, consulte os papéis e as autorizações necessários do Cloud SQL Studio

3. Opcional: para acompanhar os exemplos neste documento, crie uma tabela Singers com o seguinte esquema:

   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 da base de dados.

Funções e autorizações necessárias

Para receber as autorizações de que precisa para concluir as tarefas neste documento, peça ao seu administrador para lhe conceder a função de IAM de administrador do Cloud SQL (roles/cloudsql.admin) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Também precisa da autorização cloudaicompanion.companions.generateChat para usar a opção Explicar declarações SQL no editor de consultas e cloudaicompanion.companions.generateCode para usar a opção Ajuda-me a programar.

Gere consultas SQL com comandos de linguagem natural

Como tecnologia em fase inicial, o Gemini para produtos Google Cloud pode gerar resultados que parecem plausíveis, mas que estão factualmente incorretos. Recomendamos que valide todas as saídas do Gemini para Google Cloud produtos antes de as usar. Para mais informações, consulte o artigo Gemini para Google Cloud e IA responsável.

Pode dar ao Gemini comentários em linguagem natural (ou comandos) para gerar consultas baseadas no seu esquema. Por exemplo, pode pedir ao Gemini para gerar SQL em resposta aos seguintes comandos:

• "Cria uma tabela que monitorize os resultados do inquérito de satisfação do cliente."
• "Adiciona uma coluna de data denominada aniversário à tabela Singers."
• "Quantos cantores nasceram nos anos 90?"

Se o seu esquema for alterado, por exemplo, com a adição de uma nova tabela ou coluna, clique em atualizarAtualizar para atualizar o esquema antes de usar o Gemini.

Nota: quando introduz um comando para o Gemini no Cloud SQL, as informações sobre o esquema da sua base de dados são incluídas no comando. Estes metadados podem incluir nomes de tabelas e colunas, tipos de dados e descrições de colunas. Os dados da sua base de dados permanecem no Cloud SQL e não são enviados para o Gemini.

Para gerar SQL no Cloud SQL com a ajuda do Gemini, siga estes passos:

1. Na Google Cloud consola, aceda à página Cloud SQL.

   Aceder ao Cloud SQL

2. Selecione uma instância na lista.

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

4. Inicie sessão no Cloud SQL Studio com o nome da base de dados, o nome de utilizador e a palavra-passe. O painel Explorador apresenta uma lista de objetos na sua base de dados.

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

6. Certifique-se de que a geração de comandos a partir de comentários está ativada.

7. Para consultar a sua base de dados, clique em Novo separador do editor de SQL.

8. Para gerar SQL, escreva um comentário no editor de consultas a começar por -- seguido de um comentário de linha única e, de seguida, prima Return ou Enter.

   Por exemplo, introduza o seguinte comando:

   -- add a row to table singers
   

   Prima Return ou Enter. O Gemini gera SQL semelhante ao seguinte:

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

   Para continuar o exemplo com a tabela Singers, introduza o seguinte comando:

   -- show all singers born in the 70s
   

   O Gemini gera SQL semelhante ao seguinte:

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

   Nota: o Gemini pode sugerir consultas diferentes sempre que introduzir o mesmo comando.

9. Reveja a sugestão de SQL e tome uma das seguintes medidas:

   Aviso: uma vez que 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 valide as consultas geradas antes de as executar.
   • Para ver as opções de aceitação do SQL gerado pelo Gemini, mantenha o ponteiro sobre a consulta. São apresentadas as seguintes opções:
     • Aceitar: para aceitar a consulta sugerida, prima Tab e, de seguida, clique em Executar.
     • Aceitar palavra: para aceitar parcialmente a consulta sugerida, prima Control+Right arrow (ou Command+Right arrow no macOS) e, de seguida, clique em Executar.
   • Para editar o SQL original, prima Tab, edite o SQL e, em seguida, clique em Executar.
   • Para ignorar a sugestão, prima Esc ou continue a escrever.

Ferramenta Ajuda-me a programar

Para usar a ferramenta Ajuda-me a programar, siga estes passos:

1. Na Google Cloud consola, aceda à página Cloud SQL.

   Aceder ao Cloud SQL

2. Selecione uma instância na lista.

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

4. Inicie sessão no Cloud SQL Studio com o nome da base de dados, o nome de utilizador e a palavra-passe. O painel Explorador apresenta uma lista de objetos na sua base de dados.

5. Para consultar a sua base de dados, clique no novo separador.

6. Clique em pen_spark Ajuda-me a programar junto ao editor de consultas.

7. Na janela Ajuda-me a programar, introduza um comando. Por exemplo, add a row to table singers e clique em Gerar.

   O Gemini gera SQL semelhante ao seguinte:

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

   Nota: o Gemini pode sugerir uma sintaxe diferente cada vez que introduz o mesmo comando.

8. Reveja o SQL gerado e tome uma das seguintes medidas:

   Aviso: uma vez que 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 valide as consultas geradas antes de as executar.
   • Para aceitar o SQL gerado pelo Gemini, clique em Inserir para inserir a declaração no editor de consultas. Em seguida, clique em Executar para executar o SQL sugerido.
   • Para pedir ao Gemini para gerar uma nova consulta, clique em Editar. Depois de editar o comando, clique em Atualizar. Em seguida, pode decidir aceitar a nova declaração gerada ou ignorar a sugestão.
   • Para ignorar a sugestão, feche a janela Ajuda-me a programar.

Explicar declarações SQL no editor de consultas

Pode usar o Gemini no Cloud SQL para explicar consultas SQL em linguagem natural. Esta explicação pode ajudar a compreender a sintaxe, o esquema subjacente e o contexto empresarial de consultas complexas ou longas.

1. Na Google Cloud consola, aceda à página Cloud SQL.

   Aceder ao Cloud SQL

2. Selecione uma instância na lista.

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

4. Inicie sessão no Cloud SQL Studio com o nome da base de dados, o nome de utilizador e a palavra-passe. O painel Explorador apresenta uma lista de objetos na sua base de dados.

5. Para consultar a sua base de dados, clique no novo separador.

6. No editor de consultas, cole a consulta que quer que seja explicada.

7. Realce a consulta que quer que o Gemini explique e, em seguida, clique em spark Explicar esta consulta.

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

O que se segue?

• Leia a vista geral do Gemini para Google Cloud .
• Saiba como o Gemini usa os seus dados.
• Saiba como analisar os seus dados no Google Cloud com o Gemini.