Details zu Datenspeichern und Entitäten abrufen

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

Wenn Sie über APIs mit Datenspeichern interagieren, z. B. um IAM-Zugriffssteuerungen auf Ressourcenebene zu konfigurieren, Such-Endpunkte abzufragen oder Aufnahmepipelines zu automatisieren, benötigen Sie die eindeutigen Ressourcen-IDs der Zieldatenspeicher und der zugehörigen 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 werden. Eigenständige Datenspeicher gehören zur Standardkollektion (default_collection). Weitere Informationen finden Sie unter Gemini Enterprise-Konzepte und Apps und Datenspeicher.
Datenerhebung Eine logische Gruppierungsressource innerhalb eines Google Cloud -Projekts und an einem Standortprojects/{project}/locations/{location}/collections/{collection}.

Bei Drittanbieter-Datenspeichern mit mehreren Entitäten (z. B. Jira, Salesforce oder SharePoint Online) wird eine eigene Sammlung erstellt, die die Datenspeicherinstanz darstellt.
Datenspeicher-Entität Wenn Sie eine Drittanbieter-Datenquelle verbinden, die mehrere Entitätstypen enthält (z. B. Jira-Vorgänge, Jira-Projekte oder SharePoint-Dateien), erstellt Gemini Enterprise automatisch einen separaten untergeordneten Datenspeicher für jeden Entitätstyp.

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 Datenspeichern und Entitäten 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 in der Kopfzeile 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 entsprechenden Datenspeicher-IDs für Entitäten (z. B. DataConnector3_entityA und DataConnector3_entityB) aufzurufen.

REST

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

  1. Datenspeicher-Sammlungs-IDs 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 spezielle Sammlung, die die Connector-Instanz darstellt. Rufen Sie den Endpunkt collections list 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.

  3. 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. Auch wenn ein Datenspeicher mit mehreren Entitäten eine eigene Sammlungs-ID hat (z. B. DataConnector3), werden seine untergeordneten Entitätsdatenspeicher unter default_collection registriert und mit der Connector-ID versehen.

    Rufen Sie den Listenendpunkt dataStores unter default_collection auf, um die IDs Ihres Datenspeichers und Ihrer Entitäten 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.
  4. LOCATION: Der multiregionale Standort Ihres Datenspeichers: global, us oder eu.

    5. 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 sind die IDs der Entitätsdatenspeicher DataConnector3_entityA und DataConnector3_entityB. Verwenden Sie diese IDs, wenn Sie mit der REST API die Zugriffssteuerung für alle zugrunde liegenden Entitätsdatenspeicher eines Datenspeichers mit mehreren Entitäten konfigurieren.

Nächste Schritte