Escreva SQL com a assist�ncia do Gemini

Neste documento, descrevemos como usar Gemini em bancos de dados para utilizar a tecnologia de IA assistência com os seguintes itens no Spanner:

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

Este documento é destinado a administradores de banco de dados e engenheiros de dados que conhecem o Spanner, o SQL e a análise de dados. Se você é novo ao Spanner, consulte Criar e consultar um banco de dados usando o console do Google Cloud.

Antes de começar

  1. Verifique se você configurou o Gemini em bancos de dados.
  2. Para concluir as tarefas neste documento, verifique se você tem as permissões necessárias do Identity and Access Management (IAM).

  3. No Console do Google Cloud, acesse a página Spanner.

    Acessar o Spanner

  4. Selecione uma inst�ncia na lista.

  5. Selecione um banco de dados.

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

  7. Na barra de tarefas, clique em pen_spark Gemini para conferir os recursos do Gemini no Spanner.

  8. Selecione os recursos do Gemini que voc� quer ativar, como preenchimento de SQL e gera��o de coment�rios para consultas. � poss�vel selecionar e testar recursos por conta pr�pria sem afetar outras pessoas trabalhando em seu projeto.

  9. Opcional: se voc� quiser acompanhar os exemplos deste documento, primeiro crie a tabela Singers conforme descrito em Crie um esquema para o banco de dados.

Para desativar os recursos do Gemini no Spanner, repita e desmarque os recursos do Gemini que voc� quer desativar.

Fun��es exigidas

Para ter as permiss�es necess�rias para concluir as tarefas neste documento, pe�a ao administrador para conceder a voc� Papel do IAM Leitor de banco de dados do Spanner (roles/spanner.databaseReader) no projeto. Para mais informa��es sobre a concess�o de pap�is, consulte Gerenciar o acesso a projetos, pastas e organiza��es.

Tamb�m � poss�vel conseguir as permiss�es necess�rias por meio de pap�is personalizados ou de outros pap�is predefinidos.

Gerar consultas SQL usando comandos de linguagem natural

� poss�vel fornecer coment�rios (ou solicita��es) em linguagem natural do Gemini para gerar consultas baseadas no seu esquema. Por exemplo, � poss�vel solicitar que o Genmini para gerar SQL em resposta aos seguintes comandos:

  • "Crie uma tabela que acompanhe os resultados da pesquisa de satisfa��o do cliente".
  • "Adicione uma coluna de data chamada data de nascimento � tabela de cantores".
  • "Quantos cantores nasceram nos anos 90?"

Para gerar SQL no Spanner com a assist�ncia do Gemini, siga estas etapas:

  1. No Console do Google Cloud, acesse a p�gina Spanner.

    Acessar o Spanner

  2. Selecione uma inst�ncia na lista.

  3. Selecione um banco de dados.

  4. No painel de navega��o, clique em Spanner Studio. Explorador exibe uma lista de objetos no seu banco de dados.

  5. Para consultar seu banco de dados, clique em nova guia do editor de SQL. Certifique-se de que A gera��o do SQL est� ativada.

  6. Para gerar SQL, digite um coment�rio no editor de consultas come�ando com -- seguido por um coment�rio de uma �nica linha, e, em seguida, pressione Return.

    Por exemplo, se voc� inserir o comando -- add a row to table singers e pressione Return, e o Gemini gera um SQL semelhante a:

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

    Para continuar o exemplo usando a tabela Singers, se voc� digitar o comando -- show all singers born in the 70s, o Gemini vai gerar um SQL semelhante ao seguinte:

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

  7. Analise o SQL gerado e realize uma das seguintes a��es:

    • Para aceitar o SQL gerado pelo Gemini, pressione Tab e clique em Run para executar o SQL sugerido.
    • Para editar o SQL gerado pelo Gemini, pressione Tab, edite o SQL e clique em Executar.
    • Para dispensar a sugest�o, pressione Esc ou continue digitando.

Concluir instru��es SQL no editor de consultas

Para ajudar voc� a escrever c�digo SQL, o Gemini no Spanner fornece sugest�es de preenchimento de c�digo assistido por IA. Com o Gemini ativado, quando voc� insere texto no editor de consultas do Spanner Studio, o Gemini prev� e preenche automaticamente o c�digo SQL.

Sugest�es de c�digo inline

Para usar sugest�es de c�digo inline, siga estas etapas:

  1. No Console do Google Cloud, acesse a p�gina Spanner.

    Acessar o Spanner

  2. Selecione uma inst�ncia na lista.

  3. Selecione um banco de dados.

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

  5. Para consultar o banco de dados, clique em Nova guia do editor SQL. Verifique se a conclus�o do SQL est� ativada.

  6. Digite uma consulta e um espa�o ou uma nova linha no final da linha. Ao inserir o texto, o Gemini mostra o SQL sugerido com base nos objetos compat�veis no esquema do banco de dados selecionado.

    Por exemplo, para adicionar uma linha � tabela Singers, comece a gravar o seguinte SQL: INSERT INTO Singers.

    Gemini sugere um SQL semelhante ao seguinte:

    INSERT INTO Singers
(SingerId, FirstName, LastName, BirthDate)
VALUES
  (1, 'Marc', 'Singer', '1970-03-24')

  7. Revise a sugest�o do SQL e realize uma das seguintes a��es:

    • Para aceitar o SQL gerado pelo Gemini, pressione Tab e em Executar para executar o SQL sugerido.
    • Para editar o SQL gerado pelo Gemini, pressione Tab, edite o SQL e clique em Executar.
    • Para dispensar a sugest�o, pressione Esc ou continue digitando.

Ferramenta "Preciso de ajuda com o c�digo"

Para usar a ferramenta Quero ajuda para codificar, siga estas etapas:

  1. No Console do Google Cloud, acesse a p�gina Spanner.

    Acessar o Spanner

  2. Selecione uma inst�ncia na lista.

  3. Selecione um banco de dados.

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

  5. Para consultar seu banco de dados, clique na Nova guia.

  6. Clique em pen_spark Quero ajuda para codificar ao lado do editor de consultas.

  7. Na ferramenta Preciso de ajuda com o c�digo, digite um comando. Por exemplo, add a row to table singers e clique em Gerar.

    O Gemini gera um SQL semelhante a este:

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

  8. Analise o SQL gerado e realize uma das seguintes a��es:

    • Para aceitar o SQL gerado pelo Gemini, clique em Inserir para inserir a instru��o no editor de consultas. Em seguida, clique em Executar para executar o SQL sugerido.
    • Para pedir que o Gemini gere uma nova consulta, clique em Editar. Depois de editar seu comando, clique em Atualizar. Voc� pode aceitar a nova instru��o gerada ou dispensar a sugest�o.
    • Para dispensar a sugest�o, feche a janela Quero ajuda para codificar.

Explicar instru��es SQL no editor de consultas

Use o Gemini no Spanner para explicar consultas SQL em linguagem natural. Essa explica��o pode ajudar voc� a entender a sintaxe, o esquema subjacente e o contexto comercial de consultas complexas ou longas.

  1. No Console do Google Cloud, acesse a p�gina Spanner.

    Acessar o Spanner

  2. Selecione uma inst�ncia na lista.

  3. Selecione um banco de dados.

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

  5. Para consultar seu banco de dados, clique na Nova guia.

  6. No editor de consultas, cole a consulta.

  7. Destaque a consulta que voc� quer que o Gemini explique e clique em pen_spark Explicar esta consulta.

    A explica��o do SQL aparece no painel Gemini.

A seguir