BigQuery API-Abhängigkeiten verwalten

Sie können das BigQuery-Verhalten verwalten, indem Sie sich darüber informieren, wie sich die einzelnen APIs auf die Google Cloud -Features auswirken, die von diesen APIs abhängen. Einige API-Dienste sind standardmäßig in jedem von Ihnen erstellten Google Cloud -Projekt aktiviert, während andere automatisch für alle Google Cloud -Projekte aktiviert werden, die BigQuery verwenden. Sie müssen die verbleibenden API-Dienste explizit aktivieren, bevor Sie ihre Funktionen verwenden können.

Das fälschliche Deaktivieren einer Abhängigkeit kann die BigQuery-Funktionalität beeinträchtigen. Wenn Sie diese Abhängigkeiten kennen, können Sie fundierte Entscheidungen treffen, wenn Sie Dienste in Ihrem Google Cloud -Projekt aktivieren oder deaktivieren.

Standardmäßig aktivierte Dienste

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

Dienst	API-Name	Welche Funktionen sind davon abhängig?	Auswirkungen der Deaktivierung dieses Dienstes
BigQuery Sharing	analyticshub.googleapis.com	Datenaustausch veröffentlichen Einträge veröffentlichen und Abos verwalten Data-Clean-Rooms	Sie können keine Datenaustausche, Einträge, Data-Clean-Rooms oder Abos erstellen oder verwalten. Sie können nicht nach Datenaustauschplattformen oder Einträgen suchen, die von anderen Anbietern erstellt wurden. Erstellte Abos bleiben bestehen, sind aber nicht zugänglich. Verknüpfte Datasets sind zugänglich, solange die BigQuery API aktiviert ist. Sie können keine neuen Abos erstellen
BigQuery Connection API	bigqueryconnection.googleapis.com	Föderierte Abfragen für Daten, die außerhalb von BigQuery gespeichert sind Externe Tabellen und Datasets BigQuery-Metastore	Sie können keine externen Verbindungen verwalten. Sie können keine Remote-Modelle erstellen. Sie können keine Remote-Funktionen erstellen. BigLake-Tabellen und Objekttabellen können nicht abgefragt werden.
BigQuery Migration Service	bigquerymigration.googleapis.com	Bewertung der Datenmigration SQL-Abfrageübersetzung	Sie können keine Migrationsaufgaben oder -bewertungen erstellen. Vorhandene Aufgaben oder Prüfungen sind nicht verfügbar. Hinweis: Normalerweise können Sie diesen Dienst nach Abschluss der Datenmigration deaktivieren.
BigQuery-Datenrichtlinie	bigquerydatapolicy.googleapis.com	Datenmaskierung	Sie können Ihre Datenmaskierungsrichtlinien nicht verwalten. Datenmaskierungsrichtlinien werden nicht gelöscht, aber Abfragen an Tabellen mit angewendeter Datenmaskierung schlagen fehl.
BigQuery Data Transfer Service	bigquerydatatransfer.googleapis.com	Geplante Datenübertragungen	Sie können Ihre geplanten Datenübertragungen nicht verwalten. Vorhandene Datenübertragungen werden beendet.
BigQuery Reservation API	bigqueryreservation.googleapis.com	Kapazitätsbasierte Arbeitslastverwaltung	Sie können keine Kapazitätszusicherungen, Reservierungen oder Zuweisungen erstellen oder verwalten. Sie können die Slot-Nutzung nicht überwachen. Das Failover für die Notfallwiederherstellung ist nicht verfügbar. Das Slot-Autoscaling wird beendet.
BigQuery Storage API	bigquerystorage.googleapis.com	Streaming-Datenaufnahme Daten im Batch laden Change Data Capture	Sie können nicht die Storage Read API oder die Storage Write API (gRPC) verwenden, um auf Ihre BigQuery-Daten zuzugreifen.
Dataform	dataform.googleapis.com	Dataform bietet Code-Repositories, die von den folgenden Funktionen genutzt werden: BigQuery-Pipelines Gespeicherte Abfragen Colab-Notebooks Dataform Datenvorbereitung Data Canvas	Sie können keine Pipelines, gespeicherten Abfragen, Colab-Notebooks, Daten-Canvases, Datenvorbereitungen oder Dataform-Projekte erstellen. Vorhandene geplante Pipelines, Notebooks oder Dataform-Projekte werden beendet. Auf vorhandene Pipelines, gespeicherte Abfragen, Colab-Notebooks, Daten-Canvases, Datenvorbereitungen oder Dataform-Projekte kann nicht mehr zugegriffen werden.
Knowledge Catalog	dataplex.googleapis.com	Knowledge Catalog bietet Funktionen zur Datenkatalogisierung und ‑governance, die von folgenden Komponenten verwendet werden: Ressourcen-Explorer in BigQuery Studio Automatische Vervollständigung im BigQuery Studio-SQL-Editor BigQuery Sharing (früher Analytics Hub) – Nach Einträgen suchen Profilstatistiken Datenqualitätsscans Data Lineage ansehen Tabellen- und Dataset-Statistiken Data Canvas	Die Suche nach BigQuery-Daten-Assets ist nicht verfügbar. Die Suche nach Einträgen zum Teilen ist nicht verfügbar. Sie können keine neuen Profilstatistiken, Datenqualitätsscans oder Abfragevorschläge erstellen und nicht auf zuvor erstellte zugreifen. In einem Herkunftsdiagramm können Sie keine Details zu Daten-Assets sehen. Sie können in Data Canvas nicht nach Daten-Assets suchen.

Auswirkungen der Deaktivierung der BigQuery API

Wenn Sie die BigQuery API deaktivieren, werden auch die folgenden Dienste deaktiviert, die von der BigQuery API abhängig sind:

• Binärautorisierung (binaryauthorization.googleapis.com)
• Google Kubernetes Engine (container.googleapis.com)
• Google Cloud APIs (cloudapis.googleapis.com)
• Dataprep by Trifacta (dataprep.googleapis.com)
• Open Service Broker for Google Cloud (servicebroker.googleapis.com)
• Telecom Data Fabric (telecomdatafabric.googleapis.com)

Durch die BigQuery Unified API aktivierte Dienste

Die BigQuery Unified API (bigqueryunified.googleapis.com) enthält eine ausgewählte Sammlung von Diensten, die für verschiedene 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 automatisch in Projekten aktiviert, in denen diese API aktiviert ist. Sie können einzelne Dienste und APIs deaktivieren.

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

Dienst	API-Name	Welche Funktionen sind davon abhängig?	Auswirkungen der Deaktivierung dieses Dienstes
Vertex AI	aiplatform.googleapis.com	Colab-Notebooks BigQuery ML-Remote-Modelle	Sie können Ihre Notebooks nicht ausführen. Alle vorhandenen BigQuery ML-Remote-Modelle funktionieren nicht mehr. Ihre vorhandenen Notebooks können weiterhin bearbeitet werden.
BigQuery Unified API	bigqueryunified.googleapis.com	Ermöglicht die Aktivierung der in diesem Dokument aufgeführten BigQuery-abhängigen Dienste mit einem einzigen 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 Engine	compute.googleapis.com	Die Google Compute Engine bietet eine Laufzeitumgebung für alle Funktionen, die von Managed Service for Apache Spark und der Gemini Enterprise Agent Platform bereitgestellt werden.	Colab-Notebooks, Remote-ML-Modelle, Apache Spark-, SparkSQL- und PySpark-Jobs werden beendet. Der Quellcode bleibt verfügbar. Die Dataproc API wird deaktiviert.
Managed Service for Apache Spark	dataproc.googleapis.com	Daten mit Open-Source-Engines wie Apache Spark abfragen Spark SQL oder PySpark mit Managed Service for Apache Spark verwenden Gespeicherte Prozeduren für Spark verwenden	Sie können keine Managed Service for Apache Spark-Cluster erstellen, um Open-Source-Datenanalysen auszuführen. Sie können keine Managed Service for Apache Spark-Arbeitslasten ausführen. Sie können keine Spark in BigQuery-Arbeitslasten ausführen.
Datastream	datastream.googleapis.com	Bietet Change Data Capture und Replikation in BigQuery.	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 werden:

Dienst	API-Name	Welche Funktionen sind davon abhängig?	Auswirkungen der Deaktivierung dieses Dienstes
Gemini for Google Cloud API	cloudaicompanion.googleapis.com	Gemini in BigQuery-Funktionen	Die Funktionen für Codevervollständigung, ‑generierung und ‑erklärung funktionieren nicht mehr. Weitere Informationen zum Deaktivieren von Gemini in BigQuery
Managed Service for Apache Airflow	composer.googleapis.com	Arbeitslasten planen	Vorhandene Managed Service for Apache Airflow-DAGs werden nicht auf der Seite „Planung“ aufgeführt und werden beendet. Vorhandene Managed Airflow-Umgebungen werden inaktiv, funktionieren nicht mehr und geben einen Fehlerstatus zurück.
Data Lineage API	datalineage.googleapis.com	Erfassung und Anzeige der Datenherkunft	Die Datenherkunft wird für Ihr Projekt nicht erfasst. Sie können das Herkunftsdiagramm nicht ansehen.

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 Automatisierungsskripts aus der Zeit 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.

Hinweis

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

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, halten Sie den Mauszeiger auf Notebook und wählen Sie dann Leeres Notebook aus.

3. Klicken Sie auf APIs aktivieren.

   Wenn diese Option nicht angezeigt wird, prüfen Sie, ob Sie die erforderliche IAM-Rolle Inhaber (roles/owner) haben. Wenn ein leeres Notebook geöffnet wird, sind die erforderlichen APIs bereits aktiviert.

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

   1. Wenn Sie alle BigQuery-Abhängigkeiten für Datenstreaming, Planung und Notebooks aktivieren möchten, klicken Sie neben BigQuery Unified API auf Aktivieren.
   2. Optional: Wenn Sie auswählen möchten, welche APIs aktiviert werden sollen, klicken Sie auf Einzelne APIs ansehen und aktivieren und dann neben jeder API, die Sie aktivieren möchten, auf Aktivieren.
   3. Wenn die APIs aktiviert sind, 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 BigQuery Studio-Nutzer 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 BigQuery Studio Admin ein.

6. Klicken Sie auf Weiter.

7. Optional: Klicken Sie im Abschnitt Zusätzliche 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 Hauptfunktionen 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

• Informationen zum Verwalten von Google Cloud -Diensten finden Sie unter Dienste aktivieren und deaktivieren.
• Informationen zum Verwalten des API-Zugriffs auf granularer Ebene mit Einschränkungen für Organisationsrichtlinien finden Sie unter Ressourcennutzung einschränken.
• Informationen zum Steuern des Zugriffs auf Dienste mit IAM-Rollen und -Berechtigungen (Identity and Access Management) für BigQuery finden Sie unter BigQuery-IAM-Rollen und -Berechtigungen.