Descripción general de la conexión predeterminada

Para simplificar tu flujo de trabajo, puedes configurar conexiones de recursos de Cloud predeterminadas en BigQuery para crear tablas y modelos.

BigQuery admite conexiones predeterminadas en las siguientes tablas y modelos:

Los administradores configuran la conexión de recursos de Cloud predeterminada para un proyecto.

Si creas tablas y modelos en un proyecto, puedes elegir la conexión predeterminada que configuraron los administradores especificando DEFAULT en las siguientes cláusulas de SQL:

Si no eres administrador, no puedes modificar los permisos ni otros parámetros de configuración de la conexión predeterminada. En su lugar, la conexión predeterminada se resuelve automáticamente en una conexión existente a la que se hace referencia en la configuración del proyecto, lo que le otorga los permisos y recursos necesarios.

Antes de comenzar

Enable the BigQuery Connection API.

Enable the API

Roles y permisos requeridos

Para conocer los roles y permisos necesarios para configurar y usar las conexiones predeterminadas en BigQuery, consulta Cómo administrar conexiones.

Aprovisionamiento de permisos cuando se usa CONNECTION DEFAULT

Según el tipo de tabla o modelo que crees con la conexión predeterminada, Google Cloud actualiza automáticamente los roles asignados a la cuenta de servicio de la conexión. Los siguientes roles se otorgan automáticamente a la cuenta de servicio para la conexión de estas tablas y modelos:

Tipo de tabla o modelo Recurso remoto Roles asignados a la cuenta de servicio de la conexión
Tabla de BigLake de Cloud Storage Cloud Storage roles/storage.legacyBucketReader
roles/storage.legacyObjectReader
Tabla de objetos Cloud Storage roles/storage.legacyBucketReader
roles/storage.legacyObjectReader
Tablas de BigQuery para Iceberg Cloud Storage roles/storage.legacyBucketWriter
roles/storage.legacyObjectOwner
Modelos remotos de BigQuery ML sobre modelos de Vertex AI Modelos de Google roles/aiplatform.user
Se puede implementar en un extremo desde Model Garden
Modelos de usuario
Modelos ajustados roles/aiplatform.serviceAgent
Modelos remotos de BigQuery ML a través de servicios de Cloud AI Procesador de documentos roles/documentai.apiUser
Reconocedor de voz roles/speech.serviceAgent
PLN de Cloud roles/serviceusage.serviceUsageConsumer
Cloud Vision roles/serviceusage.serviceUsageConsumer
Cloud Translation roles/cloudtranslate.user

Configura la conexión predeterminada de un proyecto

Como administrador, configura la conexión de recursos de Cloud predeterminada para el proyecto:

  • Para crear y configurar la conexión de recursos de Cloud predeterminada, usa la declaración DDL ALTER PROJECT SET OPTIONS.

    En el siguiente ejemplo, se configura la conexión predeterminada del proyecto:

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

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto en el que configuras la conexión predeterminada.
    • REGION: Es la región de la conexión.
    • CONNECTION_ID: El ID o el nombre de la conexión que se usará como predeterminada para las tablas y los modelos. Solo especifica el ID o el nombre de la conexión, y excluye el ID del proyecto y los prefijos de región adjuntos al nombre o al ID.

Para obtener más información sobre cómo configurar una conexión predeterminada para un proyecto, consulta Administra las configuraciones predeterminadas.

Crea tablas con CONNECTION DEFAULT

En los siguientes ejemplos, se muestra cómo crear tablas que especifiquen WITH CONNECTION DEFAULT en BigQuery.

Ejemplo: Crea una tabla de BigLake de Cloud Storage

La siguiente expresión SQL crea una tabla BigLake de Cloud Storage con una conexión predeterminada:

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

Ejemplo: Crea una tabla de objetos con una conexión predeterminada

La siguiente expresión de SQL crea una tabla de objetos con una conexión predeterminada:

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

Ejemplo: Crea una tabla de BigQuery para Iceberg con una conexión predeterminada

La siguiente expresión SQL crea una tabla de BigQuery para Iceberg con una conexión predeterminada:

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');

Crea modelos con REMOTE WITH CONNECTION DEFAULT

En los siguientes ejemplos, se muestra cómo crear modelos que especifiquen REMOTE WITH CONNECTION DEFAULT en BigQuery.

Ejemplo: Crea un modelo remoto sobre un modelo de Vertex AI

La siguiente expresión de SQL crea un modelo remoto con una conexión predeterminada:

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

Ejemplo: Crea un modelo remoto sobre un servicio de Cloud AI

La siguiente expresión de SQL crea un servicio de modelo remoto con una conexión predeterminada:

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

Ejemplo: Crea un modelo remoto con un extremo HTTPS

La siguiente expresión de SQL crea un modelo remoto con un extremo HTTPS y una conexión predeterminada:

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')

¿Qué sigue?