Visualização do SCHEMATA_LINKS
A visualização INFORMATION_SCHEMA.SCHEMATA_LINKS contém uma linha para cada conjunto de dados vinculado. Um conjunto de dados vinculado é vinculado a um conjunto de dados compartilhado em um projeto que o
usuário atual tem acesso.
Permissão necessária
Para consultar a visualização INFORMATION_SCHEMA.SCHEMATA_LINKS, é necessário ter a permissão bigquery.datasets.get
do Identity and Access Management (IAM) no nível do
projeto.
Cada um dos seguintes papéis predefinidos do IAM inclui as
permissões necessárias para consultar a
visualização INFORMATION_SCHEMA.SCHEMATA_LINKS:
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewer
Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.
Esquema
A visualização INFORMATION_SCHEMA.SCHEMATA_LINKS tem o seguinte esquema:
| Nome da coluna | Tipo de dados | Valor |
|---|---|---|
CATALOG_NAME
|
STRING
|
O nome do projeto que contém o conjunto de dados de origem. |
SCHEMA_NAME
|
STRING
|
O nome do conjunto de dados de origem. O nome do conjunto de dados também é conhecido como
datasetId.
|
LINKED_SCHEMA_CATALOG_NUMBER
|
STRING
|
O número do projeto que contém o conjunto de dados vinculado. |
LINKED_SCHEMA_CATALOG_NAME
|
STRING
|
O nome do projeto que contém o conjunto de dados vinculado. |
LINKED_SCHEMA_NAME
|
STRING
|
Nome do conjunto de dados vinculado. O nome do conjunto de dados também é conhecido como
datasetId.
|
LINKED_SCHEMA_CREATION_TIME
|
TIMESTAMP
|
A hora em que o conjunto de dados vinculado foi criado. |
LINKED_SCHEMA_ORG_DISPLAY_NAME
|
STRING
|
É o nome de exibição da organização em que o conjunto de dados vinculado é criado. |
Escopo e sintaxe
As consultas nessa visualização precisam incluir um qualificador de região. Se você não especificar um qualificador regional, os metadados serão recuperados da região dos EUA. A tabela a seguir explica o escopo da região dessa visualização:
| Acessar nome | Escopo do recurso | Escopo da região |
|---|---|---|
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS |
Nível do projeto | Região dos EUA |
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS |
Nível do projeto | REGION |
- Opcional:
PROJECT_ID: o ID do seu projeto do Google Cloud. Se não for especificado, o projeto padrão será usado.
REGION: qualquer nome da região do conjunto de dados.
Por exemplo, region-us.
Exemplos
Esta seção lista exemplos para consultar a visualização
INFORMATION_SCHEMA.SCHEMATA_LINKS.
Exemplo: listar todos os conjuntos de dados vinculados em outro projeto
No exemplo a seguir, listamos todos os conjuntos de dados vinculados em outro projeto chamado otherproject na região eu:
SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;
A resposta será semelhante a esta: Algumas colunas são omitidas para simplificar a saída.
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+ | 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 | +----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
Exemplo: listar todos os conjuntos de dados vinculados por um conjunto de dados compartilhado
No exemplo a seguir, listamos todos os conjuntos de dados vinculados por um conjunto de dados compartilhado chamado sharedataset na multirregião US:
SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_LINKS WHERE schema_name = 'sharedataset';
A resposta será semelhante a esta: Algumas colunas são omitidas para simplificar a saída.
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+ | 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 | +----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+