BigQuery API-Abhängigkeiten verwalten

In diesem Dokument werden die Google Cloud Dienste und APIs beschrieben, auf die BigQuery angewiesen ist. Außerdem werden die Auswirkungen auf das Verhalten von BigQuery erläutert, wenn Sie diese Dienste deaktivieren. Lesen Sie dieses Dokument, bevor Sie Dienste in Ihrem Projekt aktivieren oder deaktivieren.

Einige Dienste sind standardmäßig in jedem von Ihnen erstellten Google Cloud Projekt aktiviert. Andere APIs werden automatisch für alle Google Cloud Projekte aktiviert, in denen BigQuery verwendet wird. Die übrigen Dienste müssen explizit aktiviert werden, bevor Sie ihre Funktionen nutzen können. Weitere Informationen finden Sie in den folgenden Ressourcen:

Dieses Dokument richtet sich an Administratoren.

Standardmäßig aktivierte Dienste

Die folgenden Dienste sind für jedes neueGoogle Cloud -Projekt standardmäßig aktiviert:

Dienst Welche Funktionen darauf angewiesen sind Folgen der Deaktivierung dieses Dienstes
analyticshub.googleapis.com
  • Sie können keine Datenplattformen, Einträge, Data-Clean-Rooms oder Abos erstellen oder verwalten.
  • Sie können keine Anzeigenplattformen oder Einträge anderer Anbieter suchen und ansehen.
  • Erstellte Abos bleiben erhalten, sind aber nicht zugänglich.
  • Auf verknüpfte Datensätze kann zugegriffen werden, solange die BigQuery API aktiviert ist.
  • Sie können keine neuen Abos erstellen.
bigqueryconnection.googleapis.com
  • Externe Verbindungen können nicht verwaltet werden.
  • Sie können keine Remote-Modelle erstellen.
  • Sie können keine Remote-Funktionen erstellen.
  • BigLake-Tabellen und Objekttabellen können nicht abgefragt werden.
bigquerymigration.googleapis.com
  • Sie können keine Migrationsaufgaben oder ‑bewertungen erstellen.
  • Vorhandene Aufgaben oder Bewertungen sind nicht verfügbar.

Hinweis:Normalerweise können Sie diesen Dienst nach Abschluss der Datenmigration deaktivieren.

bigquerydatapolicy.googleapis.com
  • Sie können Ihre Datenmaskierungsrichtlinien nicht verwalten.
  • Datenmaskierungsrichtlinien werden nicht gelöscht, aber Abfragen auf Tabellen mit angewendeter Datenmaskierung schlagen fehl.
bigqueryreservation.googleapis.com
  • Sie können keine Kapazitätszusicherungen, Reservierungen oder Zuweisungen erstellen oder verwalten.
  • Die Slotnutzung kann nicht überwacht werden.
  • Das Failover für die Notfallwiederherstellung ist nicht verfügbar.
  • Das Slot-Autoscaling wird beendet.
bigquerystorage.googleapis.com
dataform.googleapis.com
  • Sie können keine Pipelines, gespeicherten Abfragen, Colab-Notebooks, Data Canvases, Datenvorbereitungen oder Dataform-Projekte erstellen.
  • Vorhandene geplante Pipelines, Notebooks oder Dataform-Projekte werden angehalten.
  • Auf vorhandene Pipelines, gespeicherte Abfragen, Colab-Notebooks, Data Canvases, Datenvorbereitungen oder Dataform-Projekte kann dann nicht mehr zugegriffen werden.
dataplex.googleapis.com
  • Die Suche nach BigQuery-Daten-Assets ist nicht verfügbar.
  • Die Suche nach Einträgen kann nicht geteilt werden.
  • Sie können keine neuen Statistiken, Datenqualitätsscans oder Suchanfragevorschläge für Profile erstellen oder auf zuvor erstellte Profile zugreifen.
  • In einem Herkunftsdiagramm sind keine Details zu Daten-Assets zu sehen.
  • Im Datencanvas können Sie nicht nach Datenassets suchen.

Von der BigQuery Unified API aktivierte Dienste

Die BigQuery Unified API (bigqueryunified.googleapis.com) umfasst eine ausgewählte Sammlung von Diensten, die für die Funktion verschiedener BigQuery-Funktionen erforderlich sind. Wenn Sie die BigQuery Unified API aktivieren, werden alle diese Dienste gleichzeitig aktiviert. Google kann die Dienste in dieser Sammlung aktualisieren. Diese Dienste werden in Projekten, in denen diese API aktiviert ist, automatisch aktiviert. Sie können einzelne Dienste und APIs deaktivieren.

Eine Anleitung zum Aktivieren von bigqueryunified.googleapis.com finden Sie unter Dienste aktivieren und deaktivieren.

Dienst Welche Funktionen darauf angewiesen sind Folgen der Deaktivierung dieses Dienstes
aiplatform.googleapis.com
  • Sie können Ihre Notebooks nicht mehr ausführen.
  • Vorhandene BigQuery ML-Remote-Modelle funktionieren nicht mehr.
  • Sie können Ihre vorhandenen Notizen weiterhin bearbeiten.
bigqueryunified.googleapis.com
  • Ermöglicht die Aktivierung der in diesem Dokument aufgeführten BigQuery-abhängigen Dienste mit nur einem Klick, mit Ausnahme der APIs cloudaicompanion, composer und datalineage.
  • Sorgt dafür, dass neue BigQuery-Abhängigkeiten in Ihrem Projekt aktiviert sind.
  • Zukünftige Abhängigkeiten werden in Ihrem Projekt nicht automatisch aktiviert.
compute.googleapis.com
  • Die Google Compute Engine bietet eine Laufzeitumgebung für alle Funktionen von Dataproc und Vertex AI.
  • Colab-Notebooks, Remote-ML-Modelle sowie Apache Spark-, SparkSQL- und PySpark-Jobs werden beendet.
  • Der Quellcode bleibt verfügbar.
  • Die Dataproc API wird deaktiviert.
dataproc.googleapis.com
  • Sie können keine Dataproc-Cluster zum Ausführen von Open-Source-Datenanalysen erstellen.
  • Sie können keine serverlosen Dataproc-Arbeitslasten ausführen.
  • Sie können Spark nicht in BigQuery-Arbeitslasten ausführen.
datastream.googleapis.com
  • Alle Datenstreams sind pausiert und nicht zugänglich.

Standardmäßig deaktivierte Dienste

Sie müssen die folgenden Dienste manuell aktivieren, damit die entsprechenden Funktionen verfügbar sind:

Dienst Welche Funktionen darauf angewiesen sind Folgen der Deaktivierung dieses Dienstes
cloudaicompanion.googleapis.com
  • Funktionen von Gemini in BigQuery
composer.googleapis.com
  • Vorhandene Cloud Composer-DAGs werden auf der Seite „Planung“ nicht aufgeführt und beendet.
  • Vorhandene Cloud Composer-Umgebungen werden nicht mehr unterstützt, funktionieren nicht mehr und geben einen Fehlerstatus zurück.
datalineage.googleapis.com
  • Die Datenherkunft wird für Ihr Projekt nicht erfasst.
  • Sie können das Stammbaumdiagramm nicht aufrufen.

BigQuery-Code-Assets manuell aktivieren

Wenn Sie Code-Assets wie Notebooks und gespeicherte Abfragen in BigQuery verwalten möchten, müssen Sie die folgenden APIs aktivieren:

  • Die Compute Engine API
  • Die Dataform API
  • Die Vertex AI API

Vor März 2024 wurden diese APIs nicht automatisch standardmäßig aktiviert. Wenn Sie Automatisierungsscripts von vor März 2024 haben, die vom Status dieser APIs abhängen, müssen Sie sie möglicherweise aktualisieren. Wenn Sie diese APIs bereits aktiviert haben, werden im Bereich Explorer in BigQuery die neuen Ordner Notebooks und Abfragen angezeigt.

Hinweise

Wenn Sie die Verwaltung von Code-Assets manuell aktivieren möchten, benötigen Sie die IAM-Rolle Inhaber (roles/owner) (Identity and Access Management).

BigQuery-Code-Assets manuell aktivieren

So aktivieren Sie die erforderlichen API-Abhängigkeiten für Code-Assets:

  1. Rufen Sie die Seite BigQuery auf.

    BigQuery aufrufen

  2. Klicken Sie in Studio in der Tableiste des Editorbereichs auf den Drop-down-Pfeil  neben dem +-Zeichen, bewegen Sie den Mauszeiger auf Notebook und wählen Sie dann BigQuery-Vorlage aus.

  3. Klicken Sie im Banner, das unter der Tableiste des Editorbereichs angezeigt wird, auf Aktivieren.

    Wenn das Dialogfeld nicht angezeigt wird, prüfen Sie, ob Sie die erforderliche IAM-Rolle Inhaber haben.

  4. Führen Sie im Bereich Features aktivieren im Abschnitt Kernfeature-APIs folgende Schritte aus:

    1. Klicken Sie unter Versionsverlauf und Freigabe auf Aktivieren, um den Versionsverlauf und die Freigabe von Code-Assets zu aktivieren.
    2. Klicken Sie unter Python-Notebooks auf Alle aktivieren, um Notebooks zu aktivieren.
    3. Wenn die APIs aktiviert wurden, klicken Sie auf Weiter.
  5. Optional: Legen Sie die Nutzerberechtigungen im Abschnitt Berechtigungen fest:

    • Wenn Sie Hauptkonten die Möglichkeit geben möchten, Code-Assets zu erstellen und Berechtigungen für die von ihnen erstellten Code-Assets zu lesen, zu bearbeiten und festzulegen, geben Sie ihre Nutzer- oder Gruppennamen in das Feld Ersteller ein.
    • Wenn Sie Hauptkonten die Berechtigung geben, Berechtigungen für alle für sie freigegebenen Code-Assets zu lesen, zu bearbeiten und festzulegen, geben Sie die Nutzer- oder Gruppennamen in das Feld Inhaber ein.
  6. Klicken Sie auf Weiter.

  7. Optional: Klicken Sie im Abschnitt Weitere APIs auf Alle aktivieren, um die APIs zu aktivieren, die Sie benötigen, um BigQuery-Remote-Prozeduren mit BigQuery DataFrames zu erstellen.

  8. Wenn Sie sich entschieden haben, die zusätzlichen APIs nicht zu aktivieren, klicken Sie auf Schließen, um den Bereich Features aktivieren zu schließen.

Zugriff auf Code-Assets einschränken

Sie können die Aktivierung zusätzlicher APIs verhindern, indem Sie die Organisationsrichtlinien-Einschränkung „Ressourcendienstnutzung einschränken“ festlegen. Sie können ausgewählte APIs jederzeit deaktivieren.

Nächste Schritte