Details zu Datenspeichern und Entitäten abrufen

Auf dieser Seite wird beschrieben, wie Sie Ressourcendetails für Gemini Enterprise-Datenspeicher und die zugrunde liegenden Entitäten entweder über die Google Cloud Console oder die Discovery Engine REST API abrufen.

Wenn Sie über APIs mit Datenspeichern interagieren, z. B. beim Konfigurieren von IAM-Zugriffssteuerungen auf Ressourcenebene, beim Abfragen von Suchendpunkten oder beim Automatisieren von Aufnahmepipelines, benötigen Sie die eindeutigen Ressourcen-IDs der Zieldatenspeicher und ihrer zugrunde liegenden Entitäten.

Datenspeicherkonzepte

Die folgenden Konzepte helfen Ihnen, die Struktur von Datenspeicherressourcen in der Discovery Engine API zu verstehen:

Konzept Beschreibung
Datenspeicher Ein Container für Daten, die aus Google- oder Drittanbieter-Datenquellen aufgenommen wurden. Eigenständige Datenspeicher gehören zur Standardsammlung (default_collection). Weitere Informationen finden Sie unter Gemini Enterprise-Konzepte und Apps und Datenspeicher.
Datenerhebung Eine logische Gruppierungsressource innerhalb eines Google Cloud -Projekts und -Standorts (projects/{project}/locations/{location}/collections/{collection}).

Für Drittanbieter-Datenspeicher mit mehreren Entitäten (z. B. Jira, Salesforce oder SharePoint Online) wird eine dedizierte Sammlung erstellt, die die Datenspeicherinstanz darstellt.

Datenspeicherentität Wenn Sie eine Drittanbieter-Datenquelle verbinden, die mehrere Entitätstypen enthält (z. B. Jira-Tickets, Jira-Projekte oder SharePoint-Dateien), erstellt Gemini Enterprise automatisch für jeden Entitätstyp einen separaten untergeordneten Datenspeicher.

Diese Entitätsdatenspeicher befinden sich als untergeordnete Ressourcen unter collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID}.

Weitere Informationen finden Sie unter Strukturierte Daten für Drittanbieter-Datenspeicher und Einführung in Connectors und Datenspeicher.

Details zu Datenspeicher und Entität abrufen

Wählen Sie eine der folgenden Optionen aus:

Console

So rufen Sie Datenspeicher- und Entitätsdetails in der Google Cloud Console ab:

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

    Rufen Sie die Seite Datenspeicher auf.

  2. Klicken Sie auf den Namen des Zieldatenspeichers.

  3. Sehen Sie sich auf der Datenspeicher-Detailseite die Datenspeicher-ID an, die im Header angezeigt wird.

  4. Wenn der Datenspeicher Entitäten enthält, klicken Sie auf den Tab Entitäten, um die Liste der konfigurierten Entitäten, Anzeigenamen und die entsprechenden Entitäts-Datenspeicher-IDs (z. B. DataConnector3_entityA und DataConnector3_entityB) aufzurufen.

REST

So rufen Sie Datenspeicher- und Entitäts-IDs mit der REST API ab:

  1. IDs der Datenspeichersammlung auflisten (für Datenspeicher mit mehreren Entitäten):

    Für Drittanbieter-Datenspeicher mit mehreren Entitäten (z. B. Jira oder Salesforce) erstellt Gemini Enterprise eine dedizierte Sammlung, die die Connector-Instanz darstellt. Rufen Sie den Endpunkt der collections-Liste auf, um Sammlungs-IDs in Ihrem Projekt abzurufen:

    curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die ID IhresGoogle Cloud -Projekts.
    • ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
    • us für die Multiregion „USA“
    • eu für die Multiregion „EU“
    • global für den Standort „Global“
    Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  2. LOCATION: Der multiregionale Standort Ihres Datenspeichers: global, us oder eu.
  3. Die Antwort enthält die Liste der Sammlungen:

    {
      "collections": [
        {
          "name": "projects/123456789/locations/global/collections/DataConnector3",
          "displayName": "Jira Production Data Store"
        }
      ]
    }
    

    In diesem Beispiel lautet die Sammlungs-ID DataConnector3. Verwenden Sie diese ID, wenn Sie Zugriffssteuerungen auf Sammlungsebene für die Connector-Instanz konfigurieren.

  4. Listen Sie Entitäts- und eigenständige Datenspeicher-IDs unter default_collection auf:

    In Gemini Enterprise befinden sich alle Datenspeicherressourcen, einschließlich eigenständiger Datenspeicher und untergeordneter Entitäten für Connectors mit mehreren Entitäten, unter default_collection. Obwohl ein Datenspeicher mit mehreren Entitäten eine dedizierte Sammlungs-ID (z. B. DataConnector3) hat, werden seine untergeordneten Entitätsdatenspeicher unter default_collection registriert und mit der Connector-ID als Präfix versehen.

    Rufen Sie den dataStores-Listenendpunkt für default_collection auf, um die IDs Ihres Datenspeichers und Ihrer Entität zu finden:

    curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores"
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die ID IhresGoogle Cloud -Projekts.
    • ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
    • us für die Multiregion „USA“
    • eu für die Multiregion „EU“
    • global für den Standort „Global“
    Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  5. LOCATION: Der multiregionale Standort Ihres Datenspeichers: global, us oder eu.
  6. Die Antwort enthält die Liste der Datenspeicher:

    {
      "dataStores": [
        {
          "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityA",
          "displayName": "Jira Issues Entity"
        },
        {
          "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityB",
          "displayName": "Jira Projects Entity"
        }
      ]
    }
    

    In diesem Beispiel lauten die IDs der Entitätsdatenspeicher DataConnector3_entityA und DataConnector3_entityB. Verwenden Sie diese IDs, wenn Sie Zugriffssteuerungen für alle zugrunde liegenden Entitätsdatenspeicher eines Datenspeichers mit mehreren Entitäten über die REST API konfigurieren.

Nächste Schritte