Questa pagina è stata tradotta dall'API Cloud Translation.

Gestire le dipendenze dell'API BigQuery

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

Alcuni servizi sono abilitati per impostazione predefinita in ogni Google Cloud progetto che crei. Le altre API vengono attivate automaticamente per tutti i Google Cloud progetti che utilizzano BigQuery. I servizi rimanenti devono essere attivati esplicitamente prima di poter utilizzare le relative funzionalità. Per saperne di più, consulta le seguenti risorse:

Questo documento è rivolto agli amministratori.

Servizi attivati per impostazione predefinita

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

Servizio	Quali funzionalità si basano su questa opzione	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 piattaforme di scambio pubblicitario o schede create da altri fornitori. Le iscrizioni create rimangono, ma non sono accessibili. I set di dati collegati sono accessibili purché l'API BigQuery sia attivata. 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 di oggetti.
`bigquerymigration.googleapis.com`	Valutazione della migrazione dei dati Traduzione delle 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.
`bigquerydatapolicy.googleapis.com`	Masking dei dati	Non puoi gestire i tuoi criteri di mascheramento dei dati. I criteri di mascheramento dei dati non vengono eliminati, ma le query alle tabelle con il mascheramento dei dati applicato non vanno a buon fine.
`bigqueryreservation.googleapis.com`	Gestione del carico di lavoro basata sulla capacità	Non puoi creare o gestire impegni di capacità, prenotazioni o assunzioni. Non puoi monitorare l'utilizzo degli slot. Il failover del ripristino di emergenza non è disponibile. La scalabilità automatica degli slot viene interrotta.
`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 di Colab Dataform Preparazione dei dati Canvas di dati	Non puoi creare pipeline, query salvate, notebook Colab, canvas di dati, preparazioni dei dati o progetti Dataform. Le pipeline, i notebook o i progetti Dataform pianificati esistenti vengono interrotti. Eventuali pipeline esistenti, query salvate, blocchi note di Colab, canvas di dati, preparazioni dei dati o progetti Dataform diventano inaccessibili.
`dataplex.googleapis.com`	Dataplex Universal Catalog fornisce funzionalità di catalogazione e governance dei dati utilizzate da quanto segue: Esplora risorse in BigQuery Studio Completamento automatico nell'editor SQL di BigQuery Studio Ricerca di schede su 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 di dati	La ricerca delle risorse di dati BigQuery non è disponibile. La ricerca di schede condivise non è disponibile. Non puoi creare nuovi approfondimenti sul profilo, analisi della qualità dei dati o suggerimenti per le query creati in precedenza né accedervi. Non puoi visualizzare i dettagli delle risorse di dati in un grafico della struttura. Non puoi cercare asset di dati nel canvas di dati.

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 attivi l'API BigQuery Unified, tutti questi servizi vengono attivati contemporaneamente. Google può aggiornare i servizi in questa raccolta, che vengono attivati automaticamente nei progetti in cui è attivata questa API. Puoi disattivare singoli servizi e API.

Per istruzioni su come attivare bigqueryunified.googleapis.com, consulta Attivare e disattivare i servizi.

Servizio	Quali funzionalità si basano su questa opzione	Effetti della disattivazione di questo servizio
`aiplatform.googleapis.com`	Blocchi note di Colab Modelli remote BigQuery ML	Non potrai eseguire i tuoi notebook. Tutti i modelli BigQuery ML remoti esistenti smettono di funzionare. I tuoi notebook esistenti rimangono accessibili per la modifica.
`bigqueryunified.googleapis.com`	Fornisce un'attivazione con un solo clic dei servizi dipendenti da BigQuery elencati in questo documento, escluse le API cloudaicompanion, composer e datalineage. Assicurati che le nuove dipendenze BigQuery siano attivate nel tuo progetto.	Le dipendenze future non vengono attivate automaticamente nel progetto.
`compute.googleapis.com`	Google Compute Engine fornisce un ambiente di runtime per tutte le funzionalità fornite da Dataproc e Vertex AI.	I notebook di Colab, i modelli ML remoti, i job Apache Spark, SparkSQL e PySpark si arrestano. Il codice sorgente rimane disponibile. L'API Dataproc viene disattivata.
`dataproc.googleapis.com`	Esegui query sui dati con motori open source come Apache Spark. Utilizza Spark SQL o PySpark con Dataproc Serverless. Utilizza le stored procedure per Spark.	Non puoi creare cluster Dataproc per eseguire analisi dei dati open source. Non puoi eseguire carichi di lavoro Dataproc Serverless. Non puoi eseguire Spark nei carichi di lavoro BigQuery.
`datastream.googleapis.com`	Fornisce il monitoraggio delle modifiche e la 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 affinché le funzionalità corrispondenti diventino disponibili:

Servizio	Quali funzionalità si basano su questa opzione	Effetti della disattivazione di questo servizio
`cloudaicompanion.googleapis.com`	Funzionalità di Gemini in BigQuery	Le funzionalità di completamento, generazione e spiegazione del codice non funzionano più. Scopri di più su come disattivare Gemini in BigQuery.
`composer.googleapis.com`	Pianificare i carichi di lavoro	I DAG di Cloud Composer esistenti non sono elencati nella pagina Pianificazione e si arrestano. Gli ambienti Cloud Composer esistenti diventano inattivi, non funzionano più e restituiscono uno stato di errore.
`datalineage.googleapis.com`	Acquisizione e visualizzazione della derivazione dei dati	La cronologia dei dati non viene acquisita per il progetto. Non puoi visualizzare il grafico della struttura.

Attivare 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 erano 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à attivato queste API, vedrai nuove cartelle Notebook e Query nel riquadro Explorer di BigQuery.

Prima di iniziare

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

Attivare manualmente gli asset di codice BigQuery

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

Vai alla pagina BigQuery.

Vai a BigQuery
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 poi seleziona Modello BigQuery.
Nel banner visualizzato sotto la barra delle schede del riquadro dell'editor, fai clic su Attiva.

Se non vedi il banner, controlla se disponi del ruolo IAM Proprietario richiesto.
Nel riquadro Abilita funzionalità, nella sezione API di funzionalità di base, segui questi passaggi:
1. Per attivare la cronologia delle versioni e la condivisione delle risorse di codice, nella sezione Cronologia delle versioni e condivisione, fai clic su Attiva.
2. Per attivare i blocchi note, fai clic su Attiva tutto in Blocchi note Python.
3. Quando le API sono abilitate, fai clic su Avanti.
(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 Autore.
- Per concedere ai principali 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 Proprietario.
Fai clic su Avanti.
(Facoltativo) Nella sezione API aggiuntive, fai clic su Abilita tutto per attivare le API necessarie per creare procedure remote BigQuery utilizzando i DataFrame BigQuery.
Se hai scelto di non attivare le API aggiuntive, fai clic su Chiudi per chiudere il riquadro Attiva funzionalità.

Limitare l'accesso agli asset di codice

Puoi contribuire a impedire l'attivazione di API aggiuntive impostando il vincolo del criterio dell'organizzazione Limita l'utilizzo del servizio delle risorse. Puoi disattivare API selezionate in qualsiasi momento.

Passaggi successivi

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