Tampilan SCHEMATA

Tampilan INFORMATION_SCHEMA.SCHEMATA memberikan informasi tentang set data dalam project atau region. Tampilan menampilkan satu baris untuk setiap set data.

Sebelum memulai

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

Setiap peran IAM bawaan berikut mencakup izin yang Anda perlukan untuk mendapatkan tampilan SCHEMATA:

  • 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, hasil kueri akan berisi satu baris untuk setiap set data dalam project yang ditentukan.

Tampilan INFORMATION_SCHEMA.SCHEMATA 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
SCHEMA_OWNER STRING Nilainya selalu NULL
CREATION_TIME TIMESTAMP Waktu pembuatan set data
LAST_MODIFIED_TIME TIMESTAMP Waktu set data terakhir diubah
LOCATION STRING Lokasi geografis set data
DDL STRING Pernyataan DDL CREATE SCHEMA yang dapat digunakan untuk membuat set data
DEFAULT_COLLATION_NAME STRING Nama spesifikasi pengumpulan default jika ada; jika tidak, NULL.

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

    Contoh

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

    `PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA
     misalnya, `myproject`.INFORMATION_SCHEMA.SCHEMATA.

    SELECT
  * EXCEPT (schema_owner)
FROM
  INFORMATION_SCHEMA.SCHEMATA;

    Hasilnya mirip dengan berikut ini. Agar mudah dibaca, beberapa kolom dikecualikan dari hasil.

    +----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
|  catalog_name  |  schema_name  |    creation_time    | last_modified_time  |  location  |                   ddl                    |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset1    | 2018-11-07 19:50:24 | 2018-11-07 19:50:24 | US         | CREATE SCHEMA `myproject.mydataset1`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset2    | 2018-07-16 04:24:22 | 2018-07-16 04:24:22 | US         | CREATE SCHEMA `myproject.mydataset2`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   default_partition_expiration_days=3.0, |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset3    | 2018-02-07 21:08:45 | 2018-05-01 23:32:53 | US         | CREATE SCHEMA `myproject.mydataset3`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   description="My dataset",              |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+