Gestire le dipendenze dell'API BigQuery

Questo documento descrive i servizi e le API da cui dipende BigQuery. Google Cloud Spiega inoltre gli effetti sul comportamento di BigQuery quando disattivi questi servizi. Consulta questo documento prima di attivare o disattivare i servizi nel tuo progetto.

Alcuni servizi sono abilitati per impostazione predefinita in ogni progetto Google Cloud che crei. Altre API vengono abilitate automaticamente per tutti i progetti Google Cloud che utilizzano BigQuery. I servizi rimanenti devono essere abilitati esplicitamente prima di poter utilizzare la loro funzionalità. Per maggiori informazioni, consulta le seguenti risorse:

• Servizi abilitati per impostazione predefinita
• Abilitazione e disabilitazione dei servizi

Questo documento è rivolto agli amministratori.

Servizi attivati per impostazione predefinita

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

Servizio	Quali funzionalità si basano su di esso	Effetti della disattivazione di questo servizio
analyticshub.googleapis.com	Pubblicare gli scambi di dati Pubblicare schede e gestire gli 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 fornitori. Le iscrizioni create vengono mantenute, ma non sono accessibili. I set di dati collegati sono accessibili finché l'API BigQuery è abilitata. Non puoi creare nuovi abbonamenti
bigqueryconnection.googleapis.com	Query federate sui dati archiviati al di fuori di BigQuery Tabelle e set di dati esterni BigQuery metastore	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.
bigquerymigration.googleapis.com	Valutazione della migrazione dei dati Traduzione delle query SQL	Non puoi creare attività o valutazioni di migrazione. Le attività o i test esistenti non sono disponibili. Nota:in genere puoi disattivare questo servizio dopo aver completato la migrazione dei dati.
bigquerydatapolicy.googleapis.com	Mascheramento dei dati	Non puoi gestire le tue policy di mascheramento dei dati. Le policy di mascheramento dei dati non vengono eliminate, ma le query alle tabelle con il mascheramento dei dati applicato non vanno a buon fine.
bigquerydatatransfer.googleapis.com	Trasferimenti di dati pianificati	Non puoi gestire i trasferimenti di dati pianificati. I trasferimenti di dati esistenti vengono interrotti.
bigqueryreservation.googleapis.com	Gestione del carico di lavoro basata sulla capacità	Non puoi creare o gestire impegni di capacità, prenotazioni o assegnazioni. Non puoi monitorare l'utilizzo degli slot. Il failover del ripristino di emergenza non è disponibile. La scalabilità automatica degli slot si interrompe.
bigquerystorage.googleapis.com	Importazione di dati in streaming Caricamento dei dati in batch Change Data Capture (CDC)	Non puoi utilizzare l'API Storage Read o l'API Storage Write per accedere ai tuoi dati BigQuery.
dataform.googleapis.com	Dataform fornisce repository di codice utilizzati dalle seguenti funzionalità: Pipeline BigQuery Query salvate Blocchi note Colab Dataform Preparazione dei dati Canvas dei dati	Non puoi creare pipeline, query salvate, notebook Colab, canvas di dati, preparazioni dei dati o progetti Dataform. Le pipeline pianificate, i blocchi note o i progetti Dataform esistenti vengono interrotti. Tutte le pipeline esistenti, le query salvate, i blocchi note Colab, i canvas di dati, le preparazioni dei dati o i progetti Dataform diventano inaccessibili.
dataplex.googleapis.com	Dataplex Universal Catalog fornisce funzionalità di catalogazione e governance dei dati utilizzate da: Resource Explorer in BigQuery Studio Completamento automatico nell'editor SQL di BigQuery Studio Ricerca di schede in BigQuery sharing (in precedenza Analytics Hub) Approfondimenti sul profilo Scansioni della qualità dei dati Visualizzazione della derivazione dei dati Approfondimenti su tabelle e set di dati Canvas dei dati	La ricerca di asset di dati BigQuery non è disponibile. La ricerca di annunci condivisi non è disponibile. Non puoi creare nuovi approfondimenti sui profili o accedere a quelli creati in precedenza, né a scansioni della qualità dei dati o suggerimenti per le query. Non puoi visualizzare i dettagli degli asset di dati in un grafico della derivazione. Non puoi cercare asset di dati nel canvas dei dati.

Effetto della disattivazione dell'API BigQuery

La disattivazione dell'API BigQuery disattiva anche i seguenti servizi che dipendono dall'API BigQuery:

• binaryauthorization.googleapis.com
• container.googleapis.com
• cloudapis.googleapis.com
• dataprep.googleapis.com
• servicebroker.googleapis.com
• 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 in questa raccolta e questi servizi vengono attivati automaticamente nei progetti in cui è abilitata questa API. Puoi disattivare singoli servizi e API.

Per istruzioni sull'attivazione di bigqueryunified.googleapis.com, vedi Abilitazione e disabilitazione dei servizi.

Servizio	Quali funzionalità si basano su di esso	Effetti della disattivazione di questo servizio
aiplatform.googleapis.com	Blocchi note Colab Modelli remoti BigQuery ML	Non potrai eseguire i tuoi blocchi note. Tutti i modelli remoti BigQuery ML esistenti smettono di funzionare. I tuoi notebook esistenti rimangono accessibili per la modifica.
bigqueryunified.googleapis.com	Fornisce l'attivazione con un solo clic dei servizi dipendenti di BigQuery elencati in questo documento, escluse le 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.googleapis.com	Google Compute Engine fornisce un ambiente di runtime per tutte le funzionalità fornite da Dataproc e Vertex AI.	I notebook Colab, i modelli ML remoti, i job Apache Spark, SparkSQL e PySpark si arrestano. Il codice sorgente rimane disponibile. L'API Dataproc viene disabilitata.
dataproc.googleapis.com	Esegui query sui dati con motori open source come Apache Spark. Utilizza Spark SQL o PySpark con Google Cloud Serverless per Apache Spark. Utilizza le stored procedure per Spark.	Non puoi creare cluster Dataproc per eseguire l'analisi dei dati open source. Non puoi eseguire i workload Serverless per Apache Spark. Non puoi eseguire Spark nei carichi di lavoro BigQuery.
datastream.googleapis.com	Fornisce l'acquisizione e la replica dei dati di modifica 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	Quali funzionalità si basano su di esso	Effetti della disattivazione di questo servizio
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.
composer.googleapis.com	Pianificare i workload	I DAG Cloud Composer esistenti non sono elencati nella pagina Pianificazione e vengono interrotti. Gli ambienti Cloud Composer esistenti diventano inoperativi, smettono di funzionare e restituiscono uno stato di errore.
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 della derivazione.

Abilitare 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:

• API Compute Engine
• API Dataform
• API Vertex AI

Prima di marzo 2024, queste API non erano abilitate 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à attivato 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) .

Attivare manualmente gli asset di codice BigQuery

Per abilitare le dipendenze API richieste per gli asset di codice:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. In Studio, nella barra delle schede del riquadro dell'editor, fai clic sulla Freccia giù accanto al segno +, tieni il puntatore del mouse su Notebook e poi seleziona Notebook vuoto.

3. Fai clic su Abilita API.

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

4. Nel riquadro Abilita funzionalità principali, nella sezione API funzionalità principali, svolgi le seguenti operazioni:

   1. Per abilitare tutte le dipendenze di BigQuery per lo streaming, la pianificazione e i blocchi note, fai clic su Abilita accanto ad API BigQuery Unified.
   2. (Facoltativo) Per scegliere le API da abilitare, fai clic su Visualizza e abilita singole API e poi su Abilita accanto a ogni API che vuoi abilitare.
   3. Quando le API sono abilitate, 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 di utenti o gruppi nel campo BigQuery Studio User.
   • Per concedere ai principal 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 tutto 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 funzionalità principali.

Limitare l'accesso agli asset di codice

Puoi contribuire a impedire l'attivazione di API aggiuntive impostando il vincolo del criterio 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 API a livello granulare con i vincoli dei criteri 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, vedi Ruoli e autorizzazioni IAM di BigQuery.