Verbindung zu Cloud SQL herstellen

In diesem Dokument wird beschrieben, wie Sie einen Datenspeicher erstellen, der mit Cloud SQL Daten verbunden ist. Sie können diesen Datenspeicher mit einer Gemini Enterprise-App verknüpfen, damit die Agenten Ihre Daten analysieren können.

Wenn Sie eine Verbindung zu Cloud SQL-Daten über einen Gemini Enterprise-Datenspeicher herstellen möchten, können Sie einen der folgenden Modi verwenden:

  • Föderierte Abfrage (empfohlen) [Vorschau]: Stellen Sie eine Verbindung zu Cloud SQL-Daten her, ohne dass Kosten für ausgehenden Traffic anfallen für das Kopieren und Verschieben der Daten. Bei der föderierten Abfrage wird Ihre Abfrage direkt an Cloud SQL für alle Instanzen, Datenbanken und Tabellen gesendet, für die Ihre Identität die IAM-Berechtigung (Identity and Access Management) hat. Das ist effizienter für analytische Abfragen. Wenn Sie den Modus für föderierte Abfragen verwenden, Knowledge Catalog wird Knowledge Catalog automatisch auf dem Tab Assistent Ihrer Gemini Enterprise-App aktiviert. So erhalten die Agenten Tools, mit denen sie nach Daten suchen können, auf die der Nutzer Zugriff hat, und Kontextinformationen abrufen können.

  • Datenaufnahme: Kopieren Sie Daten aus einer bestimmten Cloud SQL-Tabelle in den Gemini Enterprise-Datenspeicher. Die Daten müssen manuell aktualisiert werden, damit Änderungen in der Cloud SQL-Tabelle berücksichtigt werden. Bei diesem Modus fallen Kosten für ausgehenden Traffic für das Verschieben von Daten an einen neuen Speicherort an. 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-Administrator“ (roles/discoveryengine.agentspaceAdmin) oder die Rolle „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 Erzwingung von Organisationsrichtlinien aktiviert ist, muss Ihre Organisationsrichtlinie den Connector zulassen:

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

Wenn Sie den Modus für föderierte Abfragen verwenden möchten, um eine Verbindung zu Cloud SQL herzustellen, müssen Sie die folgenden Voraussetzungen im Google Cloud Projekt erfüllen, das Ihre Cloud SQL Instanz enthält:

  1. Data API für Ihre Cloud SQL-Instanz aktivieren:

    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 den Nutzern, die Abfragen ausführen oder Aktionen über den Connector ausführen, die folgenden IAM-Rollen im Google Cloud Projekt, das Ihre Cloud SQL-Instanz enthält:

Datenaufnahme

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

  • Zugriff auf Staging-Bucket: Beim Aufnehmen von Daten aus Cloud SQL, werden die Daten zuerst in einem Cloud Storage-Bucket bereitgestellt. Gewähren Sie dem Dienstkonto Ihrer Cloud SQL-Instanz (z. B. p9876-abcd33f@gcp-sa-cloud-sql.) die Rolle „Storage-Administrator“ (roles/storage.admin)für den Cloud Storage-Zwischen-Bucket.
  • Cloud SQL-Zugriff über Projekte hinweg: Wenn Sie Daten aus einem Quell Google Cloud projekt importieren, das sich von dem Google Cloud Projekt unterscheidet, das den Gemini Enterprise-Datenspeicher enthält, den Sie erstellen, gewähren Sie dem Dienstkonto service-PROJECT_NUMBER@gcp-sa-discoveryengine. die Rolle „Cloud SQL-Betrachter (roles/cloudsql.viewer)“ für das Cloud SQL-Quellprojekt. Dabei ist PROJECT_NUMBERdie Projektnummer des Google Cloud Projekts, das den Gemini Enterprise-Datenspeicher enthält.

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 zu Ihren Daten aus. Wählen Sie einen der folgenden Tabs aus, um weitere Anleitungen basierend auf dem ausgewählten Modus zu erhalten.

    Föderierte Abfrage

    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 Pflichtfeld.
      • Instanz-ID: Die Cloud SQL-Instanz-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein Pflichtfeld.
      • Datenbank-ID: Die Cloud SQL-Datenbank-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein Pflichtfeld.
      • Tabellen-ID: Die Cloud SQL-Tabellen-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein Pflichtfeld.
      • 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 Export von Cloud SQL zu verwenden. Wenn Sie den serverlosen Export aktivieren, fallen zusätzliche Kosten an. Weitere Informationen finden Sie unter Preise für den serverlosen Export von 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. Der Standort kann nach dem Erstellen des Datenspeichers nicht mehr geändert werden. 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. Der Name kann nach dem Erstellen des Daten-Connectors nicht mehr geändert werden. Wenn Sie einen Namen eingeben, wird eine eindeutige ID für den Daten-Connector generiert. Optional können Sie im Feld Tag (optional) ein Tag für den Daten-Connector eingeben. Dieses dient als stabile Kennung für den Connector über alle Versionen hinweg.
    • Sensitive Data Protection-Richtlinie: Wählen Sie eine Sensitive Data Protection-Richtlinie für Ihren Datenspeicher aus. Das Format muss 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 Kosten für die Cloud SQL-Nutzung an, wenn Nutzer Abfragen über die angehängte App ausführen. Im Modus für die Datenaufnahme fallen Kosten für die Cloud SQL-, Cloud Storage- und Gemini Enterprise-Indexierung an, auch bevor der Datenspeicher an eine App angehängt wird. Weitere Informationen zu diesen Kosten finden Sie unter Gemini Enterprise-Preise.

Nächste Schritte