Abfragen mit Unterstützung durch Gemini schreiben

In diesem Dokument wird beschrieben, wie Sie die KI-basierte Unterstützung in Gemini in BigQuery verwenden können, um Ihre Daten mit SQL-Abfragen und Python-Code abzufragen. Gemini in BigQuery kann Abfragen und Code generieren und erklären, Abfragen und Code während der Eingabe vervollständigen und Codefehler beheben.

---

Eine detaillierte Anleitung dazu finden Sie direkt in der Google Cloud Console. Klicken Sie dazu einfach auf Anleitung:

Anleitung

---

Gemini für Google Cloud verwendet Ihre Prompts und die Antworten darauf nicht ohne Ihre ausdrückliche Erlaubnis zum Trainieren seiner Modelle. Weitere Informationen dazu, wie Google Ihre Daten verwendet, finden Sie unter So verwendet Gemini für Google Cloud Ihre Daten.

Nur Prompts auf Englisch werden für Gemini in BigQuery unterstützt.

Dieses Dokument richtet sich an Datenanalysten, Data Scientists und Datenentwickler, die mit SQL-Abfragen und Colab Enterprise-Notebooks in BigQuery arbeiten. Dabei wird davon ausgegangen, dass Sie wissen, wie Sie Daten in der BigQuery Studio-Umgebung abfragen oder wie Sie mit Python-Notebooks BigQuery-Daten analysieren.

Hinweise

1. Achten Sie darauf, dass Gemini in BigQuery für Ihr Google Cloud -Projekt eingerichtet ist. Dieser Schritt wird normalerweise von einem Administrator ausgeführt. Gemini in BigQuery-Funktionen sind möglicherweise deaktiviert oder nicht verfügbar, bis Sie die verbleibenden Schritte in diesem Abschnitt ausführen.
2. Wenn Sie Gemini Cloud Assist verwenden möchten, um Code im Bereich „Gemini Cloud Assist“ zu schreiben, müssen Sie auch die Schritte unter Gemini Cloud Assist einrichten ausführen.

3. Wenn Sie Gemini verwenden möchten, um Python-Code in Ihren Colab Enterprise-Notebooks in BigQuery zu erklären und zu korrigieren, müssen Sie auch die Schritte unter Gemini in Colab Enterprise für ein Projekt einrichten ausführen.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

5. Öffnen Sie in der Google Cloud Console die Seite BigQuery Studio.

   Zu BigQuery Studio

6. Klicken Sie in der BigQuery-Symbolleiste auf pen_sparkarrow_drop_downGemini.

   

7. Prüfen Sie, ob in der Liste der Funktionen die folgenden Funktionen ausgewählt sind:

   • Liste Gemini in SQL-Abfrage:

     • Automatische Vervollständigung (Vorabversion) Während Sie im Abfrageeditor tippen, kann Gemini logische nächste Schritte vorschlagen, die für den Kontext der aktuellen Abfrage relevant sind, oder Ihnen bei der Iteration einer Abfrage helfen.
     • Automatische Generierung: Sie können Gemini in BigQuery mit einem Kommentar in natürlicher Sprache im BigQuery-Abfrageeditor auffordern, eine SQL-Abfrage zu generieren.
     • SQL-Generierungstool. Sie können Text in natürlicher Sprache in ein Tool eingeben, um eine SQL-Abfrage zu generieren. Mit Optionen können Sie Abfrageergebnisse verfeinern, Tabellenquellen auswählen und Ergebnisse vergleichen.
     • Erklärung: Sie können Gemini in BigQuery auffordern, eine SQL-Abfrage in natürlicher Sprache zu erklären.

   • Liste Gemini in Python-Notebook:

     • Codevervollständigung (Vorabversion) Gemini bietet kontextrelevante Empfehlungen, die auf dem Inhalt des Notebooks basieren.
     • Codegenerierung: Sie können Gemini mit einer Anweisung oder Frage in natürlicher Sprache auffordern, um Python-Code zu generieren.

8. Zum Ausführen der Aufgaben in diesem Dokument benötigen Sie die erforderlichen IAM-Berechtigungen (Identity and Access Management).

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, um die Berechtigungen zu erhalten, die Sie zum Schreiben von Abfragen mit Gemini-Unterstützung benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen von Abfragen mit Gemini-Unterstützung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Abfragen mit Gemini-Unterstützung zu schreiben:

• cloudaicompanion.entitlements.get
• cloudaicompanion.instances.completeTask
• SQL-Abfragen erklären: cloudaicompanion.companions.generateChat
• Vervollständigen von SQL- oder Python-Code: cloudaicompanion.instances.completeCode
• So generieren Sie SQL- oder Python-Code: cloudaicompanion.instances.generateCode

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Weitere Informationen zu IAM-Rollen und Berechtigungen in BigQuery finden Sie unter Einführung in IAM.

Eine SQL-Abfrage generieren

Um eine SQL-Abfrage anhand des Schemas Ihrer Daten zu generieren, können Sie Gemini in BigQuery mit einer Aussage oder Frage in natürlicher Sprache (auch bekannt als als Prompt) bereitstellen. Selbst wenn Sie ohne Code, mit einer begrenzten Kenntnis des Datenschemas oder nur mit Grundkenntnissen der GoogleSQL-Syntax beginnen, kann Gemini in BigQuery SQL generieren, das Ihnen helfen kann, Ihre Daten zu untersuchen.

SQL-Generierungstool verwenden

Mit dem SQL-Generierungstool können Sie eine SQL-Abfrage zu Ihren zuletzt angesehenen oder abgefragten Tabellen in natürlicher Sprache generieren. Sie können das Tool auch verwenden, um eine vorhandene Abfrage zu ändern und die Tabellen, für die Sie SQL generieren möchten, manuell anzugeben.

So verwenden Sie das SQL-Generierungstool:

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

   Zu BigQuery Studio

2. Klicken Sie neben dem Abfrageeditor auf das SQL-Generierungstool pen_spark.

   

3. Geben Sie im Dialogfeld SQL mit Gemini generieren einen Prompt in natürlicher Sprache zu einer Tabelle ein, die Sie kürzlich angesehen oder abgefragt haben. Wenn Sie sich beispielsweise vor Kurzem die Tabelle bigquery-public-data.austin_bikeshare.bikeshare_trips angesehen haben, könnten Sie Folgendes eingeben:

    Show me the duration and subscriber type for the ten longest trips.
   

4. Klicken Sie auf Erstellen.

   Die generierte SQL-Abfrage sieht in etwa so aus:

   SELECT
       subscriber_type,
       duration_sec
     FROM
         `bigquery-public-data.san_francisco_bikeshare.bikeshare_trips`
   ORDER BY
       duration_sec DESC
   LIMIT 10;
   

5. Prüfen Sie die generierte SQL-Abfrage und führen Sie eine der folgenden Aktionen aus:

   • Um die generierte SQL-Abfrage zu akzeptieren, klicken Sie auf Einfügen. Dadurch fügen Sie die Anweisung in den Abfrageeditor ein. Klicken Sie dann auf Ausführen, um die vorgeschlagene SQL-Abfrage auszuführen.
   • Klicken Sie zum Bearbeiten der Prompts auf Bearbeiten und ändern oder ersetzen Sie dann die erste Prompt. Nachdem Sie den Prompt bearbeitet haben, klicken Sie auf Aktualisieren, um eine neue Abfrage zu generieren.
   • Klicken Sie auf Tabellenquellen bearbeiten, die als Kontext zum Generieren der vorgeschlagenen SQL-Abfrage verwendet wurden, wählen Sie die entsprechenden Kästchen aus und klicken Sie dann auf Anwenden.
   • Klicken Sie auf Abfragezusammenfassung, um eine Zusammenfassung der generierten Abfrage in natürlicher Sprache aufzurufen.
   • Wenn Sie die vorgeschlagene SQL-Abfrage verfeinern möchten, geben Sie Suchfilter in das Feld Verfeinern ein und klicken Sie dann auf send Verfeinern. Geben Sie beispielsweise limit to 1000 ein, um die Anzahl der Abfrageergebnisse zu begrenzen. Wenn Sie die Änderungen an Ihrer Abfrage vergleichen möchten, klicken Sie das Kästchen Diff-Anzeige an.
   • Wenn Sie einen vorgeschlagenen Prompt schließen möchten, schließen Sie das SQL-Generierungstool.

SQL-Generierungstool deaktivieren

Informationen zum Deaktivieren des SQL-Generierungstools finden Sie unter Funktionen des Gemini-Abfrageassistenten deaktivieren.

SQL aus einem Kommentar generieren

Sie können SQL im Abfrageeditor generieren, indem Sie die gewünschte Abfrage in einem Kommentar beschreiben.

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

   Zu BigQuery Studio

2. Klicken Sie im Abfrageeditor auf add_boxSQL-Abfrage.

3. Schreiben Sie im Abfrageeditor einen SQL-Kommentar zu einer Tabelle, die Sie vor Kurzem angesehen oder abgefragt haben. Wenn Sie sich beispielsweise vor Kurzem die Tabelle bigquery-public-data.austin_bikeshare.bikeshare_trips angesehen haben, könnten Sie den folgenden Kommentar schreiben:

   # Show me the duration and subscriber type for the ten longest trips.
   

4. Drücken Sie die Eingabetaste (Return unter macOS).

   Die vorgeschlagene SQL-Abfrage sieht in etwa so aus:

   # Show me the duration and subscriber type for the ten longest trips
   
   SELECT
     duration_sec,
     subscriber_type
     AVG(duration_minutes) AS average_trip_length
   FROM
     `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   ORDER BY
     duration_sec
   LIMIT 10;
   

5. Drücken Sie die Tabulatortaste, um den Vorschlag zu akzeptieren.

SQL-Abfrage mit Gemini Cloud Assist generieren

Sie können im Bereich Cloud Assist in der Google Cloud Console eine SQL-Abfrage in BigQuery generieren.

Bevor Sie SQL-Abfragen mit dem Gemini Cloud Assist-Chat generieren können, müssen Sie Gemini Cloud Assist aktivieren. Weitere Informationen finden Sie unter Gemini Cloud Assist einrichten.

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

   Zu BigQuery Studio

2. Klicken Sie im Abfrageeditor auf add_boxSQL-Abfrage, um eine neue SQL-Abfrage zu öffnen.

3. Klicken Sie in der Google Cloud -Symbolleiste auf spark Gemini-KI-Chat öffnen oder schließen, um den Gemini Cloud Assist-Chat zu öffnen.

   

4. Geben Sie im Feld Prompt eingeben einen Prompt zum Generieren einer SQL-Abfrage ein. Beispiel:

   Generate a SQL query to show me the duration and subscriber type for the ten longest trips.
   

5. Klicken Sie auf Prompt senden. Die Antwort enthält eine SQL-Abfrage, die in etwa so aussieht:

   SELECT
        subscriber_type,
        duration_sec
    FROM
        `bigquery-public-data.san_francisco_bikeshare.bikeshare_trips`
    ORDER BY
        duration_sec DESC
    LIMIT 10;
    ```
   

6. Prüfen Sie die generierte SQL-Abfrage.

7. Klicken Sie zum Ausführen der SQL-Abfrage auf content_copy In die Zwischenablage kopieren, fügen Sie den generierten Code in den Abfrageeditor ein und klicken Sie dann auf play_circle Ausführen.

Tipps für die SQL-Generierung

Mit den folgenden Tipps lassen sich die Vorschläge von Gemini in BigQuery verbessern:

• Wenn Sie manuell angeben möchten, welche Tabellen verwendet werden sollen, können Sie die voll qualifizierten Tabellennamen in Graviszeichen (`) setzen, zum Beispiel `PROJECT.DATASET.TABLE`.
• Wenn die Spaltennamen oder ihre semantischen Beziehungen unklar oder komplex sind, können Sie im Prompt Kontext bereitstellen, um Gemini zur gewünschten Antwort zu führen. Wenn Sie beispielsweise möchten, dass eine generierte Abfrage auf einen Spaltennamen verweist, beschreiben Sie den Spaltennamen und seine Relevanz für die gewünschte Antwort. Um eine Antwort zu erhalten, die sich auf komplexe Begriffe wie Lifetime-Wert oder Handelsspanne bezieht, beschreiben Sie das Konzept und seine Relevanz für Ihre Daten, um die Ergebnisse der SQL-Generierung zu verbessern.
• Wenn Sie SQL aus einem Kommentar generieren, können Sie den Prompt über mehrere Zeilen hinweg formatieren, indem Sie jeder Zeile das Zeichen # voranstellen.
• Spaltenbeschreibungen werden beim Generieren von SQL-Abfragen berücksichtigt. Fügen Sie Ihrem Schema Spaltenbeschreibungen hinzu, um die Genauigkeit zu verbessern. Weitere Informationen zu Spaltenbeschreibungen finden Sie unter Spaltenbeschreibungen im Abschnitt „Schema angeben“.

SQL-Abfrage abschließen

Die SQL-Vervollständigung versucht, kontextrelevante Empfehlungen zu geben, die auf dem Inhalt des Query Editors basieren. Während der Eingabe kann Gemini logische nächste Schritte vorschlagen, die für den Kontext der aktuellen Abfrage relevant sind, oder Ihnen bei der Iteration einer Abfrage helfen.

So testen Sie die SQL-Vervollständigung mit Gemini in BigQuery:

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

   Zu BigQuery Studio

2. Kopieren Sie im Abfrageeditor Folgendes:

   SELECT
     subscriber_type
     , EXTRACT(HOUR FROM start_time) AS hour_of_day
     , AVG(duration_minutes) AS avg_trip_length
   FROM
     `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   

   Eine Fehlermeldung besagt, dass subscriber_type weder gruppiert noch aggregiert wird. Es ist nicht ungewöhnlich, dass Sie Hilfe bei der richtigen Abfrage benötigen.

3. Drücken Sie am Ende der Zeile für subscriber_type die Leertaste.

   Die vorgeschlagenen Verfeinerungen der Abfrage könnten in etwa so lauten:

   GROUP BY
     subscriber_type, hour_of_day;
   

   Sie können auch die Eingabetaste (Return unter macOS) drücken, um Vorschläge zu generieren.

4. Um den Vorschlag anzunehmen, drücken Sie die Tabulatortaste oder halten Sie den Mauszeiger über den vorgeschlagenen Text und klicken Sie auf alternative Vorschläge. Drücken Sie ESC oder fahren Sie mit der Eingabe fort, um einen Vorschlag zu verwerfen.

   

SQL-Abfrage erklären

Sie können Gemini in BigQuery auffordern, eine SQL-Abfrage in natürlicher Sprache zu erklären. Diese Erklärung kann Ihnen helfen, eine Abfrage zu verstehen, deren Syntax, das zugrunde liegende Schema und der geschäftliche Kontext aufgrund der Länge oder Komplexität der Abfrage möglicherweise schwer zu beurteilen sind.

So erhalten Sie eine Erklärung zu einer SQL-Abfrage:

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

   Zu BigQuery Studio

2. Öffnen Sie im Abfrageeditor eine Abfrage, die Sie erklärt haben möchten, oder fügen Sie sie ein.

3. Markieren Sie die Abfrage, die Gemini in BigQuery erklären soll.

4. Klicken Sie auf astrophotography_mode Gemini und dann auf Diese Abfrage erklären.

   

   Die Erklärung der SQL-Abfrage wird im Bereich Cloud angezeigt.

Python-Code generieren

Sie können Gemini in BigQuery auffordern, mit einer Anweisung oder Frage in natürlicher Sprache Python-Code zu generieren. Gemini in BigQuery antwortet mit einem oder mehreren Python-Codevorschlägen, wobei relevante Tabellennamen direkt aus Ihrem BigQuery-Projekt abgerufen werden. So erhalten Sie personalisierten, ausführbaren Python-Code.

Tool für die Python-Codegenerierung verwenden

Im folgenden Beispiel generieren Sie Code für ein öffentliches BigQuery-Dataset, bigquery-public-data.ml_datasets.penguins.

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

   Zu BigQuery Studio

2. Klicken Sie in der Tableiste des Abfrageeditors auf den arrow_drop_downDrop-down-Pfeil neben add_box SQL-Abfrage und dann auf Notebook.

   Das neue Notebook wird geöffnet und enthält Zellen, die Beispielabfragen für das öffentliche Dataset bigquery-public-data.ml_datasets.penguins zeigen.

3. Klicken Sie in der Symbolleiste auf add Code, um eine neue Codezelle einzufügen. Die neue Codezelle enthält die Meldung Start coding or generate with AI (Mit dem Programmieren beginnen oder mit KI generieren).

4. Klicken Sie in der neuen Codezelle auf Generieren.

5. Geben Sie im Editor Generieren den folgenden Natural Language Prompt ein:

   Using bigquery magics, query the `bigquery-public-data.ml_datasets.penguins` table
   

6. Drücken Sie die Eingabetaste (Return unter macOS).

   Der vorgeschlagene Python-Code sieht in etwa so aus:

   %%bigquery
   SELECT *
   FROM `bigquery-public-data.ml_datasets.penguins`
   LIMIT 10
   

7. Drücken Sie zum Ausführen des Codes auf play_circle Zelle ausführen.

Python-Code mit Gemini Cloud Assist generieren

Sie können Gemini Cloud Assist in der Google Cloud Console verwenden, um Python-Code in BigQuery zu generieren. Bevor Sie mit Gemini Cloud Assist Code generieren können, müssen Sie Gemini Cloud Assist aktivieren. Weitere Informationen finden Sie unter Gemini Cloud Assist einrichten.

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

   Zu BigQuery Studio

2. Klicken Sie in der Tableiste des Abfrageeditors auf den arrow_drop_downDrop-down-Pfeil neben add_box SQL-Abfrage und dann auf Notebook.

3. Klicken Sie in der Google Cloud -Symbolleiste auf spark Gemini-KI-Chat öffnen oder schließen, um den Gemini Cloud Assist-Chat zu öffnen.

   

4. Geben Sie im Feld Prompt eingeben einen Prompt zum Generieren von Python-Code ein. Beispiel:

   Generate python code to query the `bigquery-public-data.ml_datasets.penguins`
   table using bigquery magics
   
   

5. Klicken Sie auf send Anfrage senden. Gemini gibt Python-Code zurück, der in etwa so aussieht:

   %%bigquery
   SELECT *
   FROM `bigquery-public-data.ml_datasets.penguins`
   LIMIT 10
   

6. Sehen Sie sich den generierten Python-Code an.

7. Klicken Sie zum Ausführen des Python-Codes auf content_copy In die Zwischenablage kopieren, fügen Sie den generierten Code in den Abfrageeditor ein und klicken Sie dann auf play_circle Ausführen.

BigQuery DataFrames-Code generieren

Sie können mit Gemini in BigQuery Code für BigQuery DataFrames generieren. Wenn Sie Gemini auffordern möchten, BigQuery DataFrames im generierten Code zu verwenden, müssen Sie Ihre Absicht in Ihrem Prompt angeben. Sie können Ihren Prompt beispielsweise mit „using bigframes“ oder „utilizing BigQuery DataFrames“ beginnen.

BigQuery DataFrames bietet zwei Bibliotheken:

• bigframes.pandas bietet eine mit Pandas kompatible API für Analysen.
• bigframes.ml bietet eine scikit-learn-ähnliche API für maschinelles Lernen (ML).

Die Codegenerierung von Gemini ist für die bigframes.pandas-Bibliothek optimiert.

Weitere Informationen zu BigQuery DataFrames und den Berechtigungen, die für die Verwendung von BigQuery DataFrames erforderlich sind, finden Sie unter BigQuery DataFrames-Berechtigungen. BigQuery DataFrames ist ein Open-Source-Paket. Sie können pip install --upgrade bigframes ausführen, um die neueste Version zu installieren.

Im folgenden Beispiel generieren Sie Code für ein öffentliches BigQuery-Dataset, bigquery-public-data.ml_datasets.penguins.

1. Rufen Sie in der Google Cloud Console die Seite „BigQuery Studio“ auf.

   Zu BigQuery Studio

2. Klicken Sie in der Tableiste des Abfrageeditors auf den arrow_drop_downDrop-down-Pfeil neben add_box SQL-Abfrage und dann auf Notebook.

   Ein neues Notebook wird geöffnet.

3. Klicken Sie in der Symbolleiste auf add Code, um eine neue Codezelle einzufügen.

4. Die neue Codezelle enthält die Meldung Start coding or generate with AI (Mit dem Programmieren beginnen oder mit KI generieren). Klicken Sie in der neuen Codezelle auf Generieren.

5. Geben Sie im Editor Generieren den folgenden Natural Language Prompt ein:

   Read the penguins table from the BigQuery public data using bigframes
   

6. Drücken Sie die Eingabetaste (Return unter macOS).

   Der vorgeschlagene Python-Code sieht in etwa so aus:

   import bigframes.pandas as bpd
   
   # Read the penguins table from the BigQuery public data using bigframes
   result = bpd.read_gbd("bigquery-public-data.ml_datasets.penguins")
   

7. Drücken Sie zum Ausführen des Codes auf play_circle Zelle ausführen.

8. Wenn Sie sich die Ergebnisse in der Vorschau ansehen möchten, klicken Sie in der Symbolleiste auf add Code, um eine neue Codezelle einzufügen.

9. Rufen Sie in der neuen Zelle die Methode peek() auf, z. B. result.peek(), und drücken Sie play_circle Zelle ausführen. Es wird eine Reihe von Datenzeilen angezeigt.

Vollständiger Python-Code

Die Python-Codevervollständigung versucht, kontextgerechte Empfehlungen zu geben, die auf den Inhalten des Abfrageeditors basieren. Während der Eingabe kann Gemini in BigQuery logische nächste Schritte vorschlagen, die für den Kontext Ihres aktuellen Codes relevant sind, oder Ihnen bei der Iteration Ihres Codes helfen.

So testen Sie die Python-Codevervollständigung mit Gemini in BigQuery:

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

   Zu BigQuery Studio

2. Klicken Sie in der Tableiste des Abfrageeditors auf den arrow_drop_downDrop-down-Pfeil neben add_box SQL-Abfrage und dann auf Notebook.

   Das neue Notebook wird geöffnet und enthält Zellen, die Beispielabfragen für das öffentliche Dataset bigquery-public-data.ml_datasets.penguins zeigen.

3. Beginnen Sie im Editor mit der Eingabe von Python-Code. Beispiel: %%bigquery Gemini in BigQuery schlägt während der Eingabe Code vor.

4. Drücken Sie die Tabulatortaste, um den Vorschlag zu akzeptieren.

Python-Code erklären

Mit Gemini in BigQuery können Sie Python-Code in Ihren Colab Enterprise-Notebooks erläutern lassen.

Nachdem Sie eine Erklärung erhalten haben, können Sie im Prompt-Dialogfeld weitere Fragen stellen, um den Code besser zu verstehen.

So erhalten Sie eine Erklärung für Python-Code in Ihrem Notebook:

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

   Zu BigQuery Studio

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks.

3. Klicken Sie auf das Notebook, das Sie öffnen möchten.

4. Markieren Sie die Python-Zelle, die Sie analysieren möchten.

5. Klicken Sie auf spark Gemini und dann auf Code erklären.

   Die Codeerklärung wird in einem Bereich neben der Zelle angezeigt.

6. Optional: Wenn Sie mehr über Ihren Code erfahren möchten, können Sie im Feld Prompt hier eingeben Fragen stellen.

Python-Fehler beheben und erklären

Mit Gemini in BigQuery können Sie Python-Codefehler in Ihren Colab Enterprise-Notebooks beheben und erklären lassen.

So beheben oder verstehen Sie die Codefehler mit Gemini:

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

   Zu BigQuery Studio

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Notebooks.

3. Klicken Sie auf das Notebook, das Sie öffnen möchten.

4. Geben Sie in einer Codezelle Ihres Notebooks Code ein, der einen Fehler enthält, und führen Sie die Zelle dann aus. Sie könnten beispielsweise print(1 eingeben, wobei eine schließende Klammer fehlt.

   Nachdem die Codezelle ausgeführt wurde, wird im Notebook unter der Codezelle eine Fehlermeldung ausgegeben. Wenn Sie Gemini in Python-Notebooks aktiviert haben und Gemini einen Vorschlag zur Behebung oder Erklärung des Fehlers hat, wird eine der folgenden Optionen angezeigt:

   • Bei Python-Syntaxfehlern wird die Option Fehler beheben angezeigt.
   • Bei allen anderen Fehlertypen wird die Option Fehler erläutern angezeigt.

5. So beheben Sie einen Syntaxfehler:

   1. Klicken Sie auf Fehler beheben.

      Gemini schlägt vor, wie der Fehler behoben werden kann.

   2. Sehen Sie sich den Vorschlag an und führen Sie einen der folgenden Schritte aus:

      • Klicken Sie auf  Vorschlag übernehmen, um den Vorschlag zu akzeptieren.
      • Wenn Sie den Vorschlag ablehnen möchten, klicken Sie auf Schließen Vorschlag ablehnen.

6. So beheben Sie alle anderen Arten von Fehlern:

   1. Klicken Sie auf Fehler erläutern.

      Ein Feld wird geöffnet, in dem der Fehler erläutert und Änderungen vorgeschlagen werden.

   2. Optional: Wenn Sie den Fehler besser verstehen möchten, können Sie im Feld Geben Sie hier einen Prompt ein Fragen stellen.

   3. Wenn Sie eine vorgeschlagene Änderung übernehmen möchten, klicken Sie auf library_add Codezelle hinzufügen.

PySpark-Code generieren

Sie können Gemini Code Assist bitten, PySpark-Code in Ihrem Notebook zu generieren. Gemini Code Assist ruft relevante BigQuery- und Dataproc Metastore-Tabellen und deren Schemas ab und verwendet sie, um eine Codeantwort zu generieren. Dank seines Schemawissens vermeidet Gemini Code Assist Halluzinationen und schlägt Join-Schlüssel und Spaltentypen vor.

So generieren Sie Gemini Code Assist-Code in Ihrem Notebook:

1. Fügen Sie eine neue Codezelle ein, indem Sie in der Symbolleiste auf + Code klicken. In der neuen Codezelle wird Start coding or generate with AI angezeigt. Klicken Sie auf Generieren.

2. Geben Sie im Editor für die Generierung einen Natural Language Prompt ein und klicken Sie auf enter. Achten Sie darauf, dass Sie in Ihrem Prompt das Keyword spark oder pyspark verwenden.

   Beispiel-Prompt:

   create a spark dataframe from order_items and filter to orders created in 2024
   

   Beispielausgabe:

   spark.read.format("bigquery").option("table", "sqlgen-testing.pysparkeval_ecommerce.order_items").load().filter("year(created_at) = 2024").createOrReplaceTempView("order_items")
   df = spark.sql("SELECT * FROM order_items")
   

Tipps zur Codeerstellung mit Gemini Code Assist

• Damit Gemini Code Assist relevante Tabellen und Schemas abrufen kann, aktivieren Sie die Data Catalog-Synchronisierung für Dataproc Metastore-Instanzen.

• Ihr Nutzerkonto muss Zugriff auf den Data Catalog und die Abfragetabellen haben. Weisen Sie dazu die Rolle DataCatalog.Viewer zu.

Funktionen des Gemini-Abfrageassistenten deaktivieren

So deaktivieren Sie bestimmte Funktionen in Gemini in BigQuery:

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

   Zu BigQuery Studio

2. Klicken Sie in der BigQuery-Symbolleiste auf pen_sparkarrow_drop_downGemini.

   

3. Entfernen Sie in der Liste die Häkchen bei den Abfrageassistenten-Funktionen, die Sie deaktivieren möchten.

Informationen zum Deaktivieren von Gemini in BigQuery finden Sie unter Gemini in BigQuery deaktivieren.

Gemini in Colab Enterprise deaktivieren

Wenn Sie Gemini in Colab Enterprise für ein Google Cloud-Projekt deaktivieren möchten, muss ein Administrator die Gemini for Google Cloud API deaktivieren. Weitere Informationen finden Sie unter Dienste deaktivieren.

Wenn Sie Gemini in Colab Enterprise für einen bestimmten Nutzer deaktivieren möchten, muss ein Administrator die Rolle Gemini for Google Cloud User (roles/cloudaicompanion.user) für diesen Nutzer widerrufen. Weitere Informationen finden Sie unter Einzelne IAM-Rolle widerrufen.

Feedback geben

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

   Zu BigQuery Studio

2. Klicken Sie in der BigQuery-Symbolleiste auf pen_sparkarrow_drop_downGemini.

   

3. Klicken Sie auf Feedback senden.

Vorschläge zur Verbesserung der Vorschläge

Sie können zur Verbesserung der Gemini-Vorschläge beitragen, indem Sie die Prompt-Daten, die Sie an Funktionen in der Vorabversion senden, mit Google teilen.

So geben Sie Ihre Prompt-Daten frei:

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

   Zu BigQuery Studio

2. Klicken Sie in der BigQuery-Symbolleiste auf pen_sparkarrow_drop_downGemini.

   

3. Wählen Sie Daten weitergeben, um Gemini in BigQuery zu verbessern aus.

4. Aktualisieren Sie im Dialogfeld Einstellungen für die Datennutzung Ihre Einstellungen für die Datennutzung.

Datenfreigabeeinstellungen gelten für das gesamte Projekt und können nur von einem Projektadministrator mit den IAM-Berechtigungen serviceusage.services.enable und serviceusage.services.list festgelegt werden. Weitere Informationen zur Datennutzung im Trusted Tester-Programm finden Sie unter Gemini for Google Cloud Trusted Tester Program.

Gemini- und BigQuery-Daten

Um genaue Ergebnisse zu liefern, benötigt Gemini in BigQuery für erweiterte Funktionen Zugriff auf Ihre Kundendaten und Metadaten in BigQuery. Weitere Informationen finden Sie unter So verwendet Gemini in BigQuery Ihre Daten.

Preise

Weitere Informationen zu den Preisen für diese Funktion finden Sie unter Preisübersicht für Gemini in BigQuery.

Kontingente und Limits

Informationen zu Kontingenten und Limits für diese Funktion finden Sie unter Kontingente für Gemini in BigQuery.

Nächste Schritte

• Gemini für Google Cloud  – Übersicht
• Weitere Informationen dazu, wie Gemini für Google Cloud Ihre Daten verwendet
• Data Insights in BigQuery generieren