Escrever SQL com a ajuda do Gemini

Prévia — Gemini no Bigtable

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Neste documento, descrevemos como usar o Gemini Code Assist para receber assistência com tecnologia de IA ao gerar consultas SQL usando comandos em linguagem natural no Bigtable.

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

Este documento é destinado a administradores de banco de dados e engenheiros de dados que conhecem o Bigtable, o SQL e a análise de dados. Se você não conhece o Bigtable, consulte o Guia de início rápido: criar uma instância do Bigtable usando o console Google Cloud .

Observação: a assistência de programação faz parte do Gemini Code Assist e está disponível sem custos financeiros até ser incluída na edição Standard do Gemini Code Assist. Essa mudança será comunicada em uma data futura. Nesse momento, você vai precisar adquirir uma licença da edição Gemini Code Assist Standard para continuar usando a assistência de programação no Bigtable Studio.

Limitações

• Não é possível usar o Gemini no Bigtable para explicar consultas SQL em linguagem natural.

• O Gemini no Bigtable pode gerar consultas que não são válidas no GoogleSQL para Bigtable ou que usam as seguintes instruções ou sintaxes não compatíveis:

  • Instruções da linguagem de manipulação de dados (DML) diferentes de SELECT, por exemplo, INSERT, UPDATE ou DELETE.
  • Instruções da linguagem de definição de dados (DDL, na sigla em inglês), por exemplo, CREATE, ALTER ou DROP.
  • Instruções de controle de acesso aos dados.
  • Sintaxe de consulta para subconsultas, JOIN, UNION e CTEs.

  Para mais informações, consulte Visão geral do GoogleSQL para Bigtable.

Antes de começar

1. Ative a API Gemini para Google Cloud em um Google Cloud projeto.

2. Para concluir as tarefas neste documento, verifique se você tem as permissões necessárias do Identity and Access Management (IAM).

3. Opcional: se você quiser acompanhar os exemplos neste documento, crie e preencha test-table conforme descrito em Criar uma tabela de teste.

Funções exigidas

Para receber as permissões necessárias para concluir as tarefas neste documento, peça ao administrador para conceder a você o papel do IAM de usuário do Gemini para Google Cloud (roles/cloudaicompanion.user) 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 usando papéis personalizados ou outros papéis predefinidos.

Gerar consultas SQL usando comandos de linguagem natural

Como uma tecnologia em estágio inicial, os produtos do Gemini para Google Cloudpodem gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide todas as saídas dos produtos do Gemini para Google Cloud antes de usá-las. Para mais informações, consulte Gemini para Google Cloud e IA responsável.

É possível fornecer comentários (ou solicitações) em linguagem natural ao Gemini para gerar consultas baseadas no seu esquema. Por exemplo, é possível solicitar que o Genmini para gerar SQL em resposta aos seguintes comandos:

• "Conte o número de dispositivos que têm um plano de dados de 1 GB."
• "Liste todos os smartphones que estavam conectados ao Wi-Fi em 1º de maio de 2019."
• "Quais tablets têm o plano de dados de 10 GB ativado?"

Observação :quando você insere um comando para o Gemini no Bigtable, as informações sobre o esquema do banco de dados são incluídas no comando. Isso pode incluir nomes de tabelas e colunas, tipos de dados e descrições de colunas. O esquema e os dados do banco de dados permanecem no Bigtable e não são enviados para o Gemini.

Para gerar SQL no Bigtable com o Gemini, siga estas etapas:

1. No console Google Cloud , acesse a página Bigtable.

   Acessar o Bigtable

2. Selecione uma instância na lista.

3. No painel de navegação, clique em Bigtable Studio.

4. Abra uma nova guia clicando em e escolha Editor.

5. Clique em Gerar SQL.

6. Na caixa de diálogo Me ajude com o código, insira seu comando e clique em Gerar.

   Por exemplo, se você inserir o comando Count the number of devices that have a 1GB data plan., o Gemini vai gerar um SQL semelhante a este:

   SELECT
       count(*)
   FROM
       `test_table`
   WHERE
       cell_plan['data_plan_01gb'] = 'true'
   

   Observação: o Gemini pode sugerir uma sintaxe diferente sempre que você inserir o mesmo comando.

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

   • Para executar o SQL sugerido, clique em Inserir e em Executar.
   • Para editar o comando, clique em Editar e depois em Atualizar.
   • Para editar o SQL sugerido, clique em Inserir. No criador de consultas, edite a consulta manualmente e clique em Executar.

8. Opcional: para continuar o exemplo de test_table, se você inserir o comando Show all data for phones from May 2019., o Gemini vai gerar um SQL semelhante a este:

   SELECT
       *
   FROM
       `test_table`
   WHERE
       _key LIKE 'phone#%#201905%'
   

A seguir

• Leia Aspectos gerais do Gemini para o Google Cloud .