Criar ações com a ajuda do Gemini

Você pode usar o Gemini, um colaborador com tecnologia de IA em Google Cloud, para gerar código SQL e do Dataform Core 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 no Dataform. É necessário ter conhecimento sobre a sintaxe do GoogleSQL e como criar ações de fluxo de trabalho 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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
  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 de fluxo de trabalho definidas no seu 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 SQL ou do Dataform Core, siga estas etapas:

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

    Acessar a página do Dataform

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

  3. No painel Arquivos, 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ê sabe qual ação SQL quer usar, especifique o nome dela entre acentos graves (`) no seu comando.

  6. Clique em Gerar.

    O Gemini revisa as ações de SQL definidas no seu repositório para encontrar ações 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 a sugestão, 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 acentos graves (`), 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