Mit AlloyDB for PostgreSQL verbinden

In diesem Dokument wird beschrieben, wie Sie einen Datenspeicher erstellen, der mit AlloyDB for PostgreSQL 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 AlloyDB for PostgreSQL-Daten über einen Gemini Enterprise-Datenspeicher herstellen möchten, können Sie einen der folgenden Modi verwenden:

• Föderierte Abfrage (empfohlen) [Vorabversion]: Stellen Sie eine Verbindung zu AlloyDB for PostgreSQL-Daten her, ohne dass Kosten für ausgehenden Traffic für das Kopieren und Verschieben der Daten anfallen. Bei der föderierten Abfrage wird Ihre Abfrage direkt an AlloyDB for PostgreSQL in allen Clustern, Datenbanken und Tabellen gesendet, auf die Ihre Identität eine Identity and Access Management-Berechtigung (IAM) hat. Dies ist für analytische Abfragen effizienter. Wenn Sie den Modus für föderierte Abfragen verwenden, wird Knowledge Catalog automatisch auf dem Tab Assistant 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.

  Achtung: Datenbankabfragen mit hoher Genauigkeit: Der Modus für föderierte Abfragen bietet umfassenden Zugriff auf alle Cluster und Datenbanken, auf die der Nutzer Zugriff hat. Die Genauigkeit der Abfragen kann jedoch bei komplexen transaktionalen Schemas variieren. Für Arbeitslasten, die eine hohe Genauigkeit, eine deterministische Tabellenauswahl und verifizierte Abfragen (Golden SQL) erfordern, erstellen Sie einen eingeschränkten Datenagenten in AlloyDB for PostgreSQL und veröffentlichen Sie ihn in Gemini Enterprise.

• Datenaufnahme: Kopieren Sie Daten aus einer bestimmten AlloyDB for PostgreSQL-Tabelle in den Gemini Enterprise-Datenspeicher. Daten müssen manuell aktualisiert werden, damit Änderungen in der AlloyDB for PostgreSQL-Tabelle berücksichtigt werden. In diesem Modus fallen Kosten für ausgehenden Traffic für das Verschieben von Daten an einen neuen Standort an. Vorhandene IAM-Berechtigungen werden nicht in den Datenspeicher kopiert.

Hinweis

Wenn Sie einen AlloyDB for PostgreSQL-Datenspeicher in Gemini Enterprise erstellen möchten, benötigen Sie die Rolle „Gemini Enterprise-Administrator“ (roles/discoveryengine.agentspaceAdmin) oder „Discovery Engine-Administrator“ (roles/discoveryengine.admin). Weitere Informationen finden Sie unter Berechtigungen für Administratoren 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:

• Fügen Sie alloydb dem Parameter allowedDataSources in der discoveryengine.managed.allowedDataSources verwalteten Einschränkung (Zulässige Datenquellen für Daten-Connectors einschränken) hinzu. Weitere Informationen finden Sie unter Übersicht über verwaltete Richtlinieneinschränkungen und Zulässige Datenquellen konfigurieren.

Konfigurieren Sie außerdem die erforderlichen AlloyDB for PostgreSQL-IAM Berechtigungen für den Connector-Modus, den Sie verwenden möchten:

Föderierte Abfrage

Vorabversion

Dieses Produkt oder Feature unterliegt den "Nutzungsbedingungen für Pre-GA-Angebote" 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ür föderierte Abfragen eine Verbindung zu AlloyDB for PostgreSQL herstellen möchten, 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 Ihren AlloyDB for PostgreSQL-Cluster enthält:

• Cluster- und Datenbankzugriff:
  • „Cloud AlloyDB Viewer“ (roles/alloydb.viewer) und „Cloud AlloyDB Client“ (roles/alloydb.client) (oder „Cloud AlloyDB Database User“ (roles/alloydb.databaseUser) mit IAM-Datenbankauthentifizierung) für Lesezugriff auf Abfragen und Tools.
  • „Cloud AlloyDB Admin“ (roles/alloydb.admin) wenn Schreib- oder Clusterverwaltungsaktionen (z. B. das Erstellen von Clustern, Instanzen oder Sicherungen oder das Ausführen von SQL-Schreibvorgängen) aktiviert sind.
• MCP-Tool-Zugriff:
  • Berechtigung „MCP Tool User“ (roles/mcp.toolUser) im Google Cloud Projekt, in dem sich der AlloyDB for PostgreSQL -Cluster befindet, um MCP-Tools aufzurufen.

Datenaufnahme

Wenn Sie Daten aus einem Quell Google Cloud projekt aufnehmen möchten, das sich von dem Google Cloud Projekt unterscheidet, das den Gemini Enterprise-Datenspeicher enthält, den Sie erstellen, gewähren Sie dem [e-mail] (wobei PROJECT_NUMBER die Projektnummer desGoogle Cloud Projekts ist, das den Gemini Enterprise-Datenspeicher enthält) die Rolle „Cloud AlloyDB Admin (roles/alloydb.admin)“ für das AlloyDB for PostgreSQL-Quellprojekt.

Achtung: Wenn Sie Daten aus AlloyDB for PostgreSQL in einen Gemini Enterprise-Datenspeicher aufnehmen, werden AlloyDB for PostgreSQL-Berechtigungen nicht mit den Daten importiert. Nach dem Import können alle Nutzer mit ausreichenden Gemini Enterprise-Berechtigungen die Daten ansehen, auch wenn sie keine Berechtigung haben, die Daten in AlloyDB for PostgreSQL anzusehen.

AlloyDB for PostgreSQL-Datenspeicher erstellen

So erstellen Sie einen Datenspeicher, der Daten aus AlloyDB for PostgreSQL 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 „AlloyDB for PostgreSQL“ oder suchen Sie in der Liste der Erstanbieter-Datenquellen nach AlloyDB for PostgreSQL. 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 Anweisungen basierend auf dem ausgewählten Modus zu erhalten.

   Föderierte Abfrage

   Vorabversion

   Dieses Produkt oder Feature unterliegt den "Nutzungsbedingungen für Pre-GA-Angebote" 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 AlloyDB for PostgreSQL-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 AlloyDB for PostgreSQL-Tabelle importieren Folgendes an:
      • Projekt-ID: Das Google Cloud Projekt, das die AlloyDB for PostgreSQL-Tabelle enthält. Dies ist ein Pflichtfeld.
      • Standort-ID: Die AlloyDB for PostgreSQL-Standort-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein Pflichtfeld.
      • Cluster-ID: Die AlloyDB for PostgreSQL-Cluster-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein Pflichtfeld.
      • Datenbank-ID: Die AlloyDB for PostgreSQL-Datenbank-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein Pflichtfeld.
      • Tabellen-ID: Die AlloyDB for PostgreSQL-Tabellen-ID, die die Daten enthält, die Sie importieren möchten. Dies ist ein Pflichtfeld.
   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, 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 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 AlloyDB for PostgreSQL-Nutzung an, wenn Nutzer Abfragen über die angehängte App ausführen. Im Modus für die Datenaufnahme fallen Kosten für die AlloyDB for PostgreSQL- und Gemini Enterprise-Indexierung 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 den Schritten unter Gemini Enterprise-App erstellen.

• Informationen zur Verwendung von Knowledge Catalog mit Data Cloud-Connectors (automatisch aktiviert, wenn Sie den Modus für föderierte Abfragen verwenden), damit der Agent nach Daten suchen kann, auf die der Nutzer Zugriff hat, und Kontextinformationen zur Organisation abrufen kann.

• Informationen zum Erstellen eines eingeschränkten Agenten mit hoher Genauigkeit und verifizierten Abfragen finden Sie unter AlloyDB for PostgreSQL-Datenagent in Gemini Enterprise veröffentlichen.