Kontextsets in Cloud SQL Studio verwalten

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.

In diesem Dokument wird beschrieben, wie Sie in Cloud SQL for MySQL Studio Kontextgruppen mithilfe einer Kontextgruppendatei erstellen. Kontextsatznamen müssen innerhalb eines Projekts eindeutig sein.

Weitere Informationen zu Kontextgruppen finden Sie unter Kontextgruppen – Ü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:

• Data Analytics API with Gemini
• Gemini for 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.
• Erstellen Sie in Ihrer Instanz eine Datenbank, in der Sie die Tabellen erstellen. Weitere Informationen finden Sie unter Datenbank auf der Cloud SQL-Instanz erstellen.

Erforderliche Rollen und Berechtigungen

• Aktivieren Sie die IAM-Datenbankauthentifizierung auf der Instanz, indem Sie das Datenbank-Flag cloudsql_iam_authentication auf on (cloudsql_iam_authentication=on) setzen. Weitere Informationen finden Sie unter Vorhandene Instanzen für die IAM-Datenbankauthentifizierung konfigurieren.
• Fügen Sie einen IAM-Nutzer oder ein Dienstkonto auf Instanzebene hinzu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung zu Nutzern, Dienstkonten oder Gruppen hinzufügen.
• Weisen Sie dem IAM-Nutzer oder -Dienstkonto 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.
• Wenn Sie Kontextgruppen erstellen, hochladen und verwalten möchten, weisen Sie dem IAM-Nutzer oder -Dienstkonto 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 Kontextgruppen.
• Ein privilegierter Nutzer muss dem IAM-Nutzer oder -Dienstkonto Datenbankberechtigungen gewähren.
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
  
  Weitere Informationen finden Sie unter Einzelnem IAM-Nutzer oder -Dienstkonto Datenbankberechtigungen gewähren.

Berechtigung executesql für die 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 sql instances patch INSTANCE_ID --project=PROJECT_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 zum Ausführen der Schritte in dieser Anleitung bei Google Cloud an 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 „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 Bereich Explorer neben Kontextsätze auf Aktionen ansehen.

6. Klicken Sie auf Kontextgruppe erstellen.

7. Geben Sie unter Name des Kontextsets einen eindeutigen Namen für das Kontextset ein. Beim Namen des Kontextsets wird zwischen Groß- und Kleinschreibung unterschieden. Er darf Buchstaben, Ziffern, Bindestriche und Unterstriche enthalten. Namen müssen zwischen 4 und 30 Zeichen lang sein.

   Die Kontextset-ID wird vom Namen des Kontextsets abgeleitet, ist aber nicht unbedingt mit ihm identisch. Für die Kontext-Set-ID wird der Name des Kontext-Sets in Kleinbuchstaben umgewandelt und nicht alphanumerische Zeichen werden durch das Zeichen - ersetzt. Der Kontextsatzname querydata_e2e_test hat beispielsweise die Kontextsatz-ID querydata-e2e-test.

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

9. Optional. Wenn Sie eine Kontextsatzdatei hochladen möchten, klicken Sie im Bereich Kontextsatzdatei hochladen auf Durchsuchen und wählen Sie die Kontextsatzdatei aus.

10. Klicken Sie auf Erstellen.

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

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. Anschließend können Sie die Kontextdatei hochladen, um den Kontext zu bearbeiten.

Kontextset 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 IAM-Authentifizierung in Studio an.

5. Klicken Sie neben dem Kontextsatz, den Sie bearbeiten möchten, auf Aktionen ansehen.

6. Klicken Sie auf Kontextgruppe bearbeiten.

7. Optional. Bearbeiten Sie die Beschreibung des Kontextsets.

8. Klicken Sie im Abschnitt 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 IAM-Authentifizierung in Studio an.

5. Klicken Sie neben dem Kontextset, das Sie löschen möchten, auf Aktionen ansehen.

6. Klicken Sie auf Kontextset löschen.

7. Geben Sie im Bestätigungsdialogfeld Kontextgruppe löschen die ID 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 mit dieser Datenbank verknüpften Kontextgruppen löschen.

Nächste Schritte

• Weitere Informationen zu Kontextgruppen
• Kontext-Set testen
• Erfahren Sie, wie Sie Kontexte mit der Gemini CLI erstellen.