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.

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, die gesamte Ausgabe von Gemini vor der Verwendung zu validieren. Weitere Informationen finden Sie unter Gemini für Google Cloud und Responsible AI.

In diesem Dokument wird beschrieben, wie Sie Gemini, einen KI-gestützten Mitbearbeiter in Google Cloud, für Folgendes in Spanner verwenden können:

• Generieren Sie SQL-Abfragen mit Prompts in natürlicher Sprache.
• SQL-Anweisungen im Abfrageeditor ausführen.
• SQL-Abfragen im Abfrageeditor erklären

Gemini verwendet Ihre Prompts oder deren Antworten nicht als Daten, um seine Modelle zu trainieren. Weitere Informationen finden Sie unter So verwendet Gemini for Google Cloud Ihre Daten.

Dieses Dokument richtet sich an Datenbankadministratoren und Data Engineers, die mit Spanner, SQL und der Datenanalyse vertraut sind. Wenn Sie mit Spanner noch nicht vertraut sind, lesen Sie den Artikel Datenbank mit der Google Cloud Console erstellen und abfragen.

Hinweise

1. Prüfen Sie, ob Gemini in Datenbanken eingerichtet ist.
2. Für die 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.

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

8. Wählen Sie die Gemini-Features aus, die Sie aktivieren möchten, z. B. SQL-Vervollständigung und Abfragen aus Kommentaren erstellen. Sie können Features für sich selbst auswählen und ausprobieren, ohne andere in Ihrem Projekt 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 Ihre Datenbank erstellen beschrieben.

Wiederholen Sie diese Schritte und heben Sie dann die Auswahl der Gemini-Features auf, die Sie deaktivieren möchten.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Spanner-Datenbankleser (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

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 dazu auffordern, SQL als Antwort auf die folgenden Eingaben 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 eine Eingabeaufforderung für Gemini in Spanner eingeben, enthält die Eingabeaufforderung Informationen zum Schema Ihrer Datenbank. 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 Gemini-Unterstützung:

1. Rufen Sie in der Google Cloud Console 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. 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. Drücken Sie dann Return.

   Wenn Sie beispielsweise die Eingabeaufforderung -- add a row to table singers eingeben und Return drücken, generiert Gemini einen 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, generieren Sie bei Eingabe der Eingabeaufforderung -- show all singers born in the 70s einen 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:

   • Um die von Gemini generierte SQL-Abfrage 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

Damit Sie einfacher SQL-Code schreiben können, bietet Gemini in Spanner KI-gestützte Vorschläge zur Codevervollständigung. Wenn Gemini aktiviert ist und Sie Text in den Abfrageeditor von Spanner Studio eingeben, sagt Gemini den SQL-Code vorher 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 Console 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 SQL-Editor-Tab. Achten Sie darauf, dass die SQL-Vervollständigung aktiviert ist.

6. Geben Sie eine Suchanfrage und am Ende der Zeile ein Leerzeichen oder eine neue Zeile ein. Während der Eingabe 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 den folgenden SQL-Code: 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 bei jeder Eingabe derselben SQL-Anweisung möglicherweise eine andere SQL-Syntax vor.

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

   • Um die von Gemini generierte SQL-Abfrage 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.

   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 den neuen 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 Console 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 den neuen Tab .

6. Fügen Sie die Abfrage in den Query Editor 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 Bereich Gemini angezeigt.

Nächste Schritte

• Lesen Sie die Übersicht zu Gemini in Google Cloud.
• Informationen dazu, wie Gemini Ihre Daten verwendet
• Daten in Google Cloud mit Gemini analysieren