SQL-Unterstützung mit Gemini schreiben

Vorschau – Gemini in Cloud Spanner

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

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

• SQL-Abfragen mit Prompts in natürlicher Sprache generieren
• SQL-Abfragen im Abfrageeditor erklären

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

Dieses Dokument richtet sich an Datenbankadministratoren und Data Engineers, die mit Spanner, SQL und Datenanalyse vertraut sind. Wenn Sie noch nicht mit Spanner vertraut sind, lesen Sie den Schnelleinstieg 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.

   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 Spanner Studio auf die Schaltfläche 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. Generierung von Kommentaren zu Abfragen. Sie können Funktionen auswählen und ausprobieren, ohne dass sich dies auf andere auswirkt, die an Ihrem Projekt arbeiten.

9. Optional: Wenn Sie die Beispiele in diesem Dokument nachvollziehen 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 für Google Cloud User (roles/cloudaicompanion.user) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen 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.

SQL-Abfragen mit Prompts in natürlicher Sprache generieren

Da es sich bei Produkten von Gemini for Google Cloudum Technologie in einem frühen Entwicklungsstadium handelt, kann es zu Ergebnissen kommen, die zwar plausibel erscheinen, aber faktisch falsch sind. Ausgaben der Produkte von Gemini für Google Cloud sollten daher vor der Verwendung geprüft werden. 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. 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?“

Hinweis: Wenn Sie einen Prompt für Gemini in Spanner eingeben, werden Informationen über das Schema Ihrer Datenbank in den Prompt aufgenommen. Diese können Tabellen- und Spaltennamen, Datentypen und Spaltenbeschreibungen umfassen. Ihr Datenbankschema und Ihre Daten verbleiben 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 Ihrer Datenbank auf Neuer Tab: Achten Sie darauf, dass die SQL-Generierung aktiviert ist.

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

   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'
   
   

   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:

   • Wenn Sie den von Gemini generierten SQL-Code akzeptieren möchten, drücken Sie die Tab-Taste 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.

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

Mit Gemini Fehler in Abfragen beheben

Vorschau – Gemini in Cloud Spanner

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Sie können personenbezogene Daten für diese Funktion gemäß dem Zusatz zur Verarbeitung von Cloud-Daten verarbeiten, vorbehaltlich der in der Vereinbarung beschriebenen Verpflichtungen und Einschränkungen, in denen Sie auf Google Cloud zugreifen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

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 die folgenden Vorteile:

• Bietet einen zeilenweisen Vergleich der ursprünglichen Abfrage neben einer neuen Abfrage mit empfohlenen Änderungen im Abfrageeditor.
• Es werden Segmente der ursprünglichen Abfrage hervorgehoben, die möglicherweise das Problem verursachen, und eine Zusammenfassung der Änderungen in natürlicher Sprache bereitgestellt.
• Bezieht sich auf die genaue Fehlermeldung und die mit der Abfrage verknüpften Schemainformationen, um genaue, relevante Korrekturen vorzuschlagen.
• Sie müssen sich nicht mehr auf universelle LLMs von Drittanbietern verlassen, die möglicherweise weniger differenzierte Hilfe bieten und Ihre Daten potenziellen Sicherheitsrisiken aussetzen.
• Schnellere und effizientere Fehlerbehebung bei häufigen Problemen wie Syntax-, Schema- und Laufzeitfehlern.

Erforderliche Berechtigungen

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

• Die in Erforderliche Rollen beschriebenen Rollen.
• Die Berechtigung „Gemini für Google Cloud API“ (cloudaicompanion.googleapis.com/instances.generateCode).

Anfrage mit Gemini korrigieren

So nutzen Sie die Funktionen von Gemini, um bestimmte Fehler in einer Abfrage zu beheben:

1. Führen Sie Ihre 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 („Diff-Editor“) geöffnet, in dem die vorhandene Abfrage zeilenweise mit den empfohlenen Änderungen verglichen wird. Der Abfrageeditor enthält auch eine Zusammenfassung der vorgeschlagenen Änderungen.

3. Sehen Sie sich die vorgeschlagenen Änderungen an der Anfrage an und aktualisieren Sie sie bei Bedarf.

4. 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 Spanner Studio-Abfrageeditor in derGoogle Cloud Console verfügbar.
• Es gelten die aktuellen Limits für das Gemini-Kontextfenster.

Nächste Schritte

• Gemini für Google Cloud  – Übersicht
• So verwendet Gemini Ihre Daten.