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