Pengantar INFORMATION_SCHEMA

Tampilan INFORMATION_SCHEMA BigQuery adalah tampilan hanya-baca yang ditentukan oleh sistem yang menyediakan informasi metadata tentang objek BigQuery Anda. Tabel berikut mencantumkan semua tampilan INFORMATION_SCHEMA yang dapat Anda kueri untuk mengambil informasi metadata:

Jenis aset Tampilan INFORMATION_SCHEMA
Kontrol akses OBJECT_PRIVILEGES
BI Engine BI_CAPACITIES
BI_CAPACITY_CHANGES
Konfigurasi EFFECTIVE_PROJECT_OPTIONS
ORGANIZATION_OPTIONS
ORGANIZATION_OPTIONS_CHANGES
PROJECT_OPTIONS
PROJECT_OPTIONS_CHANGES
Set data SCHEMATA
SCHEMATA_LINKS
SCHEMATA_OPTIONS
SHARED_DATASET_USAGE
SCHEMATA_REPLICAS
SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION
Pekerjaan JOBS_BY_PROJECT†
JOBS_BY_USER
JOBS_BY_FOLDER
JOBS_BY_ORGANIZATION
Tugas menurut timeslice JOBS_TIMELINE_BY_PROJECT†
JOBS_TIMELINE_BY_USER
JOBS_TIMELINE_BY_FOLDER
JOBS_TIMELINE_BY_ORGANIZATION
Rekomendasi dan insight INSIGHTS
RECOMMENDATIONS
RECOMMENDATIONS_BY_ORGANIZATION
Reservasi ASSIGNMENTS_BY_PROJECT†
ASSIGNMENT_CHANGES_BY_PROJECT†
CAPACITY_COMMITMENTS_BY_PROJECT†
CAPACITY_COMMITMENT_CHANGES_BY_PROJECT†
RESERVATIONS_BY_PROJECT†
RESERVATION_CHANGES_BY_PROJECT†
RESERVATIONS_TIMELINE_BY_PROJECT†
Rutinitas PARAMETERS
ROUTINES
ROUTINE_OPTIONS
Indeks penelusuran SEARCH_INDEXES
SEARCH_INDEX_COLUMNS
Sesi SESSIONS_BY_PROJECT†
SESSIONS_BY_USER
Streaming STREAMING_TIMELINE_BY_PROJECT†
STREAMING_TIMELINE_BY_FOLDER
STREAMING_TIMELINE_BY_ORGANIZATION
Tabel COLUMNS
COLUMN_FIELD_PATHS
CONSTRAINT_COLUMN_USAGE
KEY_COLUMN_USAGE
PARTITIONS
TABLES
TABLE_OPTIONS
TABLE_CONSTRAINTS
TABLE_SNAPSHOTS
TABLE_STORAGE_BY_PROJECT†
TABLE_STORAGE_BY_ORGANIZATION
TABLE_STORAGE_USAGE_TIMELINE
TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
Indeks vektor VECTOR_INDEXES
VECTOR_INDEX_COLUMNS
VECTOR_INDEX_OPTIONS
Dilihat VIEWS
MATERIALIZED_VIEWS
Write API WRITE_API_TIMELINE_BY_PROJECT†
WRITE_API_TIMELINE_BY_FOLDER
WRITE_API_TIMELINE_BY_ORGANIZATION

† Untuk tampilan *BY_PROJECT, akhiran BY_PROJECT bersifat opsional. Misalnya, kueri INFORMATION_SCHEMA.JOBS_BY_PROJECT dan INFORMATION_SCHEMA.JOBS akan menampilkan hasil yang sama.

Harga

Untuk project yang menggunakan harga sesuai permintaan, kueri terhadap tampilan INFORMATION_SCHEMA akan dikenai biaya pemrosesan data minimum sebesar 10 MB, meskipun byte yang diproses oleh kueri kurang dari 10 MB. 10 MB adalah jumlah penagihan minimum untuk kueri sesuai permintaan. Untuk mengetahui informasi selengkapnya, lihat Harga on demand.

Untuk project yang menggunakan harga berbasis kapasitas, kueri terhadap tampilan dan tabel INFORMATION_SCHEMA akan menggunakan slot BigQuery yang Anda beli. Untuk mengetahui informasi selengkapnya, lihat harga berdasarkan kapasitas.

Kueri INFORMATION_SCHEMA tidak di-cache, maka Anda akan dikenai biaya setiap kali menjalankan kueri INFORMATION_SCHEMA, meskipun teks kueri tersebut sama setiap kali Anda menjalankannya.

Anda tidak akan ditagih biaya penyimpanan untuk tampilan INFORMATION_SCHEMA.

Sintaks

Tampilan INFORMATION_SCHEMA harus memenuhi syarat dengan set data atau region.

Penentu set data

Jika ada, penentu set data membatasi hasil ke set data yang ditentukan. Contoh:

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

Tampilan INFORMATION_SCHEMA berikut mendukung penentu set data:

  • COLUMNS
  • COLUMN_FIELD_PATHS
  • MATERIALIZED_VIEWS
  • PARAMETERS
  • PARTITIONS
  • ROUTINES
  • ROUTINE_OPTIONS
  • TABLES
  • TABLE_OPTIONS
  • VIEWS

Penentu region

Penentu region direpresentasikan menggunakan sintaksis region-REGION. Semua Nama lokasi set data dapat digunakan untuk REGION. Misalnya, penentu region berikut valid:

  • region-us
  • region-asia-east2
  • region-europe-north1

Jika ada, penentu wilayah membatasi hasil ke lokasi yang ditentukan. Misalnya, kueri berikut menampilkan metadata untuk semua set data dalam sebuah project di multi-region US:

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

Tampilan INFORMATION_SCHEMA berikut tidak mendukung penentu wilayah:

Jika penentu wilayah atau penentu set data tidak ditentukan, Anda akan menerima error.

Kueri terhadap tampilan INFORMATION_SCHEMA yang memenuhi syarat region dijalankan di region yang Anda tentukan, yang berarti Anda tidak dapat menulis satu kueri untuk menggabungkan data dari tampilan di region yang berbeda. Untuk menggabungkan tampilan INFORMATION_SCHEMA dari beberapa region, tulis hasil kueri ke tabel, lalu salin tabel atau pindahkan set data ke region yang sama.

Penentu project

Jika ada, penentu project membatasi hasil ke proyek yang ditentukan. Contoh:

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

Semua tampilan INFORMATION_SCHEMA mendukung penentu project. Jika penentu project tidak ditentukan, tampilan akan ditetapkan secara default ke project tempat kueri dijalankan.

Menentukan penentu project untuk tampilan level organisasi (misalnya STREAMING_TIMELINE_BY_ORGANIZATION) tidak memengaruhi hasilnya.

Batasan

  • Kueri INFORMATION_SCHEMA BigQuery harus dalam sintaksis GoogleSQL. INFORMATION_SCHEMA tidak mendukung SQL lama.
  • Hasil kueri INFORMATION_SCHEMA tidak di-cache.
  • Tampilan INFORMATION_SCHEMA tidak dapat digunakan dalam pernyataan DDL.
  • Tampilan INFORMATION_SCHEMA tidak berisi informasi tentang set data tersembunyi.
  • Kueri INFORMATION_SCHEMA dengan penentu region dapat menyertakan metadata dari resource di region tersebut dari set data yang dihapus yang berada dalam periode perjalanan waktu Anda.
  • Saat Anda mencantumkan resource dari tampilan INFORMATION_SCHEMA, izin hanya diperiksa di tingkat induk, bukan di tingkat baris individual. Oleh karena itu, kebijakan tolak (pratinjau) apa pun yang secara kondisional menargetkan setiap baris menggunakan tag akan diabaikan.