Se usó la API de Cloud Translation para traducir esta página.

Vista de SCHEMATA_LINKS

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS contiene una fila para cada conjunto de datos vinculado que se comparte a través del uso compartido de BigQuery. Esta vista también contiene recursos individuales, como tablas o vistas, en un proyecto que se comparte con salas limpias de datos. En esta vista, se muestra una fila para cada recurso individual del conjunto de datos vinculado.

Permiso necesario

Para consultar la vista INFORMATION_SCHEMA.SCHEMATA_LINKS, necesitas el permiso bigquery.datasets.get de Identity and Access Management (IAM) a nivel de proyecto.

Cada una de las siguientes funciones predefinidas de IAM 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 IAM de BigQuery, consulta Control de acceso con IAM.

Esquema

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS tiene el siguiente esquema:

Nombre de la columna	Tipo de datos	Valor
`catalog_name`	`STRING`	Es el nombre del proyecto que contiene la imagen de origen.
`schema_name`	`STRING`	Es el nombre del conjunto de datos de origen. Es el nombre del conjunto de datos también se conoce como `datasetId`.
`linked_schema_catalog_number`	`STRING`	Es el número del proyecto que contiene el conjunto de datos vinculado.
`linked_schema_catalog_name`	`STRING`	Es el nombre del proyecto que contiene el conjunto de datos vinculado.
`linked_schema_name`	`STRING`	Es el nombre del conjunto de datos vinculado. Es el nombre del conjunto de datos también se conoce como `datasetId`.
`linked_schema_creation_time`	`TIMESTAMP`	Es la hora en la que se creó el conjunto de datos vinculado.
`linked_schema_org_display_name`	`STRING`	Es el nombre visible de la organización en la que se crea el conjunto de datos vinculado.
`shared_asset_id`	`STRING`	Es el ID del recurso que se comparte con las salas limpias de datos. Este valor es `null` si `link_type` es `REGULAR`.
`link_type`	`STRING`	Es el tipo de conjunto de datos vinculado. Los valores posibles son `REGULAR` o `DCR` (salas limpias de datos).

Permiso y sintaxis

Las consultas realizadas a esta vista deben incluir un calificador de región. Si no especificas un calificador regional, los metadatos se recuperan de la región de EE.UU. En la siguiente tabla, se explica el permiso de la región para esta vista:

Nombre de la vista	Permiso del recurso	Permiso 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`

Reemplaza lo siguiente:

Opcional: PROJECT_ID: Es el ID de tu proyecto de Google Cloud . Si no se especifica, se usa el proyecto predeterminado.
REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Nota: Debes usar un calificador de región para consultar las vistas INFORMATION_SCHEMA. La ubicación de la ejecución de la consulta debe coincidir con la región de la vista INFORMATION_SCHEMA.

Ejemplos

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

Ejemplo: Enumera todos los conjuntos de datos vinculados en otro proyecto

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

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

El resultado es similar al siguiente. Algunas columnas se omiten 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: Enumera todos los conjuntos de datos vinculados por un conjunto de datos compartidos

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

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

El resultado es similar al siguiente. Algunas columnas se omiten 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: Enumera todos los recursos compartidos con una sala limpia de datos

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

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

El resultado es similar al siguiente. Algunas columnas se omiten 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       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+