Escreva SQL com a ajuda do Gemini

Este documento descreve como pode usar o Gemini Code Assist para receber assistência baseada em IA com o seguinte no Spanner:

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 Spanner, o SQL e a análise de dados. Se não conhece o Spanner, consulte o artigo Criar e consultar uma base de dados através da Google Cloud consola.

Antes de começar

  1. Opcional: configure o Gemini Code Assist.

  2. Para concluir as tarefas neste documento, certifique-se de que tem as autorizações de gestão de identidade e acesso (IAM) necessárias.

  3. Na Google Cloud consola, aceda à página Spanner.

    Aceda ao Spanner

  4. Selecione uma instância na lista.

  5. Selecione uma base de dados.

  6. No menu de navegação, clique em Spanner Studio.

  7. Na barra de tarefas, clique em pen_spark Gemini para ver as funcionalidades do Gemini no Spanner.

  8. Selecione as funcionalidades do Gemini que quer ativar, por exemplo, a geração de comentários para consultas. Pode selecionar e experimentar funcionalidades sem afetar outras pessoas que trabalham no seu projeto.

  9. Opcional: se quiser seguir os exemplos neste documento, comece por criar a tabela Singers, conforme descrito em Crie um esquema para a sua base de dados.

Para desativar as funcionalidades do Gemini no Spanner, repita estes passos e, em seguida, desmarque as funcionalidades do Gemini que quer desativar.

Funçõ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 utilizador do Gemini para Google Cloud (roles/cloudaicompanion.user) 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.

Gere consultas SQL com comandos de linguagem natural

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

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

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

    Aceda ao Spanner

  2. Selecione uma instância na lista.

  3. Selecione uma base de dados.

  4. No painel de navegação, clique em Spanner Studio. 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 do editor de SQL. Certifique-se de que a geração de SQL está ativada.

  6. Para gerar SQL, escreva um comentário no editor de consultas a começar com -- 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 Return, 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'

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

    • Para aceitar o SQL gerado pelo Gemini, prima Tab e, de seguida, clique em Executar para executar o SQL sugerido.
    • Para editar o SQL gerado pelo Gemini, prima Tab, edite o SQL e, de seguida, clique em Executar.
    • Para ignorar a sugestão, prima Esc ou continue a escrever.

Explicar declarações SQL no editor de consultas

Pode usar o Gemini no Spanner 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 Spanner.

    Aceda ao Spanner

  2. Selecione uma instância na lista.

  3. Selecione uma base de dados.

  4. No painel de navegação, clique em Spanner Studio.

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

  6. No editor de consultas, cole a consulta.

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

    A explicação de SQL aparece no painel do Gemini.

O que se segue?