SQL-Unterstützung mit Gemini schreiben

In diesem Dokument wird beschrieben, wie Sie mit Gemini, einer KI-basierten Unterstützung in Google Cloud, Folgendes in Cloud SQL Studio tun können:

Weitere Informationen dazu, wie und wann Gemini for Google Cloud Ihre Daten verwendet

Dieses Dokument richtet sich an Datenbankadministratoren und Data Engineers, die mit SQL, Datenanalyse und Cloud SQL vertraut sind. Wenn Sie Cloud SQL noch nicht kennen, siehe Cloud SQL – Übersicht

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. Zugriff auf Cloud SQL Studio bestätigen. Wenn Sie keinen Zugriff auf Cloud SQL Studio haben, siehe Erforderliche Rollen und Berechtigungen für Cloud SQL Studio
  4. Optional: Zum Ausführen der Beispiele in diesem Dokument erstellen Sie eine Singers-Tabelle mit dem folgenden Schema:

    CREATE TABLE
    Singers (
      SingerId   BIGINT PRIMARY KEY,
      FirstName  VARCHAR(1024),
      LastName   VARCHAR(1024),
      SingerInfo MEDIUMBLOB,
      BirthDate  DATETIME
    );
    

    Klicken Sie nach dem Erstellen der Tabelle Singers auf aktualisierenAktualisieren, um Ihr Datenbankschema zu aktualisieren.

Erforderliche Rollen und Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud SQL Admin (roles/cloudsql.admin) 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.

Außerdem benötigen Sie die cloudaicompanion.companions.generateChat-Berechtigung zur Verwendung von SQL-Anweisungen im Abfrageeditor erklären und cloudaicompanion.companions.generateCode, um Hilfe beim Code zu verwenden.

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. 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, klicken Sie auf aktualisierenAktualisieren, um Ihr Schema vor der Verwendung von Gemini zu aktualisieren.

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

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL.

    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 dem Namen Ihrer Datenbank, Ihrem Nutzernamen und Ihrem Passwort in Cloud SQL Studio an. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

  5. Klicken Sie in der Taskleiste auf pen_sparkGemini, um Gemini-Features in Cloud SQL aufzurufen.

  6. Achten Sie darauf, dass die Generierung von Kommentaren zu Abfragen aktiviert ist.

  7. Klicken Sie zum Abfragen der Datenbank auf Neuer SQL-Editor-Tab.

  8. 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 oder Enter.

    Geben Sie beispielsweise den folgenden Prompt ein:

    -- add a row to table singers
    

    Drücken Sie Return oder Enter. Gemini generiert eine SQL-Ausgabe, die in etwa so aussieht:

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

    Geben Sie den folgenden Prompt ein, um das Beispiel mit der Tabelle Singers fortzusetzen:

    -- show all singers born in the 70s
    

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

    SELECT *
    FROM Singers
    WHERE Singers.BirthDate
    BETWEEN '1970-01-01' AND '1979-12-31'
    
    
  9. 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. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL.

    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 dem Namen Ihrer Datenbank, Ihrem Nutzernamen und Ihrem Passwort in Cloud SQL Studio an. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

  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');
    
  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 vervollständigen

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

So verwenden Sie Inline-Codevorschläge:

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL.

    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 dem Namen Ihrer Datenbank, Ihrem Nutzernamen und Ihrem Passwort in Cloud SQL Studio an. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

  5. Klicken Sie in der Taskleiste auf pen_sparkGemini, um Gemini-Features in Cloud SQL aufzurufen.

  6. Wählen Sie SQL-Vervollständigung aus.

  7. Klicken Sie zum Abfragen der Datenbank auf Neuer SQL-Editor-Tab.

  8. 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 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')
    
  9. 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.

SQL-Anweisungen im Abfrageeditor erklären

Sie können Gemini in Cloud SQL 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. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL.

    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 dem Namen Ihrer Datenbank, Ihrem Nutzernamen und Ihrem Passwort in Cloud SQL Studio an. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

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

  6. Fügen Sie im Abfrageeditor die Abfrage ein, die Sie erklärt haben möchten.

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

    Die Erläuterung für die SQL-Abfrage wird im Fenster Chat von Gemini angezeigt.

Nächste Schritte