Criar consultas com a ajuda do Gemini

Você pode usar o Gemini, um colaborador com tecnologia de IA no Google Cloud, para gerar código SQL e do núcleo do Dataform em arquivos .sqlx no Dataform.

Saiba como e quando o Gemini para 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. É necessário ter conhecimento sobre a sintaxe do SQL do Google e como criar ações de fluxo de trabalho SQL do Dataform.

Antes de começar

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

  3. Ative o Gemini no BigQuery.

Gerar uma consulta

É possível fornecer ao Gemini uma instrução de linguagem natural (ou comando) para gerar uma consulta SQL ou do Dataform Core com base nas ações do fluxo de trabalho 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.

    Acesse 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 Files, selecione ou crie um arquivo .sqlx.

  4. Na guia "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 acentos graves (`) no seu comando.

  6. Clique em Gerar.

    O Gemini analisa as ações SQL definidas no repositório para encontrar ações que podem ser relevantes para o 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 a sugestão, clique em Inserir.

Dicas para geração de consultas

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

  • Informe o nome da ação SQL entre chaves invertidas (`), 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

O 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. O Gemini no Dataform 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 para Google Cloud usa seus dados.

A seguir