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.

Schema

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. Por ejemplo, region-us.

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               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+