SQL-Unterstützung mit Gemini schreiben

In diesem Dokument wird beschrieben, wie Sie mit Gemini, einer KI-basierten Unterstützung inGoogle Cloud, Folgendes in AlloyDB for PostgreSQL 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 AlloyDB vertraut sind und über einige Kenntnisse in SQL und Datenanalyse verfügen. Wenn Sie AlloyDB noch nicht kennen, lesen Sie die AlloyDB-Übersicht.

Hinweise

  1. Prüfen Sie, ob Gemini Cloud Assist für Ihr Google Cloud Nutzerkonto und Projekt eingerichtet ist..

  2. Optional: Wenn Sie die Beispiele in diesem Dokument nachvollziehen möchten, erstellen Sie die Singers-Tabelle mit dem folgenden Schema:

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

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

Wenn Sie Gemini-Funktionen in AlloyDB deaktivieren möchten, wiederholen Sie diesen Schritt und heben Sie dann die Auswahl der Gemini-Funktionen auf, die Sie deaktivieren möchten.

Erforderliche Rollen und Berechtigungen

Wenn Sie Gemini mit AlloyDB verwenden möchten, benötigen Sie die folgenden Berechtigungen:

  • alloydb.clusters.get
  • alloydb.databases.list
  • alloydb.instances.executeSql
  • alloydb.instances.list
  • alloydb.users.list
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.generateCode
  • serviceusage.services.get oder serviceusage.services.list

Sie können diese Berechtigung über die Rolle roles/alloydb.admin erhalten. Wenn Sie diese Rolle nicht haben, wenden Sie sich an einen Organisationsadministrator, um Zugriff anzufordern. Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Achten Sie außerdem darauf, dass Sie Berechtigungen auf Datenbankebene für die Datenbank haben, die Sie zur Authentifizierung 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, müssen Sie auf AktualisierenAktualisieren klicken, um Ihr Schema vor der Verwendung von Gemini zu aktualisieren.

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

  1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB.

  4. Wählen Sie eine Datenbank und einen Nutzer aus und geben Sie das Passwort des Nutzers ein.

  5. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

  6. Klicken Sie zum Abfragen der Datenbank auf Neuer SQL-Editor-Tab. Prüfen Sie, ob die SQL-Generierung aktiviert ist.

  7. 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 die Eingabetaste 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'

  8. 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. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB.

  4. Wählen Sie eine Datenbank und einen Nutzer aus und geben Sie das Passwort des Nutzers ein.

  5. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

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

  7. Klicken Sie neben dem Abfrageeditor auf pen_spark Hilfe beim Programmieren.

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

  9. 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 Abfragen in natürlicher Sprache eingeben, um Erklärungen von SQL-Abfragen anzufordern. Diese Erklärungen können Ihnen helfen, die Syntax, das zugrunde liegende Schema und den Geschäftskontext für komplexe oder lange Abfragen zu verstehen.

  1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB.

  4. Wählen Sie eine Datenbank und einen Nutzer aus und geben Sie das Passwort des Nutzers ein.

  5. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

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

  7. Fügen Sie die Abfrage in den Abfrageeditor ein.

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

    Die Erklärung der SQL-Abfrage wird im Fenster Chat von Gemini angezeigt.

Gemini zum Beheben von Fehlern in Abfragen verwenden

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

Die KI-basierten Funktionen von Gemini sind in den Abfrageeditor integriert und bieten folgende 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 wird bereitgestellt.
  • Es wird auf die genaue Fehlermeldung und die mit der Anfrage verknüpften Schemainformationen verwiesen, um genaue und relevante Korrekturen zu liefern.
  • 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.
  • Bietet eine schnellere und effizientere Fehlerbehebung bei häufigen Problemen wie Syntax-, Schema- und Laufzeitfehlern.

Erforderliche Berechtigungen

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

Anfrage mit Gemini korrigieren

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

  1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB for PostgreSQL.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Wählen Sie eine Datenbank und einen Nutzer aus und geben Sie das Passwort des Nutzers ein.

  5. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

  6. Klicken Sie in der Taskleiste auf pen_sparkGemini, um Gemini-Funktionen in AlloyDB aufzurufen.

  7. Klicken Sie zum Abfragen Ihrer Datenbank auf Neuer Tab.

  8. Geben Sie im Abfrageeditor eine Abfrage ein, die möglicherweise falsch oder unvollständig ist.

  9. Klicken Sie auf Ausführen.

    Wenn die Abfrage ein Problem enthält, wird auf dem Tab Ergebnisse ein Fehler zurückgegeben.

  10. Klicken Sie auf Korrigieren.

    Im Abfragefenster wird auf dem Tab ein Differenzeditor geöffnet, in dem die vorhandene Abfrage zeilenweise mit den empfohlenen Änderungen verglichen wird. Der Abfrageeditor bietet auch eine Zusammenfassung der vorgeschlagenen Änderungen.

  11. Überprüfen Sie die vorgeschlagenen Änderungen an der Abfrage und aktualisieren Sie sie bei Bedarf.

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

Beschränkungen

Nächste Schritte