Escreva SQL com a ajuda do Gemini

Pré-visualizar

Este produto está abrangido pelos Termos das Ofertas Pré-GA dos Google Cloud Termos de Utilização. Os produtos de pré-DG podem ter apoio técnico limitado e as alterações aos produtos de pré-DG podem não ser compatíveis com outras versões de pré-DG. 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 AlloyDB para PostgreSQL:

• 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 os seus dados.

Este documento destina-se a administradores de bases de dados e engenheiros de dados que estão familiarizados com o AlloyDB e têm algum conhecimento de SQL e análise de dados. Se não tem experiência com o AlloyDB, consulte a vista geral do AlloyDB.

Nota: a assistência de programaçã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. 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 AlloyDB for PostgreSQL Studio.

Antes de começar

1. Certifique-se de que o Gemini Cloud Assist está configurado para a sua Google Cloud conta de utilizador e projeto.

2. Opcional: se quiser seguir os exemplos neste documento, crie a tabela Singers com o seguinte esquema:

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

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

Para desativar as funcionalidades do Gemini no AlloyDB, repita este passo e, em seguida, desmarque as funcionalidades do Gemini que quer desativar.

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

Atenção: os utilizadores com acesso amplo à base de dados podem sofrer perda de dados quando usam o Gemini. Recomendamos que use uma conta com menos privilégios da base de dados quando usar o Gemini.

Para usar o Gemini com o AlloyDB, precisa das seguintes autorizações:

• alloydb.clusters.get
• alloydb.databases.list
• alloydb.instances.executeSql
• alloydb.instances.list
• alloydb.users.list
• cloudaicompanion.companions.generateCode
• cloudaicompanion.instances.generateCode
• serviceusage.services.get ou serviceusage.services.list

Pode receber esta autorização através da função roles/alloydb.admin. Se não tiver esta função, contacte o administrador organizacional para pedir acesso. Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Além disso, certifique-se de que tem autorizações ao nível da base de dados para a base de dados que está a usar para autenticação.

Gere consultas SQL com comandos de linguagem natural

Como tecnologia em fase inicial, o Gemini para Google Cloud produtos 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, tem de clicar em atualizarAtualizar para atualizar o esquema antes de usar o Gemini.

Nota: quando introduz um comando, as informações sobre o esquema da sua base de dados são incluídas no comando. Isto pode incluir nomes de tabelas e colunas, tipos de dados e descrições de colunas. O esquema e os dados da sua base de dados permanecem no AlloyDB e não são enviados para o Gemini.

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

1. Na Google Cloud consola, abra a página AlloyDB.

   Aceder ao AlloyDB

2. Selecione um cluster na lista.

3. No menu de navegação, clique em AlloyDB.

4. Selecione uma base de dados e um utilizador e introduza a palavra-passe do utilizador.

5. Clique em Autenticar. O painel Explorador apresenta uma lista dos objetos na sua base de dados.

6. Para consultar a sua base de dados, clique no novo separador do editor de SQL. Certifique-se de que a geração de SQL está ativada.

7. Para gerar SQL, escreva um comentário no editor de consultas a começar por -- seguido de um comentário de uma linha e, de seguida, prima Return.

   Por exemplo, se introduzir o comando -- add a row to table singers e premir 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, se introduzir o 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 uma sintaxe diferente cada vez que introduz o mesmo comando.

8. 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 SQL 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, abra a página AlloyDB.

   Aceder ao AlloyDB

2. Selecione um cluster na lista.

3. No menu de navegação, clique em AlloyDB.

4. Selecione uma base de dados e um utilizador e introduza a palavra-passe do utilizador.

5. Clique em Autenticar. O painel Explorador apresenta uma lista dos objetos na sua base de dados.

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

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

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

9. 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 introduzir consultas de linguagem natural para pedir explicações de consultas SQL. Estas explicações podem ajudar a compreender a sintaxe, o esquema subjacente e o contexto empresarial de consultas complexas ou longas.

1. Na Google Cloud consola, abra a página AlloyDB.

   Aceder ao AlloyDB

2. Selecione um cluster na lista.

3. No menu de navegação, clique em AlloyDB.

4. Selecione uma base de dados e um utilizador e introduza a palavra-passe do utilizador.

5. Clique em Autenticar. O painel Explorador apresenta uma lista dos objetos na sua base de dados.

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

7. No editor de consultas, cole a consulta.

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

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

Use o Gemini para corrigir erros em consultas

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, sujeita à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.

O Gemini oferece uma capacidade alargada que ajuda a corrigir erros nas suas consultas do AlloyDB sem ter de sair do editor de consultas.

As capacidades com tecnologia de IA do Gemini estão integradas no editor de consultas para oferecer as seguintes vantagens:

• Oferece uma comparação linha a linha da consulta original junto a uma nova consulta com alterações recomendadas através do editor de consultas.
• Realça os segmentos da consulta original que podem estar a causar o problema e fornece um resumo das alterações em linguagem natural.
• Faz referência à mensagem de erro exata e às informações do esquema associadas à consulta para fornecer correções precisas e relevantes.
• Elimina a necessidade de depender de MDIs gerais de terceiros que podem fornecer ajuda menos detalhada e também podem expor os seus dados a potenciais riscos de segurança.
• Oferece uma resolução de problemas mais rápida e eficiente para problemas comuns, como erros de sintaxe, esquema e tempo de execução.

Autorizações necessárias

Antes de começar, confirme que tem as seguintes autorizações:

• As autorizações descritas em Autorizações necessárias.
• A autorização da API Gemini for Google Cloud, cloudaicompanion.googleapis.com/instances.generateCode.

Corrija a sua consulta com o Gemini

Para usar as capacidades do Gemini para corrigir determinados erros numa consulta, conclua o seguinte:

1. Na Google Cloud consola, abra a página AlloyDB para PostgreSQL.

   Aceder ao AlloyDB

2. Selecione um cluster na lista.

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

4. Selecione uma base de dados e um utilizador e introduza a palavra-passe do utilizador.

5. Clique em Autenticar. O painel Explorador apresenta uma lista dos objetos na sua base de dados.

6. Na barra de tarefas, clique em pen_sparkGemini para ver as funcionalidades do Gemini no AlloyDB.

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

8. No editor de consultas, introduza uma consulta que possa estar incorreta ou incompleta.

9. Clique em Executar.

   Se a consulta contiver um problema, é devolvido um erro no separador Resultados.

10. Clique em Corrigir.

    Na janela de consulta, é aberto um editor de diferenças ("editor de diff") no separador, que mostra uma comparação linha a linha da consulta existente com as alterações recomendadas. O editor de consultas também apresenta um resumo das edições sugeridas.

11. Reveja as alterações sugeridas à consulta e atualize-as conforme necessário.

12. Para aceitar as alterações e executar a nova consulta, clique em Aceitar e executar.

Limitações

• Esta capacidade só está acessível no editor de consultas do AlloyDB Studio na Google Cloud consola.
• Aplicam-se os limites atuais da capacidade de resposta 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.