In diesem Dokument wird beschrieben, wie Sie einen Datenspeicher erstellen, der eine Verbindung zu Cloud Spanner-Daten herstellt. Sie können diesen Datenspeicher mit einer Gemini Enterprise App verknüpfen, damit die Agenten Ihre Daten analysieren können.
Wenn Sie über einen Gemini Enterprise-Datenspeicher eine Verbindung zu Cloud Spanner-Daten herstellen möchten, können Sie einen der folgenden Modi verwenden:
Föderierte Abfrage (empfohlen) [Vorabversion]: Stellen Sie eine Verbindung zu Spanner-Daten her, ohne dass Kosten für ausgehenden Traffic für das Kopieren und Verschieben der Daten anfallen. Bei einer föderierten Abfrage wird Ihre Abfrage direkt an Spanner über alle Datenbanken und Tabellen gesendet, auf die Ihre Identität über die IAM-Berechtigung (Identity and Access Management) zugreifen darf. Dies ist für analytische Abfragen effizienter. Wenn Sie den Modus für föderierte Abfragen verwenden, wird Knowledge Catalog automatisch auf dem Tab Assistent Ihrer Gemini Enterprise-App aktiviert. So erhält der Agent Tools, mit denen er nach Daten suchen kann, auf die der Nutzer Zugriff hat, und Kontext abrufen kann.
Datenaufnahme: Daten aus einer bestimmten Spanner-Tabelle in den Gemini Enterprise-Datenspeicher kopieren. Die Daten müssen manuell aktualisiert werden, damit Änderungen in der Spanner-Tabelle berücksichtigt werden. In diesem Modus fallen Kosten für ausgehenden Traffic an, wenn Daten an einen neuen Speicherort verschoben werden. Vorhandene IAM-Berechtigungen werden nicht in den Datenspeicher repliziert.
Hinweis
Zum Erstellen eines Spanner-Datenspeichers in Gemini Enterprise benötigen Sie die Rolle Gemini Enterprise-Administrator (roles/discoveryengine.agentspaceAdmin) oder Discovery Engine-Administrator (roles/discoveryengine.admin). Weitere Informationen finden Sie unter Administratoren Berechtigungen gewähren.
Wenn Ihr Projekt durch einen VPC Service Controls-Perimeter geschützt ist oder die Durchsetzung von Organisationsrichtlinien aktiviert ist, muss der Connector in Ihrer Organisationsrichtlinie zulässig sein:
- Fügen Sie
spannerdem ParameterallowedDataSourcesin der verwalteten Beschränkungdiscoveryengine.managed.allowedDataSources(Zulässige Datenquellen für Daten-Connectors einschränken) hinzu. Weitere Informationen finden Sie unter Übersicht über Einschränkungen für verwaltete Richtlinien und Zulässige Datenquellen konfigurieren.
Konfigurieren Sie außerdem die erforderlichen Spanner-IAM-Berechtigungen für den Connector-Modus, den Sie verwenden möchten:
Föderierte Abfrage
Wenn Sie im Modus Föderierte Abfrage eine Verbindung zu Spanner herstellen möchten, weisen Sie Nutzern, die über den Connector im ProjektGoogle Cloud , das Ihre Spanner-Datenbank enthält, Abfragen oder Aktionen ausführen, die folgenden IAM-Rollen zu:
- Datenbankzugriff:
- Cloud Spanner-Datenbank-Leser (
roles/spanner.databaseReader) für Abfragen mit Lesezugriff und Tools. - Cloud Spanner-Datenbank-Nutzer (
roles/spanner.databaseUser) oder Cloud Spanner-Datenbank-Administrator (roles/spanner.databaseAdmin), wenn Schreib- oder DDL-Aktionen aktiviert sind.
- Cloud Spanner-Datenbank-Leser (
- Zugriff auf MCP-Tools:
- MCP-Tool-Nutzer (
roles/mcp.toolUser) in dem Projekt, in dem sich die Spanner-Datenbank befindet, um Spanner-MCP-Tools aufzurufen.
- MCP-Tool-Nutzer (
Datenaufnahme
Wenn Sie Daten aus einem Google Cloud -Quellprojekt aufnehmen möchten, das sich vom Google Cloud -Projekt unterscheidet, das den von Ihnen erstellten Gemini Enterprise-Datenspeicher enthält, weisen Sie dem Dienstkonto service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com eine der folgenden IAM-Rollen für das Spanner-Quellprojekt zu (wobei PROJECT_NUMBER die Projektnummer desGoogle Cloud -Projekts ist, das den Gemini Enterprise-Datenspeicher enthält):
- Ohne Data Boost:
Cloud Spanner-Datenbankleser (
roles/spanner.databaseReader) - Mit Data Boost:
Cloud Spanner Database Admin (
roles/spanner.databaseAdmin) oder eine benutzerdefinierte Rolle mit den Berechtigungen von Cloud Spanner Database Reader undspanner.databases.useDataBoost. Weitere Informationen finden Sie unter Data Boost-Übersicht.
Cloud Spanner-Datenspeicher erstellen
So erstellen Sie einen Datenspeicher, der Daten aus Cloud Spanner mit Gemini Enterprise verbindet:
Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.
Rufen Sie die Seite Datenspeicher auf.
Klicken Sie auf Datenspeicher erstellen.
Wählen Sie auf der Seite Quelle eine Datenquelle für Ihren Datenspeicher aus. Suchen Sie im Suchfeld Datenquelle auswählen nach „Spanner“ oder suchen Sie Spanner in der Liste der Erstanbieter-Datenquellen. Wählen Sie Datenquelle hinzufügen aus.
Wählen Sie auf der Seite Daten den Connector-Modus für die Verbindung mit Ihren Daten aus. Wählen Sie einen der folgenden Tabs aus, um weitere Anleitungen für den ausgewählten Modus zu erhalten.
Föderierte Abfrage
Datenaufnahme
- Wählen Sie Datenaufnahme aus.
Geben Sie Details zu den Daten an, die Sie importieren möchten. Geben Sie unter Daten aus der Cloud Spanner-Tabelle importieren die folgenden Informationen an:
- Projekt-ID: Das Google Cloud -Projekt, das die Spanner-Tabelle enthält. Dies ist ein erforderliches Feld.
- Instanz-ID: Die Spanner-Instanz-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein erforderliches Feld.
- Datenbank-ID: Die Spanner-Datenbank-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein erforderliches Feld.
- Tabellen-ID: Die Spanner-Tabellen-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein erforderliches Feld.
Optional können Sie Data Boost aktivieren auswählen, um Spanner Data Boost für schnellere Abfragen zu verwenden. Durch das Aktivieren von Data Boost fallen zusätzliche Kosten an. Weitere Informationen finden Sie unter Preise für Cloud Spanner Data Boost.
Klicken Sie auf Weiter.
Konfigurieren Sie auf der Seite Konfiguration die Einstellungen für Ihren Datenspeicher.
- Standort des Daten-Connectors: Wählen Sie eine Region aus, in der die Metadaten Ihres Datenspeichers gespeichert werden sollen. Sie können den Standort nach dem Erstellen des Datenspeichers nicht mehr ändern. Wichtige Informationen zu multiregionalen Standorten finden Sie unter Gemini Enterprise-Standorte.
- Name des Daten-Connectors: Geben Sie im Feld Name des Daten-Connectors einen Namen für den Daten-Connector ein. Sie können den Namen nach dem Erstellen des Daten-Connectors nicht mehr ändern. Wenn Sie einen Namen eingeben, wird eine eindeutige ID für Ihren Daten-Connector generiert. Optional können Sie im Feld Tag (optional) ein Tag für Ihren Daten-Connector eingeben, das als stabile Kennung für den Connector über alle Versionen hinweg dient.
- Sensitive Data Protection-Richtlinie: Wählen Sie eine Sensitive Data Protection-Richtlinie für Ihren Datenspeicher aus. Das Format sollte so aussehen:
projects/{project}/locations/{location}/contentPolicies/{policy}. Sie können diese Einstellung später bearbeiten.
Klicken Sie auf Erstellen.
Jetzt können Sie Ihren Datenspeicher an eine Gemini Enterprise-App anhängen. Im Modus für föderierte Abfragen fallen bei Abfragen Spanner-Nutzungskosten an, wenn Nutzer Abfragen über die angehängte App ausführen. Im Datenaufnahmemodus fallen beim Importieren von Daten Spanner- und Gemini Enterprise-Indexierungskosten an, noch bevor der Datenspeicher an eine App angehängt wird. Weitere Informationen zu diesen Kosten finden Sie unter Gemini Enterprise-Preise.
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 Gemini Enterprise-App erstellen.
So funktioniert Knowledge Catalog mit Data Cloud-Connectors (wird automatisch aktiviert, wenn Sie den föderierten Abfragemodus verwenden), damit der Agent nach Daten suchen kann, auf die der Nutzer Zugriff hat, und organisatorischen Kontext abrufen kann.
Informationen zum Erstellen eines hochpräzisen, eingeschränkten KI-Agenten mit verifizierten Abfragen finden Sie unter KI-Datenagenten für Spanner in Gemini Enterprise veröffentlichen.