SQL-Unterstützung mit Gemini schreiben

Vorschau — Gemini in Spanner

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

In diesem Dokument wird beschrieben, wie Sie mit Gemini Code Assist KI-gestützte Unterstützung für Folgendes in Spanner erhalten:

• SQL-Abfragen mit Prompts in natürlicher Sprache generieren
• Vervollständigen Sie die SQL-Anweisungen im Abfrageeditor.
• 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 Spanner, SQL und Datenanalyse vertraut sind. Wenn Sie mit Spanner noch nicht vertraut sind, lesen Sie den Hilfeartikel Datenbank mit der Google Cloud Console erstellen und abfragen.

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 Programmierunterstützung in Spanner Studio weiterhin nutzen zu können.

Hinweise

1. Optional: Gemini Code Assist einrichten

2. Zum Ausführen der Aufgaben in diesem Dokument benötigen Sie die erforderlichen IAM-Berechtigungen (Identity and Access Management).

3. Rufen Sie in der Google Cloud -Konsole die Seite Spanner auf.

   Spanner aufrufen

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

5. Wählen Sie eine Datenbank aus.

6. Klicken Sie im Navigationsmenü auf Spanner Studio.

7. Klicken Sie in der Taskleiste auf pen_spark Gemini, um Gemini-Features in Spanner aufzurufen.

8. Wählen Sie die Gemini-Funktionen aus, die Sie aktivieren möchten, z. B. SQL-Vervollständigung und Generierung von Abfragen aus Kommentaren. Sie können Funktionen für sich selbst auswählen und ausprobieren, ohne dass sich das auf andere Nutzer auswirkt, die an Ihrem Projekt arbeiten.

9. Optional: Wenn Sie die Beispiele in diesem Dokument nachvollziehen möchten, erstellen Sie zuerst die Singers-Tabelle wie unter Schema für Ihre Datenbank erstellen beschrieben.

Wenn Sie Gemini-Funktionen in Spanner deaktivieren möchten, wiederholen Sie diese Schritte und heben Sie dann die Auswahl der nicht länger gewünschten Gemini-Funktionen auf.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Gemini for Google Cloud User (roles/cloudaicompanion.user) für das Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie für die Durchführung der Aufgaben in diesem Dokument benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

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. 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 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?“

Hinweis: Wenn Sie einen Prompt für Gemini in Spanner 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 Spanner und werden nicht an Gemini gesendet.

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

1. Rufen Sie in der Google Cloud -Konsole die Seite Spanner auf.

   Spanner aufrufen

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

3. Wählen Sie eine Datenbank aus.

4. Klicken Sie im Navigationsbereich auf Spanner Studio. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

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

6. 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 Taste Return 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.

7. 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, drücken Sie Tab und klicken Sie dann auf Ausführen, um den vorgeschlagenen SQL-Code auszuführen.
   • Drücken Sie zum Bearbeiten des von Gemini generierten 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.

SQL-Anweisungen im Abfrageeditor vervollständigen

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

Vorschläge für Inline-Code

So verwenden Sie Inline-Codevorschläge:

1. Rufen Sie in der Google Cloud -Konsole die Seite Spanner auf.

   Spanner aufrufen

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

3. Wählen Sie eine Datenbank aus.

4. Klicken Sie im Navigationsbereich auf Spanner Studio.

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

6. 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.

7. 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 Tab und klicken Sie dann auf Ausführen, um den vorgeschlagenen SQL-Code auszuführen.
   • Drücken Sie zum Bearbeiten des von Gemini generierten 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. Rufen Sie in der Google Cloud -Konsole die Seite Spanner auf.

   Spanner aufrufen

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

3. Wählen Sie eine Datenbank aus.

4. Klicken Sie im Navigationsbereich auf Spanner Studio.

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

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

7. 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.

8. 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 erklären

Sie können Gemini in Spanner 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. Rufen Sie in der Google Cloud -Konsole die Seite Spanner auf.

   Spanner aufrufen

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

3. Wählen Sie eine Datenbank aus.

4. Klicken Sie im Navigationsbereich auf Spanner Studio.

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

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

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

   Die SQL-Erklärung wird im Gemini-Bereich angezeigt.

Nächste Schritte

• Lesen Sie den Artikel Gemini für Google Cloud  – Übersicht.
• So verwendet Gemini Ihre Daten.