SCHEMATA_LINKS ビュー
INFORMATION_SCHEMA.SCHEMATA_LINKS ビューには、BigQuery Sharing を使用して共有されるリンクされたデータセットごとに 1 行が表示されます。このビューには、データ クリーンルームを使用して共有されるプロジェクト内のテーブルやビューなどの個々のリソースも含まれます。このビューには、リンクされたデータセット内の個々のリソースごとに 1 行が表示されます。
必要な権限
INFORMATION_SCHEMA.SCHEMATA_LINKS ビューをクエリするには、プロジェクト レベルで bigquery.datasets.get Identity and Access Management（IAM）権限が必要です。
次の各 IAM 事前定義ロールには、INFORMATION_SCHEMA.SCHEMATA_LINKS ビューのクエリに必要な権限が含まれています。
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/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（データ クリーンルーム）です。 |
スコープと構文
このビューに対するクエリでは、リージョン修飾子を指定する必要があります。リージョン修飾子を指定しない場合、メタデータは US リージョンから取得されます。次の表に、このビューのリージョン スコープを示します。
| ビュー名 | リソース スコープ | リージョン スコープ |
|---|---|---|
[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 | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+