Criar ações com a ajuda do Gemini

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

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

Somente comandos em inglês são aceitos no Gemini no Dataform.

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

Antes de começar

  1. No Google Cloud console do, acesse a página Seletor de Projetos.

    Acessar o seletor de projetos

  2. Selecione ou crie um Google Cloud projeto do.

    Papéis necessários para selecionar ou criar um projeto

    • Selecionar um projeto: a seleção de um projeto não exige um papel específico do IAM. Você pode selecionar qualquer projeto em que tenha recebido um papel.
    • Criar um projeto: para criar um projeto, você precisa do papel de criador de projetos (roles/resourcemanager.projectCreator), que contém a resourcemanager.projects.create permissão. Saiba como conceder papéis.
  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 núcleo do Dataform com base nas ações de fluxo de trabalho definidas no seu repositório. Por exemplo, você pode 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 núcleo do Dataform, siga estas etapas:

  1. Noconsole, acesse a página Dataform. Google Cloud

    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 acentos graves (`) no comando.

  6. Clique em Gerar.

    O Gemini analisa as ações SQL definidas no seu repositório para encontrar ações 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 fornecidas 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