Vista de SCHEMATA_LINKS

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS contiene una fila para cada conjunto de datos vinculado. Un conjunto de datos vinculado conecta un conjunto de datos compartido en un proyecto al que tiene acceso el usuario actual.

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.

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: el ID del proyecto de Google Cloud. Si no se especifica, se usa el proyecto predeterminado.

+ REGION: Cualquier nombre de región del conjunto de datos. Un ejemplo es 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 regió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 |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| otherproject   | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg2               |
| otherproject   | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg2               |
| otherproject   | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

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 |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | sharedataset| subscriptionproject1       |                 674999999291 | subscriptionld1    | subscriptionorg1               |
| myproject      | sharedataset| subscriptionproject2       |                 774999999292 | subscriptionld2    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+