SQL-Unterstützung mit Gemini schreiben

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

Weitere Informationen dazu, wie und wann Gemini forIhre Daten verwendet. Google Cloud

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

Hinweis

  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 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 Spanner Studio auf die settings_suggestion Gemini Code Assist, um die Gemini Funktionen in Spanner aufzurufen.

  8. Wählen Sie die Gemini-Funktionen aus, die Sie aktivieren möchten, z. B. Abfrage aus Kommentar generieren. Sie können Funktionen auswählen und selbst testen, ohne andere Nutzer zu beeinträchtigen, die an Ihrem Projekt arbeiten.

  9. Optional: Wenn Sie die Beispiele in diesem Dokument ausführen möchten, erstellen Sie zuerst die Tabelle Singers 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 Gemini-Funktionen auf, die Sie deaktivieren möchten.

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, damit Sie die Aufgaben in diesem Dokument ausführen können. 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

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

So generieren Sie SQL in Spanner mit 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 Ihrer Datenbank auf Neuer 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 einemeinzeiligen Kommentar, und drücken Sie 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 und den Prompt -- show all singers born in the 70s eingeben, generiert Gemini SQL-Code, der in etwa so aussieht:

    SELECT *
    FROM Singers
    WHERE Singers.BirthDate
    BETWEEN '1970-01-01' AND '1979-12-31'
    
    
  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.
    • Wenn Sie den von Gemini generierten SQL-Code bearbeiten möchten, drücken Sie 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 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.

    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 astrophotography_mode Diese ausgewählte Abfrage erklären.

    Die Erklärung der SQL-Abfrage wird im Bereich „Gemini Cloud Assist“ angezeigt.

Fehler in Abfragen mit Gemini beheben

Gemini bietet eine erweiterte Funktion, mit der Sie Fehler in Ihren Spanner-Abfragen beheben können, ohne den Abfrageeditor verlassen zu müssen.

Die KI-basierten Funktionen von Gemini sind in Spanner Studio integriert und bieten folgende Vorteile:

  • Im Abfrageeditor wird ein Zeile-für-Zeile-Vergleich der ursprünglichen Abfrage neben einer neuen Abfrage mit empfohlenen Änderungen angezeigt.
  • Segmente der ursprünglichen Abfrage, die das Problem verursachen könnten, werden hervorgehoben und es wird eine Zusammenfassung der Änderungen in natürlicher Sprache bereitgestellt.
  • Die genaue Fehlermeldung und die mit der Abfrage verknüpften Schemainformationen werden referenziert, um genaue und relevante Korrekturen zu ermöglichen.
  • Sie müssen sich nicht auf allgemeine LLMs von Drittanbietern verlassen, die möglicherweise weniger differenzierte Hilfe bieten und Ihre Daten potenziellen Sicherheits risiken aussetzen könnten.
  • Schnellere und effizientere Fehlerbehebung für häufige Probleme wie Syntax-, Schema- und Laufzeitfehler.

Erforderliche Berechtigungen

Prüfen Sie vor Beginn, ob Sie die folgenden Berechtigungen haben:

Abfrage mit Gemini korrigieren

So beheben Sie bestimmte Fehler in einer Abfrage mit den Funktionen von Gemini:

  1. Führen Sie die Abfrage im Abfrageeditor aus.

    Wenn die Abfrage einen Fehler enthält, wird unten im Editor eine Fehlermeldung in einem Fehlerbanner zurückgegeben.

  2. Klicken Sie auf Korrigieren.

    Im Abfragefenster wird auf dem Tab ein Editor für Unterschiede geöffnet, in dem die vorhandene Abfrage mit empfohlenen Änderungen Zeile für Zeile verglichen wird. Der Abfrageeditor bietet auch eine Zusammenfassung der vorgeschlagenen Änderungen.

  3. Prüfen Sie die vorgeschlagenen Änderungen an der Abfrage und aktualisieren Sie sie nach Bedarf.

  4. Klicken Sie auf Akzeptieren und ausführen, um die Änderungen zu übernehmen und die neue Abfrage auszuführen.

Beschränkungen

Nächste Schritte