SQL mit Unterstützung durch 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, einem KI-gestützten Tool in Google Cloud, die folgenden Aufgaben in Spanner erledigen können:

• SQL-Abfragen mit Prompts in natürlicher Sprache generieren
• Führen Sie die SQL-Anweisungen im Abfrageeditor aus.
• SQL-Abfragen im Abfrageeditor erklären

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 Datenanalysen vertraut sind. Wenn Sie mit Spanner noch nicht vertraut sind, lesen Sie Datenbank mit der Google Cloud Console erstellen und abfragen.

Hinweise

1. Achten Sie darauf, dass Sie Gemini in Datenbanken eingerichtet haben.
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 Console die Seite Spanner auf.

   Zu Spanner

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 die Gemini-Features in Spanner aufzurufen.

8. Wählen Sie die Gemini-Funktionen aus, die Sie aktivieren möchten, z. B. SQL-Vervollständigung und Abfragen generieren. Sie können Funktionen selbst auswählen und ausprobieren, ohne andere, die an Ihrem Projekt arbeiten, zu beeinträchtigen.

9. Optional: Wenn Sie den Beispielen in diesem Dokument folgen möchten, erstellen Sie zuerst die Tabelle Singers, wie unter Schema für die Datenbank erstellen beschrieben.

Zum Deaktivieren von Gemini-Funktionen in Spanner wiederholen Sie diese Schritte und heben Sie dann die Auswahl der Gemini-Funktionen auf, die Sie deaktivieren möchten.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Spanner Database Reader (roles/spanner.databaseReader) für das Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Ausführen der Aufgaben in diesem Dokument benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie 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 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 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. Sie können Gemini beispielsweise auffordern, SQL als Antwort auf die folgenden Prompts 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 darin Informationen zum Schema Ihrer Datenbank enthalten. Diese können Tabellen- und Spaltennamen, Datentypen und Spaltenbeschreibungen umfassen. Das Datenbankschema und die Daten bleiben in Spanner und werden nicht an Gemini gesendet.

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

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

   Zu Spanner

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. Achten Sie darauf, dass die SQL-Generierung aktiviert ist.

6. Zum Generieren von SQL geben Sie im Abfrageeditor einen Kommentar ein, der mit -- beginnt, gefolgt von einem einzeiligen Kommentar, und drücken dann Return.

   Wenn Sie beispielsweise den Prompt -- add a row to table singers eingeben und 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 einen SQL-Code, der in etwa so aussieht:

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

   Hinweis :Gemini schlägt Ihnen möglicherweise jedes Mal eine andere Syntax vor, wenn Sie denselben Prompt eingeben.

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

   • Um von Gemini generierte SQL-Codes zu akzeptieren, 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

Zum Schreiben von SQL-Code bietet Gemini in Spanner Vorschläge für KI-gestützte Codevervollständigung. Wenn Gemini aktiviert ist und Sie Text im Abfrageeditor von Spanner Studio eingeben, prognostiziert Gemini SQL-Code und füllt ihn automatisch aus.

Inline-Codevorschläge

So verwenden Sie Inline-Codevorschläge:

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

   Zu Spanner

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. Achten Sie darauf, dass die SQL-Vervollständigung aktiviert ist.

6. Geben Sie eine Abfrage und ein Leerzeichen oder eine neue Zeile am Ende der Zeile ein. Wenn Sie Text eingeben, zeigt Gemini Vorschläge für SQL 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, beginnen Sie mit dem Schreiben des folgenden SQL-Codes: 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 schlägt möglicherweise jedes Mal eine andere SQL-Syntax vor, wenn Sie dieselbe SQL-Anweisung eingeben.

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

   • Um von Gemini generierte SQL-Codes zu akzeptieren, 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 Console die Seite Spanner auf.

   Zu Spanner

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 schlägt Ihnen möglicherweise jedes Mal eine andere Syntax vor, wenn Sie denselben Prompt eingeben.

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, ob Sie die neue generierte Anweisung akzeptieren oder den Vorschlag ablehnen.
   • 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äftlichen Kontext für komplexe oder lange Abfragen zu verstehen.

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

   Zu Spanner

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

• Überblick über Gemini in Google Cloud
• So verwendet Gemini deine Daten
• Daten in Google Cloud mit Gemini analysieren