Kontextsets in AlloyDB Studio verwalten

In diesem Dokument wird beschrieben, wie Sie Kontextsets in AlloyDB for PostgreSQL Studio mithilfe einer Kontextset-Datei erstellen. Kontextsatznamen müssen innerhalb einer Datenbank eindeutig sein.

Weitere Informationen zu Kontextsets finden Sie unter Kontextsets – Übersicht.

Hinweis

Erfüllen Sie die folgenden Voraussetzungen, bevor Sie einen Agent erstellen.

Erforderliche Dienste aktivieren

Aktivieren Sie die folgenden Dienste für Ihr Projekt:

AlloyDB for PostgreSQL-Cluster, ‑Instanz und ‑Datenbank vorbereiten

Sie benötigen Zugriff auf einen vorhandenen AlloyDB-Cluster und eine vorhandene AlloyDB-Instanz. Erstellen Sie einen neuen Cluster und eine neue Instanz, falls Sie noch keinen haben.
Für diese Anleitung benötigen Sie eine Datenbank in Ihrer AlloyDB-Instanz. Weitere Informationen finden Sie unter Datenbank erstellen.

Erforderliche Rollen und Berechtigungen

  • Fügen Sie dem Cluster auf Datenbankebene einen Identity and Access Management-Nutzer (IAM) oder ein Dienstkonto hinzu. Weitere Informationen finden Sie unter Datenbanknutzer verwalten.
  • Weisen Sie dem IAM-Nutzer auf Projektebene die Rollen alloydb.databaseUser, serviceusage.serviceUsageConsumer und geminidataanalytics.queryDataUser zu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung für ein Projekt hinzufügen.
  • Wenn Sie Kontextsets erstellen, hochladen und verwalten möchten, weisen Sie dem IAM-Nutzer auf Projektebene die Rolle „Dataplex Catalog Editor“ (roles/dataplex.catalogEditor) oder „Dataplex Catalog Admin“ (roles/dataplex.catalogAdmin) zu. Weitere Informationen finden Sie unter Berechtigungen für Kontextsets.

executesql-Berechtigung für die AlloyDB for PostgreSQL-Instanz erteilen

Verwenden Sie den folgenden curl-Befehl, um der AlloyDB for PostgreSQL-Instanz die Berechtigung executesql zu gewähren und die Instanzeinstellung data_api_access auf den Wert ALLOW_DATA_API festzulegen: 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
Ersetzen Sie Folgendes:
  • PROJECT_ID: Die ID Ihres Google Cloud -Projekts.
  • LOCATION: Die Region, in der sich Ihr AlloyDB-Cluster befindet.
  • CLUSTER_ID: Die ID Ihres AlloyDB-Clusters.
  • INSTANCE_ID: Die ID Ihrer AlloyDB-Instanz.
Melden Sie sich an, um die Schritte in dieser Anleitung auszuführen Google Cloud und authentifizieren Sie sich dann mit der IAM-Authentifizierung bei der Datenbank.

Kontextset erstellen

So erstellen Sie einen Kontextsatz:

  1. Rufen Sie in der Google Cloud Console die Seite „AlloyDB“ auf.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Melden Sie sich mit der IAM-Authentifizierung in Studio an.

  5. Klicken Sie im Explorer-Bereich neben Kontextsets auf Aktionen ansehen.

  6. Klicken Sie auf Kontextgruppe erstellen.

  7. Geben Sie unter Name des Kontextsets einen eindeutigen Namen für das Kontextset ein. Der Name des Kontextsets muss in der Groß-/Kleinschreibung beachtet werden und darf Buchstaben, Ziffern, Bindestriche und Unterstriche enthalten.

  8. Optional. Fügen Sie unter Beschreibung des Kontextsets eine Beschreibung für das Kontextset hinzu.

  9. Klicken Sie auf Erstellen.

Kontextsets erstellen

Nachdem Sie ein Kontextset erstellt haben, folgen Sie der Anleitung unter Kontexte mit der Gemini CLI erstellen, um eine Kontextset-Datei zu erstellen. Sie können dann Ihr Kontextset bearbeiten, um die Kontextset-Datei hochzuladen.

Kontextset bearbeiten

So bearbeiten Sie einen Kontextsatz:

  1. Rufen Sie in der Google Cloud Console die Seite „AlloyDB“ auf.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Melden Sie sich mit der IAM-Authentifizierung in Studio an.

  5. Klicken Sie im Explorer-Bereich neben Kontextsets auf Aktionen ansehen.

  6. Klicken Sie auf Kontextgruppe bearbeiten.

  7. Optional. Bearbeiten Sie die Beschreibung des Kontextsets.

  8. Klicken Sie im Bereich Kontextset-Datei hochladen auf Durchsuchen und wählen Sie die Kontextset-Datei aus.

  9. Klicken Sie auf Speichern.

Kontextset löschen

So löschen Sie einen Kontextsatz:

  1. Rufen Sie in der Google Cloud Console die Seite „AlloyDB“ auf.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Melden Sie sich mit der IAM-Authentifizierung in Studio an.

  5. Klicken Sie im Explorer-Bereich neben Kontextsets auf Aktionen ansehen.

  6. Klicken Sie auf Kontextset löschen.

  7. Geben Sie im Bestätigungsdialogfeld Kontextgruppe löschen den Namen der Kontextgruppe ein.

  8. Klicken Sie auf Bestätigen, um den Kontextsatz zu löschen.

Nächste Schritte