SCHEMATA_LINKS 檢視畫面

INFORMATION_SCHEMA.SCHEMATA_LINKS 檢視畫面會為每個透過 BigQuery 共用功能共用的連結資料集,包含一個資料列。這個檢視畫面也包含使用資料無塵室共用的專案中,個別的資源 (例如資料表或檢視表)。這個檢視畫面會為連結資料集中的每個資源顯示一行。

必要權限

如要查詢 INFORMATION_SCHEMA.SCHEMATA_LINKS 檢視畫面,您必須具備專案層級的 bigquery.datasets.get Identity and Access Management (IAM) 權限。

下列每個預先定義的 IAM 角色都包含查詢 INFORMATION_SCHEMA.SCHEMATA_LINKS 檢視畫面所需的權限:

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

如要進一步瞭解 BigQuery 權限,請參閱「使用 IAM 控管存取權」。

結構定義

INFORMATION_SCHEMA.SCHEMATA_LINKS 檢視表具有下列結構定義:

資料欄名稱 資料類型
catalog_name STRING 來源資料集所屬專案的名稱。
schema_name STRING 來源資料集的名稱。資料集名稱也稱為 datasetId
linked_schema_catalog_number STRING 含有連結資料集的專案編號。
linked_schema_catalog_name STRING 包含連結資料集的專案名稱。
linked_schema_name STRING 連結資料集的名稱。資料集名稱也稱為 datasetId
linked_schema_creation_time TIMESTAMP 連結資料集的建立時間。
linked_schema_org_display_name STRING 建立連結資料集的機構顯示名稱。
shared_asset_id STRING 透過資料無塵室共用的資產 ID。如果 link_typeREGULAR,這個值為 null
link_type STRING 連結資料集的類型。可能的值為 REGULARDCR (資料無塵室)。

範圍和語法

對這個檢視表執行的查詢必須包含區域限定詞。如果未指定區域限定符,系統會從美國地區擷取中繼資料。下表說明這個檢視畫面的區域範圍:

檢視表名稱 資源範圍 區域範圍
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS 專案層級 美國區域
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS 專案層級 REGION
取代下列項目:
  • 選用:PROJECT_ID:您的 Google Cloud 專案 ID。如未指定,系統會使用預設專案。
  • REGION:任何資料集區域名稱。 例如:`region-us`

範例

本節列出查詢 INFORMATION_SCHEMA.SCHEMATA_LINKS 檢視區塊的範例。

範例:列出與其他專案連結的所有資料集

以下範例會列出 EU 多地區中,與名為 otherproject 的另一個專案連結的所有資料集:

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

輸出結果大致如下。系統會省略某些資料欄,以便簡化輸出結果。

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

範例:列出共用資料集的所有連結資料集

以下範例會列出 US 多地區中,名為 sharedataset 的共用資料集所連結的所有資料集:

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

輸出結果大致如下。系統會省略某些資料欄,以便簡化輸出結果。


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

範例:列出所有透過資料無塵室共用的資源

以下範例列出所有個別資源 (例如資料表或檢視區塊),這些資源是透過名為 EU 多區域中的 otherproject 專案,使用資料淨室共用:

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

輸出結果大致如下。系統會省略某些資料欄,以便簡化輸出結果。

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