Tampilan SCHEMATA_LINKS

Tampilan INFORMATION_SCHEMA.SCHEMATA_LINKS berisi satu baris untuk setiap set data tertaut yang dibagikan menggunakan fitur berbagi BigQuery. Tampilan ini juga berisi resource individual, seperti tabel atau tampilan, dalam project yang dibagikan menggunakan ruang bersih data. Tampilan ini menampilkan satu baris untuk setiap resource individual dalam set data tertaut.

Izin yang diperlukan

Untuk membuat kueri tampilan INFORMATION_SCHEMA.SCHEMATA_LINKS, Anda memerlukan izin Identity and Access Management (IAM) bigquery.datasets.get di level project.

Setiap peran IAM yang telah ditetapkan berikut mencakup izin yang Anda perlukan untuk membuat kueri tampilan INFORMATION_SCHEMA.SCHEMATA_LINKS:

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

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Tampilan INFORMATION_SCHEMA.SCHEMATA_LINKS memiliki skema berikut:

Nama kolom Jenis data Nilai
catalog_name STRING Nama project yang berisi set data sumber.
schema_name STRING Nama set data sumber. Nama set data juga disebut sebagai datasetId.
linked_schema_catalog_number STRING Nomor project dari project yang berisi set data tertaut.
linked_schema_catalog_name STRING Nama project dari project yang berisi set data tertaut.
linked_schema_name STRING Nama set data tertaut. Nama set data juga disebut sebagai datasetId.
linked_schema_creation_time TIMESTAMP Waktu ketika set data tertaut dibuat.
linked_schema_org_display_name STRING Nama tampilan organisasi tempat set data tertaut dibuat.
shared_asset_id STRING ID aset yang dibagikan menggunakan ruang bersih data. Nilai ini adalah null jika link_type adalah REGULAR.
link_type STRING Jenis set data tertaut. Kemungkinan nilainya adalah REGULAR atau DCR (Ruang bersih data).

Cakupan dan sintaksis

Kueri terhadap tampilan ini harus menyertakan penentu region. Jika Anda tidak menentukan penentu regional, metadata akan diambil dari region AS. Tabel berikut menjelaskan cakupan wilayah untuk tampilan ini:

Nama Tampilan Cakupan resource Cakupan region
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS Level project Region AS
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS Level project REGION
Ganti kode berikut:
  • Opsional: PROJECT_ID: ID project Google Cloud Anda. Jika tidak ditentukan, project default akan digunakan.
  • REGION: nama region set data apa pun. Misalnya, `region-us`.

Contoh

Bagian ini mencantumkan contoh untuk membuat kueri tampilan INFORMATION_SCHEMA.SCHEMATA_LINKS.

Contoh: Mencantumkan semua set data yang ditautkan terhadap project lain

Contoh berikut mencantumkan semua set data yang tertaut ke project lain bernama otherproject dalam multi-region EU:

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

Outputnya mirip dengan yang berikut ini. Beberapa kolom dihilangkan untuk menyederhanakan output.

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

Contoh: Mencantumkan semua set data tertaut menurut set data bersama

Contoh berikut mencantumkan semua set data yang tertaut menurut set data bersama bernama sharedataset di multi-region US:

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

Outputnya mirip dengan yang berikut ini. Beberapa kolom dihilangkan untuk menyederhanakan output.


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

Contoh: Mencantumkan semua resource yang dibagikan menggunakan ruang bersih data

Contoh berikut mencantumkan semua resource individual, seperti tabel atau tampilan, yang dibagikan menggunakan ruang bersih data dari project lain bernama otherproject dalam multi-region EU:

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

Outputnya mirip dengan yang berikut ini. Beberapa kolom dihilangkan untuk menyederhanakan output.

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