Aus Spanner importieren

Wenn Sie Daten aus Cloud Spanner aufnehmen möchten, gehen Sie so vor, um einen Datenspeicher zu erstellen und Daten entweder mit der Google Cloud Console oder der API aufzunehmen.

Cloud Spanner-Zugriff aus einem anderen Projekt einrichten

Wenn sich Ihre Cloud Spanner-Daten im selben Projekt wie Gemini Enterprise befinden, fahren Sie mit Daten aus Cloud Spanner importieren fort.

So gewähren Sie Gemini Enterprise Zugriff auf Cloud Spanner-Daten in einem anderen Projekt:

  1. Ersetzen Sie die folgende PROJECT_NUMBER-Variable 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. Rufen Sie die Seite IAM und Verwaltung auf.

    IAM und Verwaltung

  3. Wechseln Sie auf der Seite IAM und Verwaltung zu Ihrem Cloud Spanner-Projekt und klicken Sie auf Zugriff gewähren.

  4. Geben Sie unter Neue Hauptkonten die Kennung für das Dienstkonto ein und wählen Sie eine der folgenden Optionen aus:

    • Wenn Sie den Daten-Boost während des Imports nicht verwenden, wählen Sie die Rolle Cloud Spanner > Cloud Spanner Database Reader aus.
    • Wenn Sie Data Boost während des Imports verwenden möchten, wählen Sie die Rolle Cloud Spanner > Cloud Spanner Database Admin oder eine benutzerdefinierte Rolle mit den Berechtigungen von Cloud Spanner Database Reader und spanner.databases.useDataBoost aus. Informationen zu Data Boost finden Sie in der Data Boost-Übersicht in der Cloud Spanner-Dokumentation.

  5. Klicken Sie auf Speichern.

Gehen Sie dann zu Daten aus Cloud Spanner importieren.

Daten aus Cloud Spanner importieren

Console

So nehmen Sie Daten aus Cloud Spanner über die Console auf:

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

    Gemini Enterprise

  2. Rufen Sie die Seite Datenspeicher auf.

  3. Klicken Sie auf Datenspeicher erstellen.

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

  5. Geben Sie die Projekt‑ID, die Instanz‑ID, die Datenbank‑ID und die Tabellen‑ID der zu importierenden Daten an.

  6. Wählen Sie aus, ob Data Boost aktiviert werden soll. Informationen zu Data Boost finden Sie in der Data Boost-Übersicht in der Cloud Spanner-Dokumentation.

  7. Klicken Sie auf Weiter.

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

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

  10. Klicken Sie auf Erstellen.

  11. Wenn Sie den Status der Aufnahme überprüfen möchten, rufen Sie die Seite Datenspeicher auf und klicken Sie auf den Namen des Datenspeichers. Dadurch werden die Details auf der Seite Daten angezeigt. Wenn sich die Statusspalte auf dem Tab Aktivität von In Bearbeitung zu Import abgeschlossen ändert, ist die Aufnahme abgeschlossen.

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

REST

So erstellen Sie einen Datenspeicher über die Befehlszeile und nehmen Daten aus Cloud Spanner auf:

  1. Erstellen Sie einen Datenspeicher.

    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/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores?dataStoreId=DATA_STORE_ID" \
-d '{
  "displayName": "DISPLAY_NAME",
  "industryVertical": "GENERIC",
  "solutionTypes": ["SOLUTION_TYPE_SEARCH"],
  "contentConfig": "CONTENT_REQUIRED",
}'

    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.
    • DISPLAY_NAME: Der Anzeigename des Datenspeichers. Dies wird möglicherweise in der Google Cloud Console angezeigt.

  2. Daten aus Cloud Spanner 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 '{
    "cloudSpannerSource": {
      "projectId": "SPANNER_PROJECT_ID",
      "instanceId": "INSTANCE_ID",
      "databaseId": "DATABASE_ID",
      "tableId": "TABLE_ID",
      "enableDataBoost": "DATA_BOOST_BOOLEAN"
    },
    "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.
    • SPANNER_PROJECT_ID: die ID Ihres Cloud Spanner-Projekts.
    • INSTANCE_ID: die ID Ihrer Cloud Spanner-Instanz.
    • DATABASE_ID: die ID Ihrer Cloud Spanner-Datenbank.
    • TABLE_ID: die ID Ihrer Cloud Spanner-Tabelle.
    • DATA_BOOST_BOOLEAN: optional. Ob Data Boost aktiviert werden soll. Informationen zu Data Boost finden Sie in der Cloud Spanner-Dokumentation unter Data Boost-Übersicht.
    • RECONCILIATION_MODE: optional. Mögliche Werte sind FULL und INCREMENTAL. Der Standardwert ist INCREMENTAL. Wenn Sie INCREMENTAL angeben, werden die Daten aus Cloud Spanner in Ihrem Datenspeicher inkrementell aktualisiert. Dadurch 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 synchronisiert. Das bedeutet, dass Ihrem Datenspeicher neue und aktualisierte Dokumente hinzugefügt und Dokumente, die nicht in Cloud Spanner enthalten sind, aus Ihrem Datenspeicher entfernt werden. Der FULL-Modus ist hilfreich, wenn Sie nicht mehr benötigte Dokumente 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 die Dokument-IDs auf Grundlage eines Nutzlast-Hash generiert. Beachten Sie, dass generierte Dokument-IDs bei mehreren Importvorgängen möglicherweise nicht gleich bleiben. Wenn Sie bei mehreren Importvorgängen IDs automatisch generieren, empfiehlt Google dringend, reconciliationMode auf FULL festzulegen, um die Dokument-IDs konsistent zu halten.

    • ID_FIELD: optional. Gibt an, welche Felder die Dokument-IDs enthalten.

Nächste Schritte

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

  • Weitere Informationen zur Vorschau der Suchergebnisse nach Erstellung der App und des Datenspeichers.