Escreva SQL com a ajuda do Gemini

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

Saiba como e quando o Gemini para Trusted 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.

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 MEDIUMBLOB,
  BirthDate  DATETIME
);

    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

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.

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

  1. Na Trusted 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'

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

    • 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 Trusted 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');

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

    • 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 Trusted 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.

Use o Gemini para corrigir erros em consultas

O Gemini oferece agora uma capacidade alargada que ajuda a corrigir erros nas suas consultas do Cloud SQL sem ter de sair do Cloud SQL Studio.

As capacidades com tecnologia de IA do Gemini estão integradas no Cloud SQL Studio 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 do Cloud SQL Studio.
  • 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:

Corrija a sua consulta com o Gemini e o Cloud SQL Studio

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

  1. Na Trusted 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. Para consultar a sua base de dados, clique no novo separador.

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

  8. Clique em Executar.

    Se a consulta contiver um problema, é devolvido um erro.

    Por exemplo, a mensagem devolvida pode ser um erro de validação no separador Executar ou uma mensagem de erro no separador Resultados.

  9. Clique em Corrigir.

  10. 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. Reveja as alterações sugeridas à consulta e atualize-as conforme necessário. Em seguida, aceite e execute a nova consulta:

    Clique em Aceitar e executar.

Limitações

O que se segue?