Importar do AlloyDB para PostgreSQL

Para ingerir dados do AlloyDB para PostgreSQL, siga estas etapas para criar um repositório de dados e ingerir dados usando o console Google Cloud ou a API.

Se os dados do AlloyDB para PostgreSQL estiverem no mesmo projeto do Gemini Enterprise, acesse Importar dados do AlloyDB para PostgreSQL.

Se os dados do AlloyDB para PostgreSQL estiverem em um projeto diferente do seu projeto do Gemini Enterprise, acesse Configurar o acesso ao AlloyDB para PostgreSQL.

Configurar o acesso ao AlloyDB para PostgreSQL de outro projeto

Para dar ao Gemini Enterprise acesso aos dados do AlloyDB para PostgreSQL que estão em um projeto diferente, siga estas etapas:

  1. Substitua a variável PROJECT_NUMBER pelo número do projeto do Gemini Enterprise e copie o conteúdo do bloco de código. Este é o identificador da sua conta de serviço do Gemini Enterprise:

    service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com

  2. Mude para o projeto Google Cloud em que seus dados do AlloyDB para PostgreSQL estão localizados.

  3. Acessar a página IAM

    IAM

  4. Clique em Permitir acesso.

  5. Em Novos principais, insira o identificador da conta de serviço do Gemini Enterprise e selecione o papel Cloud AlloyDB > Administrador do Cloud AlloyDB.

  6. Clique em Salvar.

  7. Volte para o projeto do Gemini Enterprise.

Em seguida, acesse Importar dados do AlloyDB para PostgreSQL.

Importar dados do AlloyDB para PostgreSQL

Console

Para usar o console e ingerir dados do AlloyDB para PostgreSQL, siga estas etapas:

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

    Gemini Enterprise

  2. No menu de navegação, selecione Repositório de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma fonte de dados, escolha AlloyDB.

  5. Especifique o ID do projeto, o ID do local, o ID do cluster, o ID do banco de dados e o ID da tabela dos dados que você planeja importar.

  6. Clique em Continuar.

  7. Escolha uma região para o repositório de dados.

  8. Insira um nome para o repositório de dados.

  9. Clique em Criar.

  10. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique 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.

REST

Para usar a linha de comando e criar um repositório de dados e ingerir dados do AlloyDB para PostgreSQL, siga estas etapas:

  1. Crie um repositório de dados.

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores?dataStoreId=DATA_STORE_ID" \
-d '{
  "displayName": "DISPLAY_NAME",
  "industryVertical": "GENERIC",
  "solutionTypes": ["SOLUTION_TYPE_SEARCH"],
}'

    Substitua:

    • PROJECT_ID: ID do projeto.
    • DATA_STORE_ID: o ID do repositório de dados. O ID pode conter apenas letras minúsculas, dígitos, sublinhados e hífens.
    • DISPLAY_NAME: o nome de exibição do repositório de dados. Isso pode ser exibido no console do Google Cloud .

  2. Importe dados do AlloyDB para PostgreSQL.

      curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents:import" \
  -d '{
    "alloyDbSource": {
      "projectId": "ALLOYDB_PROJECT_ID",
      "locationId": "LOCATION_ID",
      "clusterId": "CLUSTER_ID",
      "databaseId": "DATABASE_ID",
      "tableId": "TABLE_ID",
    },
    "reconciliationMode": "RECONCILIATION_MODE",
    "autoGenerateIds": "AUTO_GENERATE_IDS",
    "idField": "ID_FIELD",
  }'

    Substitua:

    • PROJECT_ID: o ID do seu projeto do Gemini Enterprise.
    • DATA_STORE_ID: o ID do repositório de dados. O ID só pode conter letras minúsculas, dígitos, sublinhados e hífens.
    • ALLOYDB_PROJECT_ID: o ID do seu projeto do AlloyDB para PostgreSQL.
    • LOCATION_ID: o ID da sua região do AlloyDB para PostgreSQL.
    • CLUSTER_ID: o ID do cluster do AlloyDB para PostgreSQL.
    • DATABASE_ID: o ID do seu banco de dados do AlloyDB para PostgreSQL.
    • TABLE_ID: o ID da sua tabela do AlloyDB para PostgreSQL.
    • RECONCILIATION_MODE: opcional. Os valores são FULL e INCREMENTAL. O padrão é INCREMENTAL. Especificar INCREMENTAL causa uma atualização incremental de dados do AlloyDB para PostgreSQL no seu repositório de dados. Isso faz uma operação de upsert, que adiciona novos documentos e substitui os documentos existentes por documentos atualizados com o mesmo ID. Especificar FULL causa uma rebase completa dos documentos no repositório de dados. Em outras palavras, documentos novos e atualizados são adicionados ao seu repositório de dados, e os documentos que não estão no AlloyDB para PostgreSQL são removidos dele. O modo FULL é útil se você quiser excluir automaticamente documentos que não precisa mais.
    • AUTO_GENERATE_IDS: opcional. Especifica se os IDs de documento serão gerados automaticamente. Se definido como true, os IDs de documento serão gerados com base em um hash do payload. Os IDs de documentos gerados podem não permanecer consistentes em várias importações. Se você gerar IDs automaticamente em várias importações, o Google recomenda definir reconciliationMode como FULL para manter IDs de documento consistentes.
    • ID_FIELD: opcional. Especifica quais campos são os IDs de documento.

Próximas etapas

  • Para anexar seu repositório de dados a um app, crie um app e selecione o repositório seguindo as etapas em Criar um app de pesquisa.

  • Para ver como os resultados da pesquisa aparecem depois que o app e o repositório de dados são configurados, consulte Visualizar resultados da pesquisa.