Vista SCHEMATA_LINKS

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS contiene una fila por cada conjunto de datos vinculado que se comparte mediante la función de compartir de BigQuery. Esta vista también contiene recursos individuales, como tablas o vistas, en un proyecto compartido mediante salas blancas de datos. En esta vista se muestra una fila por cada recurso del conjunto de datos vinculado.

Permiso obligatorio

Para consultar la vista INFORMATION_SCHEMA.SCHEMATA_LINKS, necesitas el permiso de gestión de identidades y accesos bigquery.datasets.get a nivel de proyecto.

Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye los permisos que necesitas para consultar la vista INFORMATION_SCHEMA.SCHEMATA_LINKS:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer

Para obtener más información sobre los permisos de BigQuery, consulta Control de acceso con gestión de identidades y accesos.

Esquema

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
catalog_name STRING Nombre del proyecto que contiene el conjunto de datos de origen.
schema_name STRING Nombre del conjunto de datos de origen. El nombre del conjunto de datos también se denomina datasetId.
linked_schema_catalog_number STRING El número del proyecto que contiene el conjunto de datos vinculado.
linked_schema_catalog_name STRING Nombre del proyecto que contiene el conjunto de datos vinculado.
linked_schema_name STRING Nombre del conjunto de datos vinculado. El nombre del conjunto de datos también se denomina datasetId.
linked_schema_creation_time TIMESTAMP Hora en la que se creó el conjunto de datos vinculado.
linked_schema_org_display_name STRING Nombre visible de la organización en la que se crea el conjunto de datos vinculado.
shared_asset_id STRING ID del recurso que se comparte mediante salas blancas de datos. Este valor es null si link_type es REGULAR.
link_type STRING Tipo de conjunto de datos vinculado. Los valores posibles son REGULAR o DCR (salas blancas de datos).

Ámbito y sintaxis

Las consultas en esta vista deben incluir un calificador de región. Si no especificas un calificador regional, los metadatos se obtendrán de la región de EE. UU. En la siguiente tabla se explica el ámbito de la región de esta vista:

Nombre de la vista Ámbito de los recursos Ámbito de la región
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS Nivel de proyecto Región de EE. UU.
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS Nivel de proyecto REGION
Sustituye lo siguiente:
  • Opcional: PROJECT_ID: el ID de tu proyecto. Trusted Cloud Si no se especifica, se usa el proyecto predeterminado.
  • REGION: cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Ejemplos

En esta sección se incluyen ejemplos para consultar la vista INFORMATION_SCHEMA.SCHEMATA_LINKS.

Ejemplo: listar todos los conjuntos de datos vinculados de otro proyecto

En el siguiente ejemplo se muestran todos los conjuntos de datos vinculados a otro proyecto llamado otherproject en la multirregión EU:

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

La salida es similar a la siguiente. Se han omitido algunas columnas para simplificar el resultado.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name    |  schema_name    | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  otherproject      | source_dataset  | subscriptioproject1        |                974999999291  | linked_dataset     |  subscriptionorg1              |         2025-08-07 05:02:27 | NULL            | REGULAR   |
|  otherproject      | source_dataset1 | subscriptionproject2       |                974999999292  | test_dcr           |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

Ejemplo: listar todos los conjuntos de datos vinculados por un conjunto de datos compartido

En el siguiente ejemplo se enumeran todos los conjuntos de datos vinculados a un conjunto de datos compartido llamado sharedataset en la multirregión US:

SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_LINKS WHERE schema_name = 'sharedataset';

La salida es similar a la siguiente. Se han omitido algunas columnas para simplificar el resultado.


+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name     |  schema_name   | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  myproject          | sharedataset   | subscriptionproject1       |                974999999291  | linked_dataset     |  subscriptionorg1              |         2025-08-07 05:02:27 | NULL            | REGULAR   |
|  myproject          | sharedataset   | subscriptionproject2       |                974999999292  | test_dcr           |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

Ejemplo: listar todos los recursos compartidos mediante una sala blanca de datos

En el siguiente ejemplo se enumeran todos los recursos individuales, como tablas o vistas, que se comparten mediante una sala limpia de datos de otro proyecto llamado otherproject en la multirregión EU:

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS where link_type='DCR';

La salida es similar a la siguiente. Se han omitido algunas columnas para simplificar el resultado.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name     |  schema_name   | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  otherproject       | sharedataset1  | subscriptionproject1       |                 974999999291 | test_dcr1          |  subscriptionorg1              |         2025-08-07 05:02:27 | test_view       | DCR       |
|  otherproject       | sharedataset2  | subscriptionproject2       |                 974999999292 | test_dcr2          |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+