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_type 為 REGULAR ,這個值為 null 。
|
link_type
|
STRING
|
連結資料集的類型。可能的值為 REGULAR 或 DCR (資料無塵室)。
|
範圍和語法
對這個檢視表執行的查詢必須包含區域限定詞。如果未指定區域限定符,系統會從美國地區擷取中繼資料。下表說明這個檢視畫面的區域範圍:
檢視表名稱 | 資源範圍 | 區域範圍 |
---|---|---|
[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 | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+