Crie ações com a assistência do Gemini

Pode usar o Gemini, um colaborador com tecnologia de IA no Google Cloud, para gerar código SQL e Dataform core em ficheiros .sqlx no Dataform.

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

Apenas são suportados comandos em inglês para o Gemini no Dataform.

Este documento destina-se a analistas de dados, cientistas de dados e programadores de dados que trabalham com fluxos de trabalho no Dataform. Parte do princípio de que tem conhecimentos da sintaxe SQL da Google e de 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.

  3. Ative o Gemini no BigQuery.

Gere uma consulta

Pode fornecer ao Gemini uma declaração em linguagem natural (ou um comando) para gerar uma consulta SQL ou Dataform Core com base nas ações do fluxo de trabalho definidas no seu repositório. Por exemplo, pode usar o Gemini para gerar uma declaração SQL SELECT num ficheiro de definição de tabela .sqlx.

Para gerar uma consulta SQL ou Dataform core, siga estes passos:

  1. Na Google Cloud consola, aceda à página Dataform.

    Aceda à página do formulário de dados

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

  3. No painel Ficheiros, selecione ou crie um ficheiro .sqlx.

  4. No separador Ficheiro, clique em pen_spark Gemini.

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

    Se souber a ação SQL que quer usar, pode especificar o nome da ação entre acentos graves (`) no comando.

  6. Clique em Gerar.

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

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

  8. Para aceitar a sugestão, clique em Inserir.

Sugestões para a geração de consultas

As sugestões seguintes podem melhorar as sugestões que o Gemini no Dataform oferece:

  • Indique o nome da ação SQL entre acentos graves (`), como `action_name`.
  • Se os nomes das colunas ou as respetivas relações semânticas não forem claras ou forem complexas, pode fornecer contexto no comando para orientar o Gemini para a resposta que quer. Esta técnica é conhecida como engenharia de comandos. Por exemplo, para incentivar uma consulta gerada a referenciar um nome de coluna, descreva o nome da coluna e a respetiva relevância para a resposta que quer. Para incentivar uma resposta que faça referência a termos complexos, como valor do cliente ou margem bruta, descreva o conceito e a respetiva relevância para os seus dados de modo a melhorar os resultados da geração de SQL.

O Gemini e os dados do Dataform

O Gemini no Dataform pode aceder aos metadados das tabelas às quais tem autorização de acesso. Isto pode incluir os nomes das tabelas, os nomes das colunas, os tipos de dados e as descrições das colunas. O Gemini no Dataform não pode aceder aos dados nas suas tabelas, vistas nem modelos. Para mais informações sobre como o Gemini usa os seus dados, consulte o artigo Como o Gemini para Google Cloud usa os seus dados.

O que se segue?