Tampilan SCHEMATA_OPTIONS

Tampilan INFORMATION_SCHEMA.SCHEMATA_OPTIONS berisi satu baris untuk setiap opsi yang ditetapkan di setiap set data dalam sebuah project.

Sebelum memulai

Untuk membuat kueri tampilan SCHEMATA_OPTIONS untuk metadata set data, Anda memerlukan izin bigquery.datasets.get Identity and Access Management (IAM) pada level project.

Setiap peran IAM yang telah ditetapkan berikut mencakup izin yang Anda perlukan untuk mendapatkan tampilan SCHEMATA_OPTIONS:

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

Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.SCHEMATA_OPTIONS, hasil kueri akan berisi satu baris untuk setiap opsi yang ditetapkan di setiap set data dalam sebuah project.

Tabel virtual INFORMATION_SCHEMA.SCHEMATA_OPTIONS memiliki skema berikut:

Nama kolom	Jenis data	Nilai
`CATALOG_NAME`	`STRING`	Nama project yang berisi set data
`SCHEMA_NAME`	`STRING`	Nama set data, juga disebut sebagai `datasetId`
`OPTION_NAME`	`STRING`	Nama opsi. Untuk daftar opsi yang didukung, lihat daftar opsi skema.
`OPTION_TYPE`	`STRING`	Jenis data opsi
`OPTION_VALUE`	`STRING`	Nilai opsi

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_OPTIONS`	Level project	Region AS
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS	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.

Catatan: Anda harus menentukan lokasi untuk membuat kueri tabel virtual INFORMATION_SCHEMA dan lokasi eksekusi kueri harus cocok dengan region tabel virtual INFORMATION_SCHEMA.

Contoh

-- Returns metadata for datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA_OPTIONS;

Contoh

Mengambil waktu habis masa berlaku tabel default untuk semua set data dalam project Anda

Untuk menjalankan kueri terhadap project selain project default Anda, tambahkan project ID ke set data dalam format berikut:

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS

misalnya, `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

SELECT
  *
FROM
  INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE
  option_name = 'default_table_expiration_days';

Hasilnya serupa dengan berikut ini:

  +----------------+---------------+-------------------------------+-------------+---------------------+
  |  catalog_name  |  schema_name  |          option_name          | option_type |    option_value     |
  +----------------+---------------+-------------------------------+-------------+---------------------+
  | myproject      | mydataset3    | default_table_expiration_days | FLOAT64     | 0.08333333333333333 |
  | myproject      | mydataset2    | default_table_expiration_days | FLOAT64     | 90.0                |
  | myproject      | mydataset1    | default_table_expiration_days | FLOAT64     | 30.0                |
  +----------------+---------------+-------------------------------+-------------+---------------------+

Mengambil label untuk semua set data di project Anda

Untuk menjalankan kueri terhadap project selain project default Anda, tambahkan project ID ke set data dalam format berikut:

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS

; contoh, `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

SELECT
  *
FROM
  INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE
  option_name = 'labels';

Hasilnya serupa dengan berikut ini:

  +----------------+---------------+-------------+---------------------------------+------------------------+
  |  catalog_name  |  schema_name  | option_name |          option_type            |      option_value      |
  +----------------+---------------+-------------+---------------------------------+------------------------+
  | myproject      | mydataset1    | labels      | ARRAY<STRUCT<STRING, STRING>>   | [STRUCT("org", "dev")] |
  | myproject      | mydataset2    | labels      | ARRAY<STRUCT<STRING, STRING>>   | [STRUCT("org", "dev")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+