Vista SCHEMATA_LINKS

A vista INFORMATION_SCHEMA.SCHEMATA_LINKS contém uma linha para cada conjunto de dados associado que é partilhado através da partilha do BigQuery. Esta vista também contém recursos individuais, como tabelas ou vistas, num projeto partilhado através de salas de dados confidenciais. Esta vista apresenta uma linha para cada recurso individual no conjunto de dados associado.

Autorização necessária

Para consultar a vista INFORMATION_SCHEMA.SCHEMATA_LINKS, precisa da autorização de gestão de identidade e de acesso (IAM) bigquery.datasets.get ao nível do projeto.

Cada uma das seguintes funções de IAM predefinidas inclui as autorizações de que precisa para consultar a vista INFORMATION_SCHEMA.SCHEMATA_LINKS:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com o IAM.

Esquema

A vista 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 associado.
linked_schema_catalog_name STRING O nome do projeto que contém o conjunto de dados associado.
linked_schema_name STRING O nome do conjunto de dados associado. O nome do conjunto de dados também é conhecido como datasetId.
linked_schema_creation_time TIMESTAMP A hora em que o conjunto de dados associado foi criado.
linked_schema_org_display_name STRING O nome a apresentar da organização na qual o conjunto de dados associado é criado.
shared_asset_id STRING O ID do recurso que é partilhado através de salas limpas de dados. Este valor é null se link_type for REGULAR.
link_type STRING O tipo de conjunto de dados associado. Os valores possíveis são REGULAR ou DCR (salas limpas de dados).

Âmbito e sintaxe

As consultas a esta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos da região dos EUA. A tabela seguinte explica o âmbito da região para esta vista:

Nome da vista Âmbito do recurso Âmbito 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
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Trusted Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Exemplos

Esta secção apresenta exemplos para consultar a vista INFORMATION_SCHEMA.SCHEMATA_LINKS.

Exemplo: liste todos os conjuntos de dados associados a outro projeto

O exemplo seguinte apresenta todos os conjuntos de dados associados a outro projeto denominado otherproject na multirregião EU:

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

O resultado é semelhante ao seguinte. Algumas colunas são omitidas para simplificar o resultado.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    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: liste todos os conjuntos de dados associados por um conjunto de dados partilhado

O exemplo seguinte apresenta todos os conjuntos de dados associados por um conjunto de dados partilhado com o nome sharedataset na multirregião US:

SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_LINKS WHERE schema_name = 'sharedataset';

O resultado é semelhante ao seguinte. Algumas colunas são omitidas para simplificar o resultado.


+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    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: liste todos os recursos partilhados através de uma sala limpa de dados

O exemplo seguinte apresenta todos os recursos individuais, como tabelas ou vistas, que são partilhados através de uma sala limpa de dados de outro projeto denominado otherproject na multirregião EU:

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS where link_type='DCR';

O resultado é semelhante ao seguinte. Algumas colunas são omitidas para simplificar o resultado.

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