Aus AlloyDB for PostgreSQL importieren

Wenn Sie Daten aus AlloyDB for PostgreSQL aufnehmen möchten, gehen Sie so vor, um einen Datenspeicher zu erstellen und Daten entweder über die Google Cloud Console oder die API aufzunehmen.

Wenn sich Ihre AlloyDB for PostgreSQL-Daten im selben Projekt wie das Gemini Enterprise-Projekt befinden, lesen Sie den Abschnitt Daten aus AlloyDB for PostgreSQL importieren.

Wenn sich Ihre AlloyDB for PostgreSQL-Daten in einem anderen Projekt als Ihrem Gemini Enterprise-Projekt befinden, lesen Sie den Abschnitt AlloyDB for PostgreSQL-Zugriff einrichten.

AlloyDB for PostgreSQL-Zugriff über ein anderes Projekt einrichten

So gewähren Sie Gemini Enterprise Zugriff auf AlloyDB for PostgreSQL-Daten in einem anderen Projekt:

  1. Ersetzen Sie die folgende Variable PROJECT_NUMBER durch die Projektnummer Ihres Gemini Enterprise-Projekts und kopieren Sie dann den Inhalt dieses Codeblocks. Dies ist die Kennung Ihres Gemini Enterprise-Dienstkontos:

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

  2. Wechseln Sie zum Google Cloud -Projekt, in dem sich Ihre AlloyDB for PostgreSQL-Daten befinden.

  3. Rufen Sie die IAM-Seite auf.

    IAM

  4. Klicken Sie auf Zugriff gewähren.

  5. Geben Sie unter Neue Hauptkonten die Kennung des Gemini Enterprise-Dienstkontos ein und wählen Sie die Rolle Cloud AlloyDB > Cloud AlloyDB-Administrator aus.

  6. Klicken Sie auf Speichern.

  7. Wechseln Sie zurück zu Ihrem Gemini Enterprise-Projekt.

Rufen Sie als Nächstes Daten aus AlloyDB for PostgreSQL importieren auf.

Daten aus AlloyDB for PostgreSQL importieren

Console

So verwenden Sie die Console, um Daten aus AlloyDB for PostgreSQL zu erfassen:

  1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

    Gemini Enterprise

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Wählen Sie auf der Seite Datenquelle auswählen die Option AlloyDB aus.

  5. Geben Sie die Projekt‑ID, die Standort‑ID, die Cluster‑ID, die Datenbank‑ID und die Tabellen‑ID der Daten an, die Sie importieren möchten.

  6. Klicken Sie auf Weiter.

  7. Wählen Sie eine Region für Ihren Datenspeicher aus.

  8. Geben Sie einen Namen für den Datenspeicher ein.

  9. Klicken Sie auf Erstellen.

  10. Wenn Sie den Status der Aufnahme prüfen möchten, rufen Sie die Seite Datenspeicher auf und klicken Sie auf den Namen des Datenspeichers, um Details dazu auf der Seite Daten anzeigen zu lassen. Wenn sich die Statusspalte auf dem Tab Aktivität von Wird ausgeführt in Import abgeschlossen ändert, ist die Aufnahme abgeschlossen.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder mehrere Stunden dauern.

REST

So erstellen Sie einen Datenspeicher und nehmen Daten aus AlloyDB for PostgreSQL auf:

  1. Datenspeicher erstellen.

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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID.
    • DATA_STORE_ID: die ID des Datenspeichers. Die ID darf nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten.
    • DISPLAY_NAME: Der Anzeigename des Datenspeichers. Dies wird möglicherweise in der Google Cloud Console angezeigt.

  2. Daten aus AlloyDB for PostgreSQL importieren

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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID Ihres Gemini Enterprise-Projekts.
    • DATA_STORE_ID: die ID des Datenspeichers. Die ID darf nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten.
    • ALLOYDB_PROJECT_ID: Die ID Ihres AlloyDB for PostgreSQL-Projekts.
    • LOCATION_ID: die ID Ihres AlloyDB for PostgreSQL-Standorts.
    • CLUSTER_ID: die ID Ihres AlloyDB for PostgreSQL-Clusters.
    • DATABASE_ID: die ID Ihrer AlloyDB for PostgreSQL-Datenbank.
    • TABLE_ID: Die ID Ihrer AlloyDB for PostgreSQL-Tabelle.
    • RECONCILIATION_MODE: Optional. Mögliche Werte sind FULL und INCREMENTAL. Der Standardwert ist INCREMENTAL. Wenn Sie INCREMENTAL angeben, werden die Daten aus AlloyDB for PostgreSQL in Ihrem Datenspeicher inkrementell aktualisiert. Dabei wird ein Upsert-Vorgang ausgeführt, bei dem neue Dokumente hinzugefügt und vorhandene Dokumente durch aktualisierte Dokumente mit derselben ID ersetzt werden. Wenn Sie FULL angeben, werden die Dokumente in Ihrem Datenspeicher vollständig neu indexiert. Mit anderen Worten: Ihrem Datenspeicher werden neue und aktualisierte Dokumente hinzugefügt und Dokumente, die nicht in AlloyDB for PostgreSQL enthalten sind, werden daraus entfernt. Der FULL-Modus ist hilfreich, wenn Sie Dokumente, die Sie nicht mehr benötigen, automatisch löschen möchten.
    • AUTO_GENERATE_IDS: Optional. Gibt an, ob Dokument-IDs automatisch generiert werden sollen. Wenn dieser Wert auf true gesetzt ist, werden Dokument-IDs auf Grundlage eines Hash der Nutzlast generiert. Beachten Sie, dass generierte Dokument-IDs bei mehreren Importvorgängen möglicherweise nicht konsistent bleiben. Wenn Sie IDs bei mehreren Importvorgängen automatisch generieren, empfiehlt Google dringend, reconciliationMode auf FULL zu setzen, um einheitliche Dokument-IDs beizubehalten.
    • ID_FIELD: Optional. Gibt an, welche Felder die Dokument-IDs sind.

Nächste Schritte

  • Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

  • Hier finden Sie eine Vorschau der Suchergebnisse nach der Erstellung der App und des Datenspeichers.