Neste documento, descrevemos como usar Gemini em bancos de dados para utilizar a tecnologia de IA assistência com os seguintes itens no Spanner:
- Gerar consultas SQL usando comandos em linguagem natural.
- Completar instruções SQL no editor de consultas.
- Explicar as consultas SQL no editor de consultas.
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 conhecer 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
- Verifique se você configurou o Gemini em bancos de dados.
- Para concluir as tarefas neste documento, verifique se você tem as permissões necessárias do Identity and Access Management (IAM).
No Console do Google Cloud, acesse a página Spanner.
Selecione uma instância na lista.
Selecione um banco de dados.
No menu de navegação, clique em Spanner Studio.
Na barra de tarefas, clique em pen_spark. Gemini para conferir os recursos do Gemini em no Spanner.
Selecione os recursos do Gemini que você quer ativar: exemplo, Preenchimento automático de SQL e Geração de comentários para consulta. É possível selecionar e testar recursos por conta própria sem afetar os outros trabalhando em seu projeto.
Opcional: se você quiser acompanhar os exemplos neste 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 como conceder papéis, consulte Gerenciar acesso.
Também é possível conseguir as permissões necessárias com papéis personalizados ou 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?"
Gerar SQL no Spanner com o Gemini siga estas etapas:
No Console do Google Cloud, acesse a página Spanner.
Selecione uma instância na lista.
Selecione um banco de dados.
No painel de navegação, clique em Spanner Studio. Explorer exibe uma lista de objetos no seu banco de dados.
Para consultar seu banco de dados, clique em A geração do SQL está ativada.
nova guia do editor de SQL. Certifique-se de quePara gerar SQL, digite um comentário no editor de consultas começando com
--
seguido de um comentário de uma única linha, e, em seguida, pressioneReturn
.Por exemplo, se você inserir o comando
-- add a row to table singers
e pressioneReturn
, 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ê inserir o comando-- show all singers born in the 70s
, depois Gemini gera um SQL semelhante ao seguinte:SELECT * FROM Singers WHERE Singers.BirthDate BETWEEN '1970-01-01' AND '1979-12-31'
Analise o SQL gerado 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.
- Para aceitar o SQL gerado pelo Gemini, pressione
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 ativada, quando você digita 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:
No Console do Google Cloud, acesse a página Spanner.
Selecione uma instância na lista.
Selecione um banco de dados.
No painel de navegação, clique em Spanner Studio.
Para consultar o banco de dados, clique em O preenchimento automático do SQL está ativado.
Nova guia do editor SQL. Certifique-se de queDigite 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')
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.
- Para aceitar o SQL gerado pelo Gemini, pressione
Ferramenta "Preciso de ajuda com o código"
Para usar a ferramenta Quero ajuda para codificar, siga estas etapas:
No Console do Google Cloud, acesse a página Spanner.
Selecione uma instância na lista.
Selecione um banco de dados.
No painel de navegação, clique em Spanner Studio.
Para consultar seu banco de dados, clique na
Nova guia.Clique em pen_spark Quero ajuda para codificar ao lado do editor de consultas.
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');
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
É possível usar o Gemini no Spanner para explicar as 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.
No Console do Google Cloud, acesse a página Spanner.
Selecione uma instância na lista.
Selecione um banco de dados.
No painel de navegação, clique em Spanner Studio.
Para consultar seu banco de dados, clique na
Nova guia.No editor de consultas, cole a consulta.
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
- Leia as Informações gerais do Gemini para Google Cloud.
- Saiba como o Gemini usa seus dados.
- Saiba como analisar seus dados usando o Gemini para Google Cloud.