Tampilan SCHEMATA_OPTIONS

Tampilan INFORMATION_SCHEMA.SCHEMATA_OPTIONS berisi satu baris untuk setiap opsi yang ditetapkan di setiap set data dalam 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.

Tampilan 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 mengetahui daftar opsi yang didukung, lihat daftar opsi skema.

Opsi storage_billing_model hanya ditampilkan untuk set data yang telah diperbarui setelah 1 Desember 2022. Untuk set data yang terakhir diperbarui sebelum tanggal tersebut, model penagihan penyimpanannya adalah LOGICAL.
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`.

    • 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 mirip 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
    ; misalnya, `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

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

    Hasilnya mirip 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")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+