Gestisci le dipendenze dell'API BigQuery

Puoi gestire il comportamento di BigQuery comprendendo in che modo ogni API influisce sulle funzionalità Google Cloud che dipendono da queste API. Alcuni servizi API sono abilitati per impostazione predefinita in ogni progetto Google Cloud che crei, mentre altri vengono abilitati automaticamente per tutti i progetti Google Cloud che utilizzano BigQuery. Devi abilitare esplicitamente i servizi API rimanenti prima di poter utilizzare la loro funzionalità.

La disattivazione errata di una dipendenza può influire sulla funzionalità di BigQuery. Comprendi queste dipendenze per prendere decisioni informate quando attivi o disattivi i servizi nel tuo progetto Google Cloud .

Servizi abilitati per impostazione predefinita

I seguenti servizi sono abilitati per impostazione predefinita per ogni nuovo progettoGoogle Cloud :

Servizio	Nome API	Quali funzionalità si basano su questa impostazione	Effetti della disattivazione di questo servizio
BigQuery sharing	analyticshub.googleapis.com	Pubblica i data exchange Pubblicare schede e gestire abbonamenti Data clean room	Non puoi creare o gestire scambi di dati, schede, data clean room o abbonamenti. Non puoi cercare ed esplorare scambi o schede creati da altri provider. Le sottoscrizioni create rimangono, ma non sono accessibili. I set di dati collegati sono accessibili finché l'API BigQuery è abilitata. Non puoi creare nuovi abbonamenti
API BigQuery Connection	bigqueryconnection.googleapis.com	Query federate sui dati archiviati al di fuori di BigQuery Tabelle e set di dati esterni Metastore BigQuery	Non puoi gestire le connessioni esterne. Non puoi creare modelli remoti. Non puoi creare funzioni remote. Non puoi eseguire query sulle tabelle BigLake e sulle tabelle degli oggetti.
BigQuery Migration Service	bigquerymigration.googleapis.com	Valutazione della migrazione dei dati Traduzione di query SQL	Non puoi creare attività o valutazioni di migrazione. Le attività o le valutazioni esistenti non sono disponibili. Nota: in genere puoi disattivare questo servizio dopo aver completato la migrazione dei dati.
Policy dei dati BigQuery	bigquerydatapolicy.googleapis.com	Mascheramento dei dati	Non puoi gestire le policy di mascheramento dei dati. Le policy di mascheramento dei dati non vengono eliminate, ma le query alle tabelle con mascheramento dei dati applicato non vanno a buon fine.
BigQuery Data Transfer Service	bigquerydatatransfer.googleapis.com	Trasferimenti di dati pianificati	Non puoi gestire i trasferimenti di dati pianificati. I trasferimenti di dati esistenti vengono interrotti.
API BigQuery Reservation	bigqueryreservation.googleapis.com	Gestione dei workload basata sulla capacità	Non puoi creare o gestire impegni, prenotazioni o assegnazioni di capacità. Non puoi monitorare l'utilizzo degli slot. Il failover del disaster recovery non è disponibile. La scalabilità automatica degli slot viene interrotta.
API BigQuery Storage	bigquerystorage.googleapis.com	Acquisizione dei dati in streaming Caricamento dei dati in batch Change Data Capture (CDC)	Non puoi utilizzare l'API Storage Read o l'API Storage Write (gRPC) per accedere ai tuoi dati BigQuery.
Dataform	dataform.googleapis.com	Dataform fornisce repository di codice che vengono utilizzati dalle seguenti funzionalità: Pipeline BigQuery Query salvate Notebook di Colab Dataform Preparazione dei dati Data Canvas	Non puoi creare pipeline, query salvate, notebook di Colab, data canvas, preparazioni di dati o progetti Dataform. Le pipeline, i notebook o i progetti Dataform pianificati esistenti vengono interrotti. Tutte le pipeline, le query salvate, i notebook di Colab, i data canvas, le preparazioni dei dati o i progetti Dataform esistenti diventano inaccessibili.
Knowledge Catalog	dataplex.googleapis.com	Knowledge Catalog fornisce funzionalità di catalogazione e governance dei dati utilizzate dai seguenti elementi: Explorer risorse in BigQuery Studio Completamento automatico nell'editor SQL di BigQuery Studio Ricerca di schede di BigQuery sharing (in precedenza Analytics Hub) Statistiche del profilo Scansioni della qualità dei dati Visualizzazione della derivazione dei dati Insight su tabelle e set di dati Data Canvas	La ricerca degli asset di dati BigQuery non è disponibile. La ricerca della scheda di condivisione non è disponibile. Non puoi creare nuovi insight sul profilo, scansioni della qualità dei dati o suggerimenti di query, né accedere a quelli creati in precedenza. Non puoi visualizzare i dettagli degli asset di dati in un grafico di derivazione. Non puoi cercare asset di dati nel data canvas.

Effetto della disattivazione dell'API BigQuery

La disabilitazione dell'API BigQuery disabilita anche i seguenti servizi che dipendono dall'API BigQuery:

• Autorizzazione binaria (binaryauthorization.googleapis.com)
• Google Kubernetes Engine (container.googleapis.com)
• APIGoogle Cloud (cloudapis.googleapis.com)
• Dataprep di Trifacta (dataprep.googleapis.com)
• Open Service Broker per Google Cloud (servicebroker.googleapis.com)
• Telecom Data Fabric (telecomdatafabric.googleapis.com)

Servizi abilitati dall'API BigQuery Unified

L'API BigQuery Unified (bigqueryunified.googleapis.com) include una raccolta selezionata di servizi necessari per il funzionamento di varie funzionalità di BigQuery. Se abiliti l'API BigQuery Unified, tutti questi servizi vengono attivati contemporaneamente. Google può aggiornare i servizi di questa raccolta, che vengono attivati automaticamente nei progetti in cui è abilitata questa API. Puoi disabilitare singoli servizi e API.

Per istruzioni su come attivare bigqueryunified.googleapis.com, consulta Abilitazione e disabilitazione dei servizi.

Servizio	Nome API	Quali funzionalità si basano su questa impostazione	Effetti della disattivazione di questo servizio
Vertex AI	aiplatform.googleapis.com	Notebook di Colab Modelli remoti di BigQuery ML	Non potrai eseguire i tuoi notebook. I modelli remoti BigQuery ML esistenti smettono di funzionare. I tuoi notebook esistenti rimangono accessibili per la modifica.
API BigQuery Unified	bigqueryunified.googleapis.com	Fornisce un'attivazione con un solo clic dei servizi dipendenti da BigQuery elencati in questo documento, ad eccezione delle API cloudaicompanion, composer e datalineage. Assicura che le nuove dipendenze di BigQuery siano abilitate nel tuo progetto.	Le dipendenze future non vengono attivate automaticamente nel tuo progetto.
Compute Engine	compute.googleapis.com	Google Compute Engine fornisce un ambiente di runtime per tutte le funzionalità fornite da Managed Service for Apache Spark e Gemini Enterprise Agent Platform.	I notebook di Colab, i modelli ML remoti, Apache Spark, SparkSQL e i job PySpark vengono interrotti. Il codice sorgente rimane disponibile. L'API Dataproc viene disabilitata.
Managed Service for Apache Spark	dataproc.googleapis.com	Esegui query sui dati con motori open source come Apache Spark. Utilizza Spark SQL o PySpark con Managed Service for Apache Spark. Utilizza le stored procedure per Spark.	Non puoi creare cluster Managed Service for Apache Spark per eseguire analisi dei dati open source. Non puoi eseguire i workload di Managed Service for Apache Spark. Non puoi eseguire workload Spark in BigQuery.
Datastream	datastream.googleapis.com	Fornisce Change Data Capture e replica in BigQuery.	Tutti gli stream di dati sono in pausa e non sono accessibili.

Servizi disattivati per impostazione predefinita

Devi attivare manualmente i seguenti servizi per rendere disponibili le funzionalità corrispondenti:

Servizio	Nome API	Quali funzionalità si basano su questa impostazione	Effetti della disattivazione di questo servizio
API Gemini for Google Cloud	cloudaicompanion.googleapis.com	Funzionalità di Gemini in BigQuery	Le funzionalità di completamento, generazione e spiegazione del codice smettono di funzionare. Scopri di più sulla disattivazione di Gemini in BigQuery.
Managed Service for Apache Airflow	composer.googleapis.com	Pianifica i workload	I DAG di Managed Service for Apache Airflow esistenti non sono elencati nella pagina Pianificazione e vengono interrotti. Gli ambienti Managed Airflow esistenti diventano inoperativi, smettono di funzionare e restituiscono uno stato di errore.
API Data Lineage	datalineage.googleapis.com	Acquisizione e visualizzazione della derivazione dei dati	La derivazione dei dati non viene acquisita per il tuo progetto. Non puoi visualizzare il grafico di derivazione.

Abilita manualmente gli asset di codice BigQuery

Per gestire gli asset di codice in BigQuery, come i notebook e le query salvate, devi abilitare le seguenti API:

• L'API Compute Engine
• L'API Dataform
• L'API Vertex AI

Prima di marzo 2024, queste API non venivano attivate automaticamente per impostazione predefinita. Se hai script di automazione precedenti a marzo 2024 che dipendevano dallo stato di queste API, potresti doverli aggiornare. Se hai già abilitato queste API, vedrai le nuove cartelle Notebook e Query nel riquadro Explorer di BigQuery.

Prima di iniziare

Per attivare manualmente la gestione degli asset di codice, devi disporre del ruolo Proprietario (roles/owner) di Identity and Access Management (IAM).

Abilita manualmente gli asset di codice BigQuery

Per abilitare le dipendenze API richieste per gli asset di codice, segui questi passaggi:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. In Studio, nella barra delle schede del riquadro dell'editor, fai clic sulla freccia del menu a discesa accanto al segno +, tieni il puntatore del mouse su Notebook e seleziona Notebook vuoto.

3. Fai clic su Abilita API.

   Se non vedi questa opzione, controlla se hai il ruolo Proprietario IAM (roles/owner) richiesto. Se si apre un blocco note vuoto, significa che hai già abilitato le API necessarie.

4. Nel riquadro Abilita funzionalità principali, nella sezione API delle funzionalità principali, segui questi passaggi:

   1. Per abilitare tutte le dipendenze di BigQuery per lo streaming di dati, la pianificazione e i notebook, fai clic su Abilita accanto a API BigQuery Unified.
   2. (Facoltativo) Per scegliere le API da abilitare, fai clic su Visualizza e abilita singole API, quindi su Abilita accanto a ogni API che vuoi abilitare.
   3. Una volta abilitate le API, fai clic su Avanti.

5. (Facoltativo) Imposta le autorizzazioni utente nella sezione Autorizzazioni:

   • Per concedere alle entità la possibilità di creare asset di codice e di leggere, modificare e impostare le autorizzazioni per gli asset di codice che hanno creato, digita i nomi degli utenti o dei gruppi nel campo BigQuery Studio User.
   • Per concedere alle entità la possibilità di leggere, modificare e impostare le autorizzazioni per tutti gli asset di codice condivisi con loro, digita i nomi degli utenti o dei gruppi nel campo Amministratore BigQuery Studio.

6. Fai clic su Avanti.

7. (Facoltativo) Nella sezione API aggiuntive, fai clic su Abilita tutte per abilitare le API necessarie per creare procedure remote BigQuery utilizzando BigQuery DataFrames.

8. Se hai scelto di non abilitare le API aggiuntive, fai clic su Chiudi per chiudere il riquadro Abilita le funzionalità principali.

Limita l'accesso agli asset di codice

Puoi contribuire a impedire l'abilitazione di API aggiuntive impostando il vincolo della policy dell'organizzazione Limita utilizzo servizi delle risorse. Puoi disattivare le API selezionate in qualsiasi momento.

Passaggi successivi

• Per scoprire come gestire i servizi Google Cloud , consulta Abilitazione e disabilitazione dei servizi.
• Per scoprire come gestire l'accesso alle API a livello granulare con i vincoli delle policy dell'organizzazione, consulta Limitazione dell'utilizzo delle risorse.
• Per scoprire come controllare l'accesso ai servizi con ruoli e autorizzazioni di Identity and Access Management (IAM) per BigQuery, consulta Ruoli e autorizzazioni IAM di BigQuery.