Verbindung zu Cloud SQL herstellen

In diesem Dokument wird beschrieben, wie Sie einen Datenspeicher erstellen, der eine Verbindung zu Cloud SQL-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 SQL-Daten herstellen möchten, können Sie einen der folgenden Modi verwenden:

• Föderierte Abfrage (empfohlen) [Vorabversion]: Stellen Sie eine Verbindung zu Cloud SQL-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 Cloud SQL gesendet, und zwar über alle Instanzen, Datenbanken und Tabellen hinweg, für die Ihre Identität die IAM-Berechtigung (Identity and Access Management) hat. Das 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.

  Achtung: Datenbankabfragen mit hoher Genauigkeit: Der Modus für föderierte Abfragen bietet umfassenden Zugriff auf alle Instanzen und Datenbanken, auf die der Nutzer zugreifen kann. Die Genauigkeit der Abfragen kann jedoch bei komplexen Transaktionsschemas variieren. Für Arbeitslasten, die eine hohe Genauigkeit, deterministische Tabellenbereiche und verifizierte Abfragen (Golden SQL) erfordern, erstellen Sie einen bereichsbezogenen Daten-Agenten in Cloud SQL for MySQL oder Cloud SQL for PostgreSQL und veröffentlichen Sie ihn in Gemini Enterprise.

• Datenaufnahme: Daten aus einer bestimmten Cloud SQL-Tabelle in den Gemini Enterprise-Datenspeicher kopieren. Daten müssen manuell aktualisiert werden, damit Änderungen in der Cloud SQL-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

Wenn Sie einen Cloud SQL-Datenspeicher in Gemini Enterprise erstellen möchten, benötigen Sie die Rolle Gemini Enterprise Admin (roles/discoveryengine.agentspaceAdmin) oder Discovery Engine Admin (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 cloudsql dem Parameter allowedDataSources in der verwalteten Beschränkung discoveryengine.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.

Erfüllen Sie außerdem die Voraussetzungen und konfigurieren Sie die erforderlichen Cloud SQL-IAM-Berechtigungen für den Connector-Modus, den Sie verwenden möchten:

Föderierte Abfrage

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Wenn Sie im Modus Föderierte Abfrage eine Verbindung zu Cloud SQL herstellen möchten, müssen Sie die folgenden Voraussetzungen im Projekt Google Cloud erfüllen, das Ihre Cloud SQL-Instanz enthält:

1. Aktivieren Sie die Data API auf Ihrer Cloud SQL-Instanz:

   gcloud sql instances patch <var>INSTANCE_NAME</var> \
       --project=<var>PROJECT_ID</var> \
       --data-api-access=ALLOW_DATA_API
   

2. IAM-Berechtigungen gewähren: Gewähren Sie Nutzern, die über den Connector Abfragen ausführen oder Aktionen ausführen, die folgenden IAM-Rollen im Projekt Google Cloud , das Ihre Cloud SQL-Instanz enthält:

   • Instanz- und Datenbankzugriff:
     • Cloud SQL-Betrachter (roles/cloudsql.viewer) und Cloud SQL-Client (roles/cloudsql.client) (oder Cloud SQL-Instanznutzer (roles/cloudsql.instanceUser) mit IAM-Datenbankauthentifizierung) für Lesezugriff-Abfragen und Tools.
     • Cloud SQL-Bearbeiter (roles/cloudsql.editor) oder Cloud SQL-Administrator (roles/cloudsql.admin), wenn Schreib- oder Verwaltungsaktionen aktiviert sind.
   • Zugriff auf MCP-Tools:
     • MCP Tool User (roles/mcp.toolUser)-Berechtigung in dem Projekt, in dem sich die Cloud SQL-Instanz befindet, um MCP-Tools aufzurufen.

Datenaufnahme

Wenn Sie Daten aus Cloud SQL aufnehmen möchten, konfigurieren Sie die folgenden IAM-Berechtigungen:

• Staging-Bucket-Zugriff: Beim Aufnehmen von Daten aus Cloud SQL werden die Daten zuerst in einem Cloud Storage-Bucket bereitgestellt. Weisen Sie dem Dienstkonto Ihrer Cloud SQL-Instanz (z. B. [e-mail]) die Rolle Storage-Administrator (roles/storage.admin) für den Cloud Storage-Bucket-Zwischenbucket zu.
• Projektübergreifender Cloud SQL-Zugriff: Wenn Sie Daten aus einem Quellprojekt ( Google Cloud ) importieren, das sich von dem Projekt ( Google Cloud ) unterscheidet, das den von Ihnen erstellten Gemini Enterprise-Datenspeicher enthält, weisen Sie dem Dienstkonto [e-mail] die Rolle Cloud SQL-Betrachter (roles/cloudsql.viewer) für das Cloud SQL-Quellprojekt zu. Dabei ist PROJECT_NUMBER die Projektnummer des Projekts (Google Cloud ), das den Gemini Enterprise-Datenspeicher enthält.

Achtung: Wenn Sie Daten aus Cloud SQL in einen Gemini Enterprise-Datenspeicher aufnehmen, werden die Cloud SQL-Berechtigungen nicht mit den Daten importiert. Nach dem Import können alle Nutzer mit ausreichenden Gemini Enterprise-Berechtigungen die Daten sehen, auch wenn sie keine Berechtigung zum Aufrufen der Daten in Cloud SQL haben.

Cloud SQL-Datenspeicher erstellen

So erstellen Sie einen Datenspeicher, der Daten aus Cloud SQL mit Gemini Enterprise verbindet:

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 Quelle eine Datenquelle für Ihren Datenspeicher aus. Suchen Sie im Suchfeld Datenquelle auswählen nach „Cloud SQL“ oder suchen Sie in der Liste der Erstanbieter-Datenquellen nach Cloud SQL. Wählen Sie Datenquelle hinzufügen aus.

5. 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

   Vorschau

   Dieses Produkt oder diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

   1. Wählen Sie Föderierte Abfrage (empfohlen) aus. Klicken Sie auf Weiter.
   2. Wählen Sie auf der Seite Aktionen die Cloud SQL-Aktionen aus, die Sie für Ihren Datenspeicher aktivieren möchten. Sie können diese Einstellungen später bearbeiten. Klicken Sie auf Weiter.

   Datenaufnahme

   1. Wählen Sie Datenaufnahme aus.
   2. Geben Sie Details zu den Daten an, die Sie importieren möchten. Geben Sie unter Daten aus Ihrer Cloud SQL-Tabelle importieren die folgenden Informationen an:
      • Projekt-ID: Das Google Cloud -Projekt, das die Cloud SQL-Tabelle enthält. Dies ist ein erforderliches Feld.
      • Instanz-ID: Die Cloud SQL-Instanz-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein erforderliches Feld.
      • Datenbank-ID: Die Cloud SQL-Datenbank-ID, die die zu importierenden Daten enthält. Dies ist ein erforderliches Feld.
      • Tabellen-ID: Die Cloud SQL-Tabellen-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein erforderliches Feld.
      • Geben Sie den Speicherort des Google Cloud Storage-Bucket für die Daten ein. Dies ist ein Pflichtfeld. Optional können Sie Serverlosen Export aktivieren auswählen, um den serverlosen Cloud SQL-Export zu verwenden. Durch das Aktivieren des serverlosen Exports fallen zusätzliche Kosten an. Preise für serverlose Exporte über Cloud SQL
   3. Klicken Sie auf Weiter.

6. 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.

7. 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 für Abfragen Cloud SQL-Nutzungskosten an, wenn Nutzer Abfragen über die angehängte App ausführen. Im Datenaufnahmemodus fallen für den Import von Daten Cloud SQL-, Cloud Storage- 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 Cloud SQL for MySQL-Daten-Agent in Gemini Enterprise veröffentlichen oder Cloud SQL for PostgreSQL-Daten-Agent in Gemini Enterprise veröffentlichen.