Gestisci le dipendenze dell'API BigQuery

Questo documento descrive i servizi e le API da cui dipende BigQuery. Trusted Cloud by S3NS 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 Trusted Cloud che crei. Altre API vengono attivate automaticamente per tutti i progetti Trusted Cloud che utilizzano BigQuery. I servizi rimanenti devono essere attivati esplicitamente prima di poter utilizzare le loro funzionalità. Per maggiori informazioni, 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 progettoTrusted Cloud :

Servizio Quali funzionalità si basano su di esso Effetti della disattivazione di questo servizio
analyticshub.googleapis.com
  • 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.
  • Gli abbonamenti creati vengono mantenuti, ma non sono accessibili.
  • I set di dati collegati sono accessibili finché l'API BigQuery è abilitata.
  • Non puoi creare nuovi abbonamenti
bigqueryconnection.googleapis.com
  • 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
  • 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
  • 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.
bigqueryreservation.googleapis.com
  • Non puoi creare o gestire impegni di capacità, prenotazioni o assegnazioni.
  • Non puoi monitorare l'utilizzo degli slot.
  • Il failover di ripristino di emergenza non è disponibile.
  • La scalabilità automatica degli slot si interrompe.
bigquerystorage.googleapis.com
dataform.googleapis.com
  • Non puoi creare pipeline, query salvate, blocchi note 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
  • La ricerca di asset di dati BigQuery non è disponibile.
  • La ricerca di schede condivise non è disponibile.
  • Non puoi creare nuovi approfondimenti sul profilo 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 genealogia.
  • 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 vengono attivati automaticamente nei progetti in cui è abilitata questa API. Puoi disattivare singoli servizi e API.

Per istruzioni su come attivare 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
  • Non potrai eseguire i tuoi notebook.
  • 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 attivate 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 disattivata.
dataproc.googleapis.com
  • Non puoi creare cluster Dataproc per eseguire l'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
  • 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
composer.googleapis.com
  • 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
  • La derivazione dei dati non viene acquisita per il tuo progetto.
  • Non puoi visualizzare il grafico della derivazione.

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
  • 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à 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 Identity and Access Management (IAM) Proprietario (roles/owner).

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 sul menu a discesa a forma di freccia accanto al segno +, tieni il puntatore su Notebook e poi seleziona Modello BigQuery.

  3. Nel banner visualizzato sotto la barra delle schede del riquadro dell'editor, fai clic su Attiva.

    Se non vedi il banner, controlla di disporre del ruolo IAM Proprietario richiesto.

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

    1. Per attivare la cronologia delle versioni e la condivisione degli asset di codice, nella sezione Cronologia delle versioni e condivisione, fai clic su Attiva.
    2. Per attivare i notebook, in Notebook Python, fai clic su Attiva tutto.
    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 Creatore.
    • Per concedere alle entità la possibilità di leggere, modificare e impostare le autorizzazioni per tutte le risorse di codice condivise con loro, digita i nomi degli utenti o dei gruppi nel campo Proprietario.
  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à.

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 di risorse. Puoi disattivare le API selezionate in qualsiasi momento.

Passaggi successivi