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 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 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 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 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 de 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 obter 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 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, 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.

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.