Importazione da AlloyDB per PostgreSQL

Per importare dati da AlloyDB per PostgreSQL, segui questi passaggi per creare un datastore e importare i dati utilizzando la console Google Cloud o l'API.

Se i tuoi dati AlloyDB per PostgreSQL si trovano nello stesso progetto del progetto Gemini Enterprise, vai a Importa dati da AlloyDB per PostgreSQL.

Se i dati di AlloyDB per PostgreSQL si trovano in un progetto diverso da quello di Gemini Enterprise, vai a Configurare l'accesso ad AlloyDB per PostgreSQL.

Configura l'accesso ad AlloyDB per PostgreSQL da un altro progetto

Per concedere a Gemini Enterprise l'accesso ai dati di AlloyDB per PostgreSQL che si trovano in un progetto diverso, segui questi passaggi:

  1. Sostituisci la seguente variabile PROJECT_NUMBER con il numero del tuo progetto Gemini Enterprise, quindi copia i contenuti di questo blocco di codice. Questo è l'identificatore del tuo account di servizio Gemini Enterprise:

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

  2. Passa al progetto Google Cloud in cui si trovano i dati di AlloyDB per PostgreSQL.

  3. Vai alla pagina IAM.

    IAM

  4. Fai clic su Concedi l'accesso.

  5. In Nuove entità, inserisci l'identificatore dell'account di servizio Gemini Enterprise e seleziona il ruolo Cloud AlloyDB > Amministratore Cloud AlloyDB.

  6. Fai clic su Salva.

  7. Torna al progetto Gemini Enterprise.

Poi, vai a Importare dati da AlloyDB per PostgreSQL.

Importa dati da AlloyDB per PostgreSQL

Console

Per utilizzare la console per importare i dati da AlloyDB per PostgreSQL, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Nel menu di navigazione, fai clic su Datastore.

  3. Fai clic su Crea datastore.

  4. Nella pagina Seleziona un'origine dati, scegli AlloyDB.

  5. Specifica l'ID progetto, l'ID località, l'ID cluster, l'ID database e l'ID tabella dei dati che prevedi di importare.

  6. Fai clic su Continua.

  7. Seleziona una regione per il datastore.

  8. Inserisci un nome per il tuo datastore.

  9. Fai clic su Crea.

  10. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Data (Dati). Quando la colonna dello stato nella scheda Attività cambia da In corso a Importazione completata, l'importazione è terminata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

REST

Per utilizzare la riga di comando per creare un datastore e importare dati da AlloyDB per PostgreSQL, segui questi passaggi:

  1. Crea un datastore.

    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"],
}'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto.
    • DATA_STORE_ID: l'ID del datastore. L'ID può contenere solo lettere minuscole, cifre, trattini bassi e trattini.
    • DISPLAY_NAME: il nome visualizzato del datastore. Questo messaggio potrebbe essere visualizzato nella console Google Cloud .

  2. Importa dati da AlloyDB per 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",
  }'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo progetto Gemini Enterprise.
    • DATA_STORE_ID: l'ID del datastore. L'ID può contenere solo lettere minuscole, cifre, trattini bassi e trattini.
    • ALLOYDB_PROJECT_ID: l'ID del tuo progetto AlloyDB per PostgreSQL.
    • LOCATION_ID: l'ID della località di AlloyDB per PostgreSQL.
    • CLUSTER_ID: l'ID del cluster AlloyDB per PostgreSQL.
    • DATABASE_ID: l'ID del tuo database AlloyDB per PostgreSQL.
    • TABLE_ID: l'ID della tabella AlloyDB per PostgreSQL.
    • RECONCILIATION_MODE: facoltativo. I valori sono FULL e INCREMENTAL. Il valore predefinito è INCREMENTAL. Se specifichi INCREMENTAL , viene eseguito un aggiornamento incrementale dei dati da AlloyDB per PostgreSQL al tuo datastore. Esegue un'operazione di upsert, che aggiunge nuovi documenti e sostituisce quelli esistenti con documenti aggiornati con lo stesso ID. La specifica di FULL causa una ribasatura completa dei documenti nel datastore. In altre parole, i documenti nuovi e aggiornati vengono aggiunti al datastore e i documenti che non sono presenti in AlloyDB per PostgreSQL vengono rimossi dal datastore. La modalità FULL è utile se vuoi eliminare automaticamente i documenti che non ti servono più.
    • AUTO_GENERATE_IDS: facoltativo. Specifica se generare automaticamente gli ID documento. Se impostato su true, gli ID documento vengono generati in base a un hash del payload. Tieni presente che gli ID documento generati potrebbero non rimanere coerenti in più importazioni. Se generi automaticamente ID in più importazioni, Google consiglia vivamente di impostare reconciliationMode su FULL per mantenere ID documento coerenti.
    • ID_FIELD: facoltativo. Specifica quali campi sono gli ID documento.

Passaggi successivi