Conectar-se ao BigQuery

Neste documento, descrevemos como criar um repositório de dados que se conecta aos dados do BigQuery. Você pode vincular esse repositório de dados a um app do Gemini Enterprise para permitir que os agentes analisem seus dados.

Para se conectar aos dados do BigQuery usando um repositório de dados do Gemini Enterprise, use um destes modos:

  • Consulta federada (recomendado) [Visualização]: conecte-se aos dados do BigQuery no local sem gerar custos de saída para copiar e mover os dados. A consulta federada envia sua consulta diretamente ao BigQuery em todos os conjuntos de dados e tabelas que sua identidade tem permissão do Identity and Access Management (IAM) para acessar, o que é mais eficiente para consultas analíticas. Como as consultas são executadas usando suas credenciais, as permissões do IAM do BigQuery, incluindo a segurança no nível da linha, permanecem intactas. Ao usar o modo de consulta federada, o Knowledge Catalog é ativado automaticamente na guia Assistente do app Gemini Enterprise para fornecer ao agente ferramentas para pesquisar dados a que o usuário tem acesso e procurar contexto.
  • Ingestão de dados: copie dados de uma tabela do BigQuery específica para o repositório de dados do Gemini Enterprise. Os dados precisam ser atualizados para refletir as mudanças na tabela do BigQuery. Esse modo gera custos de saída para mover dados para um novo local, e as permissões do IAM atuais não são replicadas no repositório de dados.

Antes de começar

Para criar um repositório de dados do BigQuery no Gemini Enterprise, você deve ter o administrador do Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) ou administrador do Discovery Engine (roles/discoveryengine.admin) papel. Para mais informações, consulte Conceder permissões aos administradores.

Se o projeto estiver protegido por um perímetro do VPC Service Controls ou tiver a aplicação da política da organização ativada, verifique se a política da organização permite o conector:

Além disso, configure as permissões necessárias do IAM do BigQuery para o modo de conector que você planeja usar:

Consulta federada

O modo de consulta federada usa o servidor MCP do BigQuery. Como diferentes ferramentas do MCP (ações) exigem permissões diferentes, as permissões necessárias do IAM dependem das ferramentas que você usa. Para mais informações, consulte Papéis necessários na documentação do MCP do BigQuery.

A seguir estão os papéis do IAM mais usados para usuários que consultam ou realizam ações pelo conector:

Ingestão de dados

Para ingerir dados de um Google Cloud projeto de origem diferente do Google Cloud projeto que contém o repositório de dados do Gemini Enterprise que você está criando, conceda os seguintes papéis do IAM no projeto do BigQuery de origem àservice-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com conta de serviço (em que PROJECT_NUMBER é o número do projeto que contém oGoogle Cloud projeto que contém o repositório de dados do Gemini Enterprise):

Criar um repositório de dados do BigQuery

Para criar um repositório de dados que conecta dados do BigQuery ao Gemini Enterprise, siga estas etapas:

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

    Gemini Enterprise

  2. Acesse a página Repositório de dados.

  3. Clique em Criar repositório de dados.

  4. Na página Origem, escolha uma fonte de dados para o repositório de dados. Pesquise "BigQuery" no campo de pesquisa Selecionar uma fonte de dados ou encontre o BigQuery na lista de Fontes de dados próprias. Selecione Adicionar fonte de dados.

  5. Na página Dados, selecione o modo de conector para se conectar aos dados. Selecione uma das guias a seguir para mais instruções com base no modo escolhido.

    Consulta federada

    1. Selecione Consulta federada (recomendado).
    2. Opcional: em Opções avançadas, especifique o Google Cloud projeto de faturamento para a execução da consulta do repositório de dados digitando o ID do projeto no campo ID do projeto de faturamento. Se você deixar esse campo vazio, as consultas vão solicitar um projeto de faturamento ao usuário ou depender de instruções personalizadas.
    3. Clique em Continuar.
    4. Na página Ações, selecione as ações do BigQuery que você quer ativar para o repositório de dados. Você pode editar essas configurações mais tarde. Clique em Continuar.

    Ingestão de dados

    1. Selecione Ingestão de dados.
    2. Determine o tipo de dados que você está importando. Antes de importar os dados, consulte Preparar dados para ingestão.
      • Se você estiver importando dados estruturados, selecione Tabela do BigQuery com seu próprio esquema ou Tabela do BigQuery com metadados. Se você usar seu próprio esquema, ele será detectado automaticamente durante a importação. Se você usar metadados, defina um esquema especificado pelo Google durante a importação.
      • Se você estiver importando dados que exigem processamento especializado, selecione uma das opções em Importação de dados especializados.

    3. Em Frequência de sincronização, selecione a frequência com que você quer importar dados da tabela do BigQuery. Essa opção não pode ser alterada após a criação do repositório de dados.

      • Selecione Uma vez para uma única importação.
      • Selecione Periódico para definir uma programação de importação recorrente.

    4. Selecione a tabela de dados que você quer importar. No campo Caminho do BigQuery , clique em Procurar , selecione uma tabela que você preparou para ingestão e clique em Selecionar. Como alternativa, insira o local da tabela diretamente no campo Caminho do BigQuery.

    5. Clique em Continuar.

    Depois de criar o repositório de dados, você pode verificar o status da ingestão acessando a página Repositórios de dados e clicando no nome do repositório de dados para conferir os detalhes na página Dados. Quando a coluna de status na guia Atividade mudar de Em andamento para Importação concluída, a ingestão será concluída.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

  6. Na página Configuração, configure as definições do repositório de dados.

    • Local do conector de dados: escolha uma região para armazenar os metadados do repositório de dados. Não é possível mudar o local depois que o repositório de dados é criado. Para informações importantes sobre multirregiões, consulte os locais do Gemini Enterprise.
    • Nome do conector de dados: no campo Nome do conector de dados, insira um nome para o conector de dados. Não é possível mudar o nome depois que o conector de dados é criado. A inserção de um nome gera um ID exclusivo para o conector de dados. Opcional: no campo Tag (opcional) , insira uma tag para o conector de dados, que serve como um identificador estável para o conector em todas as versões.
    • Política de proteção de dados sensíveis: selecione uma política de proteção de dados sensíveis para o repositório de dados. O formato precisa ser: projects/{project}/locations/{location}/contentPolicies/{policy}. Você pode editar essa configuração mais tarde.

  7. Clique em Criar.

Agora você está pronto para anexar o repositório de dados a um app do Gemini Enterprise. No modo de consulta federada, as consultas geram custos de computação do BigQuery quando os usuários executam consultas pelo app anexado. No modo de ingestão de dados, a importação de dados gera custos de indexação do BigQuery e do Gemini Enterprise, mesmo antes que o repositório de dados seja anexado a um app. Para saber mais sobre esses encargos, consulte Preços do Gemini Enterprise.

Próximas etapas