Kontextsets in Cloud SQL for MySQL 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 Zugriffs anforderung.

In diesem Dokument wird beschrieben, wie Sie in Cloud SQL for MySQL Studio mithilfe einer Kontextsetdatei Kontextsets erstellen. Namen von Kontextsets müssen innerhalb einer Datenbank eindeutig sein.

Weitere Informationen zu Kontextsets finden Sie in der Übersicht zu Kontextsets.

Hinweis

Führen Sie die folgenden Schritte aus, 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

• Prüfen Sie, ob 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

• Fügen Sie auf Instanzebene einen IAM-Nutzer oder ein Dienstkonto hinzu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung zu einem Nutzer, Dienstkonto oder einer Gruppe 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.
• Ein privilegierter Nutzer muss dem IAM-Nutzer oder Dienstkonto Datenbankberechtigungen gewähren.
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
  
  Weitere Informationen finden Sie unter Datenbankberechtigungen für einen einzelnen IAM-Nutzer oder ein einzelnes Dienstkonto gewähren.

Berechtigung executesql 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, und authentifizieren Sie sich dann mit der IAM-Authentifizierung bei der Datenbank .Google Cloud

Kontextset erstellen

So erstellen Sie ein Kontextset:

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 bei Studio an.

5. Klicken Sie im Bereich Explorer neben Kontextsets auf Aktionen anzeigen.

6. Klicken Sie auf Kontextset 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 kann Buchstaben, Zahlen, 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.

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 Kontextsetdatei zu erstellen. Anschließend können Sie das Kontextset bearbeiten, um die Kontextsetdatei hochzuladen.

Kontextset bearbeiten

So bearbeiten Sie ein Kontextset:

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 bei Studio an.

5. Klicken Sie im Bereich Explorer neben Kontextsets auf Aktionen anzeigen.

6. Klicken Sie auf Kontextset bearbeiten.

7. Optional: Bearbeiten Sie die Beschreibung des Kontextsets.

8. Klicken Sie im Bereich Kontextsetdatei hochladen auf Durchsuchen und wählen Sie die Kontextsetdatei aus.

9. Klicken Sie auf Speichern.

Kontextset löschen

So löschen Sie ein Kontextset:

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 bei Studio an.

5. Klicken Sie im Bereich Explorer neben Kontextsets auf Aktionen anzeigen.

6. Klicken Sie auf Kontextset löschen.

7. Geben Sie im Bestätigungsdialogfeld Kontextset löschen den Namen des Kontextsets ein.

8. Klicken Sie auf Bestätigen , um das Kontextset zu löschen.

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

Nächste Schritte

• Weitere Informationen zu Kontextsets.
• Kontextset testen
• Kontexte mit der Gemini CLI erstellen