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 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:
Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Datenspeicher auf.
Rufen Sie die Seite Datenspeicher auf.
Klicken Sie auf den Namen des Zieldatenspeichers.
Sehen Sie sich auf der Datenspeicher-Detailseite die Datenspeicher-ID an, die im Header angezeigt wird.
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_entityAundDataConnector3_entityB) aufzurufen.
REST
So rufen Sie Datenspeicher- und Entitäts-IDs mit der REST API ab:
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:usfür die Multiregion „USA“eufür die Multiregion „EU“globalfür den Standort „Global“
LOCATION: Der multiregionale Standort Ihres Datenspeichers:global,usodereu.Listen Sie Entitäts- und eigenständige Datenspeicher-IDs unter
default_collectionauf: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 unterdefault_collectionregistriert und mit der Connector-ID als Präfix versehen.Rufen Sie den
dataStores-Listenendpunkt fürdefault_collectionauf, 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:usfür die Multiregion „USA“eufür die Multiregion „EU“globalfür den Standort „Global“
LOCATION: Der multiregionale Standort Ihres Datenspeichers:global,usodereu.
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.
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
- Präzise Zugriffssteuerung für Anwendungen und Datenspeicher konfigurieren
- Discovery Engine REST API-Referenz