Vista SCHEMATA_LINKS

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

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 el artículo sobre el 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.

Á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 Google Cloud proyecto. 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 regió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 |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| otherproject   | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg2               |
| otherproject   | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg2               |
| otherproject   | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

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