Kontextsets in Cloud SQL for PostgreSQL Studio verwalten

MySQL   |  PostgreSQL   |  SQL Server

Vorschau

Diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen und den Zusatzbedingungen für Vorschauprodukte auf Basis von generativer KI. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Informationen zum Zugriff auf diesen Release finden Sie auf der Seite Zugriffsanforderung.

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

Weitere Informationen zu Kontextgruppen finden Sie unter Kontextgruppen.

Hinweis

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

Erforderliche Dienste aktivieren

Aktivieren Sie die folgenden Dienste für Ihr Projekt:

• Data Analytics API with Gemini
• Gemini für die Google Cloud API
• Knowledge Catalog API

Cloud SQL-Instanz vorbereiten

Achten Sie darauf, dass Sie Zugriff auf eine vorhandene Cloud SQL-Instanz haben, oder erstellen Sie eine neue. Weitere Informationen finden Sie unter Instanzen für Cloud SQL erstellen.

Für dieses Tutorial benötigen Sie eine Datenbank in Ihrer Cloud SQL-Instanz. Weitere Informationen finden Sie unter Datenbank auf der Cloud SQL-Instanz erstellen.

Erforderliche Rollen und Berechtigungen

• Fügen Sie der Instanz einen IAM-Nutzer oder ein Dienstkonto hinzu. Weitere Informationen finden Sie unter Nutzer mit IAM-Datenbankauthentifizierung für Cloud SQL verwalten.
• Weisen Sie dem IAM-Nutzer auf Projektebene die Rollen cloudsql.studioUser, cloudsql.instanceUser und geminidataanalytics.queryDataUser zu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung für ein Projekt hinzufügen.
• Sie müssen einem IAM-Nutzer oder -Dienstkonto auch schreibgeschützte Datenbankberechtigungen erteilen. Melden Sie sich dazu als Nutzer mit Superuser-Berechtigungen an, z. B. als postgres-Nutzer.
  
  GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
  
  Ersetzen Sie USER_NAME durch die E-Mail-Adresse des Nutzers. Da die E-Mail-Adresse Sonderzeichen (@ und .) enthält, muss sie in Anführungszeichen gesetzt werden.
  
  Weitere Informationen finden Sie unter Einzelnen IAM-Nutzern oder Dienstkonten Datenbankberechtigungen erteilen.

executesql-Berechtigung für Cloud SQL-Instanz gewähren

Führen Sie den folgenden Befehl aus, um der Cloud SQL-Instanz die Berechtigung executesql zu gewähren und die Cloud SQL Data API zu aktivieren:

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

Ersetzen Sie Folgendes:

• PROJECT_ID: Die ID Ihres Google Cloud -Projekts.
• INSTANCE_ID: Die ID Ihrer Cloud SQL-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.

Kontextsatz erstellen

So erstellen Sie einen Kontextsatz:

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

   Zu Cloud SQL

2. Wählen Sie eine Instanz aus der Liste aus.

3. Klicken Sie im Navigationsmenü auf Cloud SQL 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 richtigen Schreibweise angegeben werden und kann Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten.

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

9. Klicken Sie auf Erstellen.

Hinweis :Das Erstellen des ersten Kontextsets in einem Projekt kann einige Minuten dauern.

Kontextsets erstellen

Nachdem Sie einen Kontextsatz erstellt haben, folgen Sie der Anleitung unter Kontexte mit der Gemini CLI erstellen, um eine Kontextsatzdatei zu erstellen. Anschließend können Sie Ihr Kontextset bearbeiten, um die Kontextset-Datei hochzuladen.

Kontextgruppe bearbeiten

So bearbeiten Sie einen Kontextsatz:

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

   Zu Cloud SQL

2. Wählen Sie eine Instanz aus der Liste aus.

3. Klicken Sie im Navigationsmenü auf Cloud SQL Studio.

4. Melden Sie sich mit der Identity and Access Management-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 „Cloud SQL“ auf.

   Zu Cloud SQL

2. Wählen Sie eine Instanz aus der Liste aus.

3. Klicken Sie im Navigationsmenü auf Cloud SQL Studio.

4. Melden Sie sich mit der Identity and Access Management-Authentifizierung in Studio an.

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

6. Klicken Sie auf Kontextgruppe 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.

Hinweis :Bevor Sie eine Datenbank löschen, müssen Sie alle Kontextgruppen löschen, die mit dieser Datenbank verknüpft sind.

Nächste Schritte

• Weitere Informationen zu Kontextsets
• Weitere Informationen zum Testen eines Kontextsets
• Informationen zum Erstellen von Kontexten mit der Gemini CLI