Panoramica della connessione predefinita

Per semplificare il flusso di lavoro, puoi configurare le connessioni predefinite alle risorse Cloud in BigQuery per creare tabelle e modelli.

BigQuery supporta le connessioni predefinite nelle seguenti tabelle e modelli:

Gli amministratori configurano la connessione delle risorse Cloud predefinita per un progetto.

Se crei tabelle e modelli in un progetto, puoi scegliere la connessione predefinita configurata dagli amministratori specificando DEFAULT nelle seguenti clausole SQL:

Se non sei un amministratore, non puoi modificare le autorizzazioni o altre configurazioni della connessione predefinita. La connessione predefinita viene invece risolta automaticamente in una connessione esistente a cui viene fatto riferimento nella configurazione del progetto, assegnando alla connessione le autorizzazioni e le risorse richieste.

Prima di iniziare

Enable the BigQuery Connection API.

Enable the API

Ruoli e autorizzazioni richiesti

Per i ruoli e le autorizzazioni necessari per configurare e utilizzare le connessioni predefinite in BigQuery, consulta Gestire le connessioni.

Provision delle autorizzazioni quando si utilizza CONNECTION DEFAULT

A seconda del tipo di tabella o modello creato con la connessione predefinita, Google Cloud aggiorna automaticamente i ruoli assegnati all'account di servizio della connessione. I seguenti ruoli vengono assegnati automaticamente all'account di servizio per la connessione di queste tabelle e di questi modelli:

Tipo di tabella o modello Risorsa remota Ruoli assegnati all'account di servizio della connessione
Tabella BigLake di Cloud Storage Cloud Storage roles/storage.legacyBucketReader
roles/storage.legacyObjectReader
Tabella degli oggetti Cloud Storage roles/storage.legacyBucketReader
roles/storage.legacyObjectReader
Tabelle BigQuery per Iceberg Cloud Storage roles/storage.legacyBucketWriter
roles/storage.legacyObjectOwner
Modelli BigQuery ML remoti rispetto ai modelli Vertex AI Modelli di proprietà di Google roles/aiplatform.user
Disponibile per il deployment in un endpoint da Model Garden
Modelli utente
Modelli ottimizzati roles/aiplatform.serviceAgent
Modelli BigQuery ML remoti tramite i servizi Cloud AI Processore di documenti roles/documentai.apiUser
Riconoscimento vocale roles/speech.serviceAgent
Cloud NLP roles/serviceusage.serviceUsageConsumer
Cloud Vision roles/serviceusage.serviceUsageConsumer
Cloud Translation roles/cloudtranslate.user

Configurare la connessione predefinita per un progetto

In qualità di amministratore, configura la connessione alla risorsa Cloud predefinita per il progetto:

  • Per creare e configurare la connessione alla risorsa Cloud predefinita, utilizza l'istruzione DDL ALTER PROJECT SET OPTIONS.

    L'esempio seguente configura la connessione predefinita per il progetto:

    ALTER PROJECT PROJECT_ID
SET OPTIONS (
`region-REGION.default_cloud_resource_connection_id` = CONNECTION_ID);

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui stai impostando la connessione predefinita.
    • REGION: la regione della connessione.
    • CONNECTION_ID: l'ID o il nome della connessione da utilizzare come predefinita per tabelle e modelli. Specifica solo l'ID o il nome della connessione ed escludi l'ID progetto e i prefissi della regione associati al nome o all'ID.

Per ulteriori informazioni sulla configurazione di una connessione predefinita per un progetto, consulta Gestire le configurazioni predefinite.

Creare tabelle utilizzando CONNECTION DEFAULT

Gli esempi riportati di seguito mostrano come creare tabelle specificando WITH CONNECTION DEFAULT in BigQuery.

Esempio: crea una tabella BigLake di Cloud Storage

La seguente espressione SQL crea una tabella BigLake di Cloud Storage con una connessione predefinita:

CREATE EXTERNAL TABLE PROJECT_ID.DATASET.EXTERNAL_TABLE_NAME
WITH CONNECTION DEFAULT
OPTIONS (
  format = 'TABLE_FORMAT',
  uris = ['BUCKET_PATH']);

Esempio: crea una tabella di oggetti con una connessione predefinita

La seguente espressione SQL crea una tabella di oggetti con una connessione predefinita:

CREATE EXTERNAL TABLE PROJECT_ID.DATASET.EXTERNAL_TABLE_NAME
WITH CONNECTION DEFAULT
OPTIONS (
  object_metadata = 'SIMPLE'
  uris = ['BUCKET_PATH']);

Esempio: crea una tabella BigQuery per Iceberg con una connessione predefinita

La seguente espressione SQL crea una tabella BigQuery per Iceberg con una connessione predefinita:

CREATE TABLE `myproject.tpch_clustered.nation` (
  n_nationkey integer,
  n_name string,
  n_regionkey integer,
  n_comment string)
CLUSTER BY n_nationkey
WITH CONNECTION DEFAULT
OPTIONS (
  file_format = 'PARQUET',
  table_format = 'ICEBERG',
  storage_uri = 'gs://mybucket/warehouse/nation');

Creare modelli utilizzando REMOTE WITH CONNECTION DEFAULT

Gli esempi riportati di seguito mostrano come creare modelli specificando REMOTE WITH CONNECTION DEFAULT in BigQuery.

Esempio: crea un modello remoto su un modello Vertex AI

La seguente espressione SQL crea un modello remoto con una connessione predefinita:

CREATE OR REPLACE MODEL `mydataset.flash_model`
  REMOTE WITH CONNECTION DEFAULT
  OPTIONS(ENDPOINT = 'gemini-1.5-flash-001');

Esempio: crea un modello remoto su un servizio Cloud AI

La seguente espressione SQL crea un SERVICE di modelli remoto con una connessione predefinita:

CREATE MODEL `project_id.mydataset.mymodel`
REMOTE WITH CONNECTION DEFAULT
 OPTIONS(REMOTE_SERVICE_TYPE = 'CLOUD_AI_VISION_V1')

Esempio: crea un modello remoto con un endpoint HTTPS

La seguente espressione SQL crea un modello remoto con un endpoint HTTPS e una connessione predefinita:

CREATE MODEL `project_id.mydataset.mymodel`
 INPUT(f1 INT64, f2 FLOAT64, f3 STRING, f4 ARRAY)
 OUTPUT(out1 INT64, out2 INT64)
 REMOTE WITH CONNECTION DEFAULT
 OPTIONS(ENDPOINT = 'https://us-central1-aiplatform.googleapis.com/v1/projects/myproject/locations/us-central1/endpoints/1234')

Passaggi successivi