SQL-Unterstützung mit Gemini schreiben

Vorschau

Dieses Produkt unterliegt den Bedingungen des Pre-GA-Angebots in den Nutzungsbedingungen von Google Cloud . Für Pre-GA-Produkte ist eventuell nur eingeschränkter Support verfügbar. Änderungen an diesen Produkten sind möglicherweise nicht mit anderen Pre-GA-Versionen kompatibel. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

In diesem Dokument wird beschrieben, wie Sie mit Gemini, einer KI-basierten Unterstützung inGoogle Cloud, Folgendes in AlloyDB for PostgreSQL tun können:

• SQL-Abfragen mit Prompts in natürlicher Sprache generieren
• SQL-Abfragen im Abfrageeditor vervollständigen
• SQL-Abfragen im Abfrageeditor erklären

Weitere Informationen dazu, wie und wann Gemini für Google Cloud Ihre Daten verwendet

Dieses Dokument richtet sich an Datenbankadministratoren und Data Engineers, die mit AlloyDB und etwas mit SQL und Datenanalyse vertraut sind. Wenn Sie AlloyDB noch nicht kennen, lesen Sie den Hilfeartikel AlloyDB – Übersicht.

Hinweis: Die Code-Hilfe ist Teil von Gemini Code Assist und kostenlos verfügbar, bis sie in der Standardversion von Gemini Code Assist enthalten ist. Näheres dazu wird zu einem späteren Zeitpunkt bekannt gegeben. In diesem Fall müssen Sie eine Lizenz für die Standardversion von Gemini Code Assist erwerben, um die Code-Hilfe in AlloyDB for PostgreSQL Studio weiterhin nutzen zu können.

Hinweise

Optional: Wenn Sie die Beispiele in diesem Dokument nachvollziehen möchten, erstellen Sie die Singers-Tabelle mit dem folgenden Schema:

```sql
CREATE TABLE Singers (
  BirthDate  TIMESTAMPTZ,
  SingerId   BIGINT PRIMARY KEY,
  FirstName  VARCHAR(1024),
  LastName   VARCHAR(1024),
  SingerInfo BYTEA
);
```
After you create the `Singers` table, click
<span class="material-symbols-outlined">refresh</span>**Refresh** to
update your database schema.

Wenn Sie Gemini-Funktionen in AlloyDB deaktivieren möchten, wiederholen Sie diesen Schritt und heben Sie dann die Auswahl der Gemini-Funktionen auf, die Sie deaktivieren möchten.

Erforderliche Rollen und Berechtigungen

Achtung: Bei Nutzern mit umfassendem Datenbankzugriff können bei der Verwendung von Gemini Datenverluste auftreten. Wir empfehlen, ein Konto mit weniger Datenbankberechtigungen zu verwenden, wenn Sie Gemini verwenden.

Für die Verwendung von Gemini mit AlloyDB benötigen Sie die folgenden Berechtigungen:

• alloydb.clusters.get
• alloydb.databases.list
• alloydb.instances.executeSql
• alloydb.instances.list
• alloydb.users.list

Sie können diese Berechtigung über die Rolle roles/alloydb.admin erhalten. Wenn Sie diese Rolle nicht haben, wenden Sie sich an einen Organisationsadministrator, um Zugriff anzufordern. Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Achten Sie außerdem darauf, dass Sie Berechtigungen auf Datenbankebene für die Datenbank haben, die Sie zur Authentifizierung verwenden.

SQL-Abfragen mit Prompts in natürlicher Sprache generieren

Da es sich bei Gemini für Google Cloud-Produkte um eine Technologie im Frühstadium handelt, kann es zu Ergebnissen kommen, die zwar plausibel erscheinen, aber faktisch falsch sind. Das gilt insbesondere für Schreibvorgänge der Data Manipulation Language (DML) oder der Data Definition Language (DDL). Wir empfehlen, alle Ausgaben von Gemini für Google Cloud -Produkte zu validieren, bevor Sie sie verwenden. Weitere Informationen finden Sie unter Gemini für Google Cloud und verantwortungsbewusste Anwendung von KI.

Sie können Gemini Kommentare in natürlicher Sprache (oder Prompts) übergeben, um Abfragen zu generieren, die auf Ihrem Schema basieren. Beispielsweise können Sie Gemini auffordern, als Reaktion auf die folgenden Prompts SQL zu generieren:

• "Erstellen Sie eine Tabelle, in der die Ergebnisse einer Umfrage zur Kundenzufriedenheit erfasst werden."
• "Fügen Sie der Tabelle "Sänger" eine Datumsspalte mit dem Namen "Geburtsdatum" hinzu."
• „Wie viele Sänger wurden in den 1990ern geboren?“

Wenn sich das Schema ändert, z. B. das Hinzufügen einer neuen Tabelle oder Spalte, müssen Sie auf AktualisierenAktualisieren klicken, um Ihr Schema vor der Verwendung von Gemini zu aktualisieren.

Hinweis: Wenn Sie einen Prompt für Gemini in AlloyDB eingeben, werden Informationen über das Schema Ihrer Datenbank in die Eingabeaufforderung aufgenommen. Diese können Tabellen- und Spaltennamen, Datentypen und Spaltenbeschreibungen umfassen. Ihr Datenbankschema und Ihre Daten verbleiben in AlloyDB und werden nicht an Gemini gesendet.

So generieren Sie SQL in AlloyDB mit Gemini-Unterstützung:

1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

   Zu AlloyDB

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

3. Klicken Sie im Navigationsmenü auf AlloyDB.

4. Wählen Sie eine Datenbank und einen Nutzer aus und geben Sie das Passwort des Nutzers ein.

5. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

6. Klicken Sie zum Abfragen der Datenbank auf Neuer SQL-Editor-Tab. Prüfen Sie, ob die SQL-Generierung aktiviert ist.

7. Um SQL zu generieren, geben Sie im Abfrageeditor einen Kommentar ein, der mit -- beginnt, gefolgt von einem einzeiligen Kommentar, und drücken Sie dann Return.

   Wenn Sie beispielsweise den Prompt -- add a row to table singers eingeben und die Eingabetaste drücken, generiert Gemini SQL-Code, der in etwa so aussieht:

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   Wenn Sie das Beispiel mit der Tabelle Singers fortsetzen möchten, geben Sie den Prompt -- show all singers born in the 70s ein. Gemini generiert dann SQL-Code, der in etwa so aussieht:

   SELECT *
   FROM Singers
   WHERE Singers.BirthDate
   BETWEEN '1970-01-01' AND '1979-12-31'
   

   Hinweis: Gemini kann nach der Eingabe eines identischen Prompts jedes Mal eine andere Syntax vorschlagen.

8. Prüfen Sie den SQL-Vorschlag und führen Sie eine der folgenden Aktionen aus:

   • Halten Sie den Mauszeiger über die Abfrage, um die Optionen zum Akzeptieren des von Gemini generierten SQL-Codes aufzurufen. Die folgenden Optionen werden angezeigt:
     • Akzeptieren: Um die vorgeschlagene Abfrage zu akzeptieren, drücken Sie Tab und klicken Sie dann auf Ausführen.
     • Wort akzeptieren: Um die vorgeschlagene Abfrage teilweise zu akzeptieren, drücken Sie Control + Right arrow (oder Command + Right arrow unter macOS) und dann klicken Sie auf Ausführen.
   • Drücken Sie zum Bearbeiten des ursprünglichen SQL-Codes Tab, bearbeiten Sie den SQL-Code und klicken Sie dann auf Ausführen.
   • Um einen Vorschlag zu verwerfen, drücken Sie Esc oder fahren Sie mit der Eingabe fort.

Tool „Hilfe beim Programmieren“

So verwenden Sie das Tool Hilfe beim Programmieren:

1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

   Zu AlloyDB

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

3. Klicken Sie im Navigationsmenü auf AlloyDB.

4. Wählen Sie eine Datenbank und einen Nutzer aus und geben Sie das Passwort des Nutzers ein.

5. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

6. Klicken Sie zum Abfragen Ihrer Datenbank auf Neuer Tab:

7. Klicken Sie neben dem Abfrageeditor auf pen_spark Hilfe beim Programmieren.

8. Geben Sie im Fenster Hilfe beim Programmieren einen Prompt ein. Beispiel: add a row to table singers und dann auf Generieren klicken.

   Gemini generiert SQL-Code, der in etwa so aussieht:

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   Hinweis: Gemini kann nach der Eingabe eines identischen Prompts jedes Mal eine andere Syntax vorschlagen.

9. Prüfen Sie den generierten SQL-Code und führen Sie eine der folgenden Aktionen aus:

   • Wenn Sie den von Gemini generierten SQL-Code akzeptieren möchten, klicken Sie auf Einfügen, um die Anweisung in den Abfrageeditor einzufügen. Klicken Sie dann auf Ausführen, um den vorgeschlagenen SQL-Code auszuführen.
   • Klicken Sie auf Bearbeiten, um Gemini aufzufordern, eine neue Abfrage zu generieren. Nachdem Sie den Prompt bearbeitet haben, klicken Sie auf Aktualisieren. Sie können dann entscheiden, die neu generierte Anweisung zu akzeptieren oder den Vorschlag abzulehnen.
   • Wenn Sie den Vorschlag ablehnen möchten, schließen Sie das Fenster Hilfe beim Programmieren.

SQL-Anweisungen im Abfrageeditor vervollständigen

Damit Sie SQL-Code schreiben können, bietet Gemini in AlloyDB KI-gestützte Vorschläge zur Codevervollständigung. Wenn Sie Gemini aktivieren und Text in den Abfrageeditor von AlloyDB eingeben, sagt Gemini den SQL-Code voraus und füllt ihn automatisch aus.

So verwenden Sie Inline-Codevorschläge:

1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

   Zu AlloyDB

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

3. Klicken Sie im Navigationsmenü auf AlloyDB.

4. Wählen Sie eine Datenbank und einen Nutzer aus und geben Sie das Passwort des Nutzers ein.

5. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

6. Klicken Sie zum Abfragen der Datenbank auf Neuer SQL-Editor-Tab. Prüfen Sie, ob die SQL-Vervollständigung aktiviert ist.

7. Geben Sie eine Abfrage und ein Leerzeichen oder einen Zeilenumbruch am Zeilenende ein. Während Sie Text eingeben, zeigt Gemini SQL-Vorschläge an, die auf den unterstützten Objekten im Schema der ausgewählten Datenbank basieren.

   Wenn Sie beispielsweise der Tabelle Singers eine Zeile hinzufügen möchten, schreiben Sie die folgende SQL-Anfrage: INSERT INTO Singers.

   Gemini schlägt eine SQL-Variante vor, die in etwa so aussieht:

   INSERT INTO Singers
   (SingerId, FirstName, LastName, BirthDate)
   VALUES
     (1, 'Marc', 'Singer', '1970-03-24')
   

   Hinweis: Gemini kann nach der Eingabe einer identischen SQL-Anweisung jedes Mal eine andere SQL-Syntax vorschlagen.

8. Prüfen Sie den SQL-Vorschlag und führen Sie eine der folgenden Aktionen aus:

   • Wenn Sie den von Gemini generierten SQL-Code akzeptieren möchten, drücken Sie den Tabulator und klicken Sie dann auf Ausführen, um den vorgeschlagenen SQL-Code auszuführen.
   • Wenn Sie die von Gemini generierte SQL-Datei bearbeiten möchten, drücken Sie den Tabulator, bearbeiten Sie die SQL-Datei und klicken Sie dann auf Ausführen.
   • Drücken Sie ESC oder fahren Sie mit der Eingabe fort, um einen Vorschlag zu verwerfen.

SQL-Anweisungen im Abfrageeditor erklären

Sie können Gemini in AlloyDB verwenden, um SQL-Abfragen in natürlicher Sprache zu erklären. Diese Erklärung kann Ihnen helfen, die Syntax, das zugrunde liegende Schema und den Geschäftskontext für komplexe oder lange Abfragen zu verstehen.

1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

   Zu AlloyDB

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

3. Klicken Sie im Navigationsmenü auf AlloyDB.

4. Wählen Sie eine Datenbank und einen Nutzer aus und geben Sie das Passwort des Nutzers ein.

5. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

6. Klicken Sie zum Abfragen Ihrer Datenbank auf Neuer Tab:

7. Fügen Sie die Abfrage in den Abfrageeditor ein.

8. Markieren Sie die Abfrage, die Gemini erklären soll, und klicken Sie dann auf pen_spark Diese Abfrage erklären.

   Die SQL-Erläuterung wird im Fenster Chat von Gemini angezeigt.

Nächste Schritte

• Gemini für Google Cloud  – Übersicht
• Weitere Informationen dazu, wie Gemini Ihre Daten verwendet
• Informationen zum Analysieren Ihrer Daten in Google Cloud mit Gemini