Visualização do SCHEMATA_LINKS
A visualização INFORMATION_SCHEMA.SCHEMATA_LINKS contém uma linha para cada conjunto de dados vinculado compartilhado usando o compartilhamento do BigQuery. Essa visualização também contém recursos individuais, como tabelas ou visualizações, em um projeto compartilhado usando data clean rooms. Essa visualização mostra uma linha para cada recurso individual no conjunto de dados vinculado.
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. |
shared_asset_id
|
STRING
|
O ID do recurso compartilhado usando data clean rooms. Esse valor é null se link_type for REGULAR.
|
link_type
|
STRING
|
O tipo de conjunto de dados vinculado. Os valores possíveis são REGULAR ou DCR (data clean rooms).
|
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 multirregiã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 | linked_schema_creation_time | shared_asset_id | link_type | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+ | otherproject | source_dataset | subscriptioproject1 | 974999999291 | linked_dataset | subscriptionorg1 | 2025-08-07 05:02:27 | NULL | REGULAR | | otherproject | source_dataset1 | subscriptionproject2 | 974999999292 | test_dcr | subscriptionorg2 | 2025-08-07 10:08:50 | test_table | DCR | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
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 | linked_schema_creation_time | shared_asset_id | link_type | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+ | myproject | sharedataset | subscriptionproject1 | 974999999291 | linked_dataset | subscriptionorg1 | 2025-08-07 05:02:27 | NULL | REGULAR | | myproject | sharedataset | subscriptionproject2 | 974999999292 | test_dcr | subscriptionorg2 | 2025-08-07 10:08:50 | test_table | DCR | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
Exemplo: listar todos os recursos compartilhados usando uma data clean room
O exemplo a seguir lista todos os recursos individuais, como tabelas ou
visualizações, que são compartilhados usando uma data clean room de outro projeto chamado
otherproject na multirregião EU:
SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS where link_type='DCR';
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 | linked_schema_creation_time | shared_asset_id | link_type | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+ | otherproject | sharedataset1 | subscriptionproject1 | 974999999291 | test_dcr1 | subscriptionorg1 | 2025-08-07 05:02:27 | test_view | DCR | | otherproject | sharedataset2 | subscriptionproject2 | 974999999292 | test_dcr2 | subscriptionorg2 | 2025-08-07 10:08:50 | test_table | DCR | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+