Criar consultas com a assistência do Gemini

Para solicitar acesso aos recursos de pré-visualização de consultas SQL do Gemini no BigQuery, faça o seguinte: preencha o Gemini no formulário de visualização do BigQuery. Para fornecer feedback ou solicitar suporte para esse recurso, envie um e-mail para gemini-in-bigquery-feedback@google.com. Não é necessário solicitar acesso à assistência do Gemini para código Python no BigQuery.

Use o Gemini, uma ferramenta de colaboração com tecnologia de IA no Google Cloud, para ajudar você a realizar as seguintes ações no BigQuery:

• Gerar uma consulta SQL
• Preencher uma consulta SQL
• Explicar uma consulta SQL
• Gerar código Python
• Concluir código Python

O Gemini não usa seus comandos nem as respostas deles como dados para treinar o modelo. Para mais informações, consulte Como o Gemini para o Google Cloud usa seus dados.

Somente os comandos em inglês são compatíveis com o Gemini no BigQuery.

Este documento é destinado a analistas, cientistas e desenvolvedores de dados que trabalham com consultas SQL e notebooks do Colab Enterprise no BigQuery. Presumimos que você tenha conhecimento de como consultar dados no espaço de trabalho do BigQuery SQL ou como trabalhar com notebooks para analisar dados do BigQuery usando Python.

Antes de começar

1. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Acessar o seletor de projetos

2. Verifique se o Gemini está configurado para sua conta de usuário e projeto do Google Cloud.
3. Para usar com o código Python, ative o gerenciamento de recursos no BigQuery Studio.

Gerar uma consulta SQL

É possível fornecer o Gemini uma instrução de linguagem natural (ou prompt) para gerar uma consulta SQL com base no esquema dos dados. Mesmo que você esteja começando sem código, com um conhecimento limitado do esquema de dados ou apenas um conhecimento básico da sintaxe do SQL do Google, o Gemini pode gerar uma ou mais instruções SQL que podem ajudar você a explorar seus dados.

Usar a ferramenta "Quero ajuda para codificar"

A ferramenta Quero ajuda para codificar permite usar a linguagem natural para gerar uma consulta SQL que pode ser executada no BigQuery Studio.

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

1. No Console do Google Cloud, acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas do BigQuery Studio, clique em add_box Criar consulta SQL.

3. Na barra de tarefas, clique em pen_sparkGemini e selecione a Ferramenta de geração de código se ainda não tiver feito isso.

   

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

   

5. Na ferramenta Quero ajuda para codificar, digite um comando. Exemplo:

    Using `bigquery-public-data.austin_bikeshare.bikeshare_trips`, show me the
    ten longest trip length by subscriber type.
   

6. Clique em Gerar.

   Gemini gera uma consulta SQL semelhante à seguinte:

   SELECT subscriber_type,
      MAX(duration_minutes) AS longest_trip_duration
   FROM `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   GROUP BY subscriber_type
   ORDER BY longest_trip_duration DESC
   LIMIT 10;
   

7. Analise a consulta SQL gerada e realize uma das seguintes ações:

   • Para aceitar a consulta SQL gerada, clique em Inserir para inserir a instrução no editor de consultas. Em seguida, clique em Executar para executar a consulta SQL sugerida.
   • 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.

8. Para solicitar que o Gemini gere uma nova consulta usando uma fonte de tabela específica, clique em Editar origens da tabela, selecione a nova origem da tabela e clique em Aplicar. Você pode aceitar a nova declaração ou dispensar a sugestão.

Comando para gerar consultas SQL

Para gerar SQL, digite o caractere # no editor de consultas do BigQuery seguido de uma instrução de linguagem natural ou uma pergunta sobre as informações que você quer. Gemini revisa suas consultas recentes para encontrar um esquema de tabela relevante para seu comando. Se você sabe qual tabela quer usar, especifique o nome dela entre acentos graves (`) no seu comando.

No exemplo a seguir, você gera uma consulta para uma tabela pública do BigQuery, bigquery-public-data.austin_bikeshare.bikeshare_trips.

1. No console do Google Cloud, acesse a página BigQuery Studio.

   Acessar o BigQuery Studio

   schoolAs etapas restantes serão exibidas automaticamente no console do Google Cloud.

2. No editor de consultas SQL, clique em add_box Criar uma nova consulta.

3. Verifique se o Gemini está configurado para sua conta de usuário e projeto do Google Cloud. Os botões do Gemini não ficam visíveis até que a configuração seja concluída.

4. Na barra de tarefas, clique em pen_spark Gemini e selecione Geração automática se: ela já não estará selecionada.

   

5. No editor de consultas, insira o seguinte comando de linguagem natural:

   # Using `bigquery-public-data.austin_bikeshare.bikeshare_trips`, calculate the
   # average trip length by subscriber type.
   

6. Pressione Enter (Return no macOS).

   Gemini sugere uma consulta SQL semelhante à seguinte:

   SELECT
   subscriber_type,
   AVG(duration_minutes) AS average_trip_length
   FROM
   `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   GROUP BY
   subscriber_type
   

7. Para aceitar a sugestão, pressione Tab.

Mostrar mais sugestões

Gemini pode sugerir mais de uma instrução SQL que responda ao seu comando. Exemplo:

1. No editor de consultas, insira o seguinte comando de linguagem natural e pressione Enter (Return no macOS):

   # Write a query that creates a table in the dataset `1234` with a string column called "name"
   

   Gemini sugere uma consulta SQL.

2. Para ver se há outras sugestões, mantenha o ponteiro sobre a consulta SQL sugerida.

3. Clique em qualquer outra sugestão e siga um destes procedimentos:

   • Para aceitar uma sugestão, pressione Tab.
   • Para aceitar palavras específicas, pressione Ctrl + seta para a direita (Command + seta para a direita no macOS).
   • Para dispensar sugestões, pressione Esc.

Dicas para geração de SQL

As dicas a seguir podem melhorar as sugestões oferecidas pelo Gemini no BigQuery:

• Para especificar um esquema de dados, forneça o nome da tabela totalmente qualificado entre crases (`), como `project.dataset.table`.
• Se os nomes das colunas ou as relações semânticas delas não forem claros ou complexos, forneça contexto no prompt para orientar o Gemini na resposta que você quer. Esse processo é conhecido como engenharia de comando. Por exemplo, para incentivar uma consulta gerada para referenciar um nome de coluna, descreva o nome da coluna e sua relevância para a resposta desejada. Para incentivar uma resposta que mencione termos complexos, como valor da vida útil ou margem bruta, descreva o conceito e a relevância dele para seus dados para melhorar os resultados da geração de SQL.
• As solicitações podem se estender por várias linhas no editor de consultas, mas cada linha precisa começar com um caractere #.

Dados do Gemini e do BigQuery

O Gemini no BigQuery pode acessar os metadados das tabelas que você tem permissão para acessar. Isso pode incluir os nomes da tabela, nomes de colunas, tipos de dados e descrições de coluna. O Gemini no BigQuery não pode acessar os dados em tabelas, visualizações ou modelos. Para mais informações sobre como o Gemini usa seus dados, consulte Como o Gemini no Google Cloud usa seus dados.

Preencher uma consulta SQL

O preenchimento de SQL tenta fornecer recomendações contextualmente adequadas com base no conteúdo no editor de consultas. Conforme você digita, o Gemini pode sugerir próximas etapas lógicas relevantes para o contexto da sua consulta atual ou ajudar você a iterar em uma consulta.

Para testar a conclusão do SQL com o Gemini, siga estas etapas:

1. No console do Google Cloud, acesse a página BigQuery Studio.

   Acessar o BigQuery Studio

   schoolAs etapas restantes serão exibidas automaticamente no console do Google Cloud.

2. Verifique se o Gemini está configurado para sua conta de usuário e projeto do Google Cloud. Os botões do Gemini não ficam visíveis até que a configuração seja concluída.

3. Na barra de tarefas, clique em pen_spark Gemini e selecione Preenchimento automático se: ela já não estará selecionada.

4. No editor de consultas, copie o seguinte código:

   SELECT
     subscriber_type
     , EXTRACT(HOUR FROM start_time) AS hour_of_day
     , AVG(duration_minutes) AS avg_trip_length
   FROM
     `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   

   Uma mensagem de erro informa que subscriber_type não está agrupado nem agregado. É comum precisar de ajuda para conseguir uma consulta ideal.

5. Pressione Enter (Return no macOS) ou Espaço.

   Gemini sugere refinamentos para a consulta que podem terminar em texto semelhante ao seguinte:

   GROUP BY
   subscriber_type, hour_of_day;
   

6. Para aceitar a sugestão, pressione Tab ou mantenha o ponteiro sobre o texto sugerido e clique para conferir sugestões alternativas. Para dispensar uma sugestão, pressione ESC ou continue digitando.

Explicar uma consulta SQL

Você pode solicitar que o Gemini no BigQuery explique uma consulta SQL em linguagem natural. Essa explicação pode ajudar você a entender uma consulta em que a sintaxe, esquema subjacente e contexto comercial podem ser difíceis de avaliar devido ao tamanho ou à complexidade da consulta.

1. No console do Google Cloud, acesse a página BigQuery Studio.

   Acessar o BigQuery Studio

   schoolAs etapas restantes serão exibidas automaticamente no console do Google Cloud.

2. Verifique se o Gemini está configurado para sua conta de usuário e projeto do Google Cloud. Os botões do Gemini não ficam visíveis até que a configuração seja concluída.

3. Na barra de tarefas, clique em pen_spark Gemini e selecione Explicação, se ele estiver que ainda não esteja selecionado.

4. No Editor de consultas, abra ou cole a consulta que você quer uma explicação.

5. 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.

Gerar código Python

Peça ao Gemini com uma declaração ou pergunta de linguagem natural para gerar código Python. Gemini responde com uma ou mais sugestões de código em Python.

No exemplo a seguir, você gera o código para um conjunto de dados público do BigQuery, bigquery-public-data.ml_datasets.penguins.

1. Acesse a página do BigQuery Studio.

   Acessar o BigQuery

2. Na barra de tarefas, clique em pen_sparkGemini e, na seção Gemini em notebooks Python, selecione Código de dados, caso ainda não esteja selecionado.

   

3. Na barra de guias do painel do editor, clique na arrow_drop_down seta suspensa ao lado do sinal + e clique em Criar um notebook em Python:

   

   O novo notebook é aberto, com células que mostram exemplos de consultas no conjunto de dados público bigquery-public-data.ml_datasets.penguins.

4. Na barra de tarefas, clique em + Código para inserir uma nova célula de código. Uma nova célula de código vai aparecer: Começar a codificar ou gerar com IA.

5. Na nova célula de código, clique em generate.

6. No editor de consultas, insira o seguinte comando de linguagem natural:

   Using bigquery magics query the `bigquery-public-data.ml_datasets.penguins` table
   

7. Pressione Enter (Return no macOS).

   Gemini sugere um código Python semelhante ao seguinte:

   %%bigquery
   SELECT *
   FROM `bigquery-public-data.ml_datasets.penguins`
   LIMIT 10
   

Preenchimento automático de código Python

O preenchimento de código em Python tenta fornecer recomendações contextualmente apropriadas, baseadas no conteúdo do editor de consultas. Conforme você digita, o Gemini pode sugerir as próximas etapas lógicas relevantes ao contexto do seu código atual ou ajudar você a iterar o código.

Para testar o preenchimento de código Python com o Gemini, siga estas etapas:

1. Acesse a página do BigQuery Studio.

   Acessar o BigQuery

2. Na barra de tarefas, clique em pen_sparkGemini e, na seção Gemini no notebook Python, selecione Código conclusão, caso ainda não esteja selecionada.

   

3. Na barra de guias do painel do editor, clique na arrow_drop_down seta suspensa ao lado do sinal + e clique em Criar um notebook em Python:

   

   O novo notebook é aberto, com células que mostram exemplos de consultas no conjunto de dados público bigquery-public-data.ml_datasets.penguins.

4. No editor de código, comece a digitar o código Python. Gemini sugere código inline enquanto você digita. Para aceitar a sugestão, pressione Tab.

Desativar recursos do Gemini

Para desativar os recursos do Gemini no BigQuery, faça o seguinte:

1. Na barra de tarefas do Editor de consultas SQL, clique em pen_spark Gemini.

2. Desmarque os recursos do Gemini que você quer desativar.

Fornecer feedback

Você pode enviar feedback sobre as sugestões do Gemini.

• Para fornecer feedback, na barra de tarefas, clique em pen_spark Gemini e selecione Enviar feedback

Ajude a melhorar as sugestões

Ajude a melhorar as sugestões do Gemini compartilhando os dados de comandos com o Google. Para compartilhar seus dados de comandos, siga estas etapas:

1. No console do Google Cloud, na página do BigQuery Studio, na barra de tarefas, clique em pen_spark Gemini.

2. Selecione Compartilhar dados para melhorar o Gemini.

3. Atualize suas configurações de uso de dados na caixa de diálogo de configuração.

As configurações de compartilhamento de dados se aplicam a todo o projeto e só podem ser definidas por um administrador com as permissões de IAM serviceusage.services.enable e serviceusage.services.list. Para mais informações sobre o uso de dados no programa Trusted Tester, consulte Gemini no programa Trusted Tester do Google Cloud.

A seguir

• Para mais informações sobre o Gemini no Google Cloud, consulte Visão geral do Gemini no Google Cloud.
• Para informações sobre a política de dados do Gemini, consulte Como o Gemini no Google Cloud usa seus dados.