Criar consultas com a ajuda do Gemini

Use o Gemini, um colaborador com tecnologia de IA no Google Cloud, para gerar o código principal do SQL e do Dataform em arquivos .sqlx no Dataform.

Gemini para o Google Cloud não usa seus comandos ou suas respostas como dados para treinar os modelos. 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 Dataform.

Este documento é destinado a analistas, cientistas e desenvolvedores de dados que trabalham com fluxos de trabalho SQL no Dataform. Você precisa ter conhecimento da sintaxe do Google SQL e saber como criar ações de fluxo de trabalho do Dataform SQL.

Antes de começar

  1. No console do Google Cloud, acesse a página do seletor de projetos.

    Acessar o seletor de projetos

  2. Selecione ou crie um projeto do Google Cloud.

  3. Ative o Gemini no BigQuery.

Gerar uma consulta

É possível fornecer ao Gemini uma instrução (ou comando) de linguagem natural para gerar uma consulta principal do SQL ou do Dataform com base nas ações do fluxo de trabalho do SQL definidas no repositório. Por exemplo, é possível usar o Gemini para gerar uma instrução SQL SELECT em um arquivo de definição de tabela .sqlx.

Para gerar uma consulta principal do SQL ou do Dataform, siga estas etapas:

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

    Acessar a página do Dataform

  2. Selecione ou crie um repositório e, em seguida, selecione ou crie um espaço de trabalho.

  3. No painel Arquivos, selecione ou crie um arquivo .sqlx.

  4. Na guia do arquivo, clique em pen_spark Gemini.

  5. Na caixa de diálogo do Gemini, insira um comando de linguagem natural.

    Se você souber a ação SQL que quer usar, especifique o nome da ação entre crases (`) no comando.

  6. Clique em Generate (Gerar).

    O Gemini analisa as ações SQL definidas no seu repositório para encontrar ações que podem ser relevantes para seu comando e sugere uma consulta.

  7. Opcional: para enviar feedback, clique em thumb_up Gostei da sugestão, thumb_down Não gostei da sugestão ou chat_info Enviar mais feedback

  8. Para aceitar, clique em Inserir.

Dicas para gerar consultas

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

  • Forneça o nome da ação SQL entre crases (`), como `action_name`.
  • 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.

Dados do Gemini e do Dataform

Gemini no Dataform 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. Gemini no Dataform não pode acessar os dados nas suas 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.

A seguir