Conectar ao Spanner

Este documento descreve como criar um repositório de dados que se conecta aos dados do Spanner. É possível vincular esse repositório de dados a um app Gemini Enterprise para permitir que os agentes analisem seus dados.

Para se conectar aos dados do Spanner usando um repositório de dados do Gemini Enterprise, use um dos seguintes modos:

  • Consulta federada (recomendado) [Visualizar]: conecte-se aos dados do Spanner no local sem gerar custos de saída para copiar e mover os dados. A consulta federada envia sua consulta diretamente ao Spanner em todos os bancos 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. 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 específica do Spanner para o repositório de dados do Gemini Enterprise. Os dados precisam ser atualizados manualmente para refletir as mudanças na tabela do Spanner. 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 Spanner no Gemini Enterprise, você precisa ter o papel de administrador do Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) ou de administrador do Discovery Engine (roles/discoveryengine.admin). 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 Spanner para o modo de conector que você planeja usar:

Consulta federada

Para se conectar ao Spanner usando o modo de consulta federada, conceda os seguintes papéis do IAM aos usuários que consultam ou realizam ações pelo conector no Google Cloud projeto que contém o banco de dados do Spanner:

Ingestão de dados

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

Criar um repositório de dados do Spanner

Para criar um repositório de dados que conecta dados do Spanner 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 "Spanner" no campo de pesquisa Selecionar uma fonte de dados ou encontre o Spanner 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). Clique em Continuar.
    2. Na página Ações, selecione as ações do Spanner 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. Especifique detalhes sobre os dados que você quer importar. Em Importar dados da sua tabela do Spanner, especifique as seguintes informações:

      • ID do projeto: o Google Cloud projeto que contém a tabela do Spanner. Este campo é obrigatório.
      • ID da instância: o ID da instância do Spanner que contém os dados que você quer importar. Este campo é obrigatório.
      • ID do banco de dados: o ID do banco de dados do Spanner que contém os dados que você quer importar. Este campo é obrigatório.
      • ID da tabela: o ID da tabela do Spanner que contém os dados que você quer importar. Este campo é obrigatório.

      Opcionalmente, selecione Ativar o Data Boost para usar o Data Boost do Spanner para consultas mais rápidas. A ativação do Data Boost vai gerar custos extras. Consulte os preços do Data Boost do Spanner.

    3. Clique em Continuar.

  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. Opcionalmente, 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 seguir: 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 uso do Spanner 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 Spanner e do Gemini Enterprise, mesmo antes que o repositório de dados seja anexado a um app. Para saber mais sobre esses encargos, consulte os preços do Gemini Enterprise.

Próximas etapas