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
Optional: Gemini Code Assist einrichten.
Zum Ausführen der Aufgaben in diesem Dokument benötigen Sie die erforderlichen IAM-Berechtigungen (Identity and Access Management).
Rufen Sie in der Google Cloud Console die Seite Spanner auf.
Wählen Sie eine Instanz aus der Liste aus.
Wählen Sie eine Datenbank aus.
Klicken Sie im Navigationsmenü auf Spanner Studio.
Klicken Sie in Spanner Studio auf die settings_suggestion Gemini Code Assist, um die Gemini Funktionen in Spanner aufzurufen.
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.
Optional: Wenn Sie die Beispiele in diesem Dokument ausführen möchten, erstellen Sie zuerst die Tabelle
Singerswie 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:
Rufen Sie in der Google Cloud Console die Seite Spanner auf.
Wählen Sie eine Instanz aus der Liste aus.
Wählen Sie eine Datenbank aus.
Klicken Sie im Navigationsbereich auf Spanner Studio. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.
Klicken Sie zum Abfragen Ihrer Datenbank auf Neuer Tab. Prüfen Sie, ob die SQL-Generierung aktiviert ist.
Um SQL zu generieren, geben Sie im Abfrageeditor einen Kommentar ein, der mit
--beginnt, gefolgt von einemeinzeiligen Kommentar, und drücken Sie dannReturn.Wenn Sie beispielsweise den Prompt
-- add a row to table singerseingeben undReturndrü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
Singersfortsetzen und den Prompt-- show all singers born in the 70seingeben, generiert Gemini SQL-Code, der in etwa so aussieht:SELECT * FROM Singers WHERE Singers.BirthDate BETWEEN '1970-01-01' AND '1979-12-31'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
Tabund 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
Escoder fahren Sie mit der Eingabe fort.
- Wenn Sie den von Gemini generierten SQL-Code akzeptieren möchten, drücken Sie
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.
Rufen Sie in der Google Cloud Console die Seite Spanner auf.
Wählen Sie eine Instanz aus der Liste aus.
Wählen Sie eine Datenbank aus.
Klicken Sie im Navigationsbereich auf Spanner Studio.
Klicken Sie zum Abfragen Ihrer Datenbank auf Neuer Tab.
Fügen Sie die Abfrage in den Abfrageeditor ein.
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:
- Die unter Erforderliche Rollen aufgeführten Rollen
- Die Berechtigung für die Gemini for Google Cloud API,
cloudaicompanion.googleapis.com/instances.generateCode.
Abfrage mit Gemini korrigieren
So beheben Sie bestimmte Fehler in einer Abfrage mit den Funktionen von Gemini:
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.
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.
Prüfen Sie die vorgeschlagenen Änderungen an der Abfrage und aktualisieren Sie sie nach Bedarf.
Klicken Sie auf Akzeptieren und ausführen, um die Änderungen zu übernehmen und die neue Abfrage auszuführen.
Beschränkungen
- Diese Funktion ist nur im Abfrageeditor von Spanner Studio in der Google Cloud Console verfügbar.
- Es gelten die aktuellen Beschränkungen für das Gemini-Kontextfenster.
Nächste Schritte
- Gemini für – Übersicht Google Cloud
- So verwendet Gemini Ihre Daten