Halaman ini diterjemahkan oleh Cloud Translation API.

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_PRIVILEGESscience`
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	`INSIGHTSscience` `RECOMMENDATIONSscience` `RECOMMENDATIONS_BY_ORGANIZATIONscience`
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` `SEARCH_INDEX_COLUMN_OPTIONSscience` `SEARCH_INDEX_OPTIONS` `SEARCH_INDEXES_BY_ORGANIZATION`
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` `PARTITIONSscience` `TABLES` `TABLE_OPTIONS` `TABLE_CONSTRAINTS` `TABLE_SNAPSHOTS` `TABLE_STORAGE_BY_PROJECT^†` `TABLE_STORAGE_BY_FOLDER` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDERscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATIONscience`
Indeks vektor	`VECTOR_INDEXES` `VECTOR_INDEX_COLUMNS` `VECTOR_INDEX_OPTIONS`
Tampilan	`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.

Karena kueri INFORMATION_SCHEMA tidak di-cache, 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.

Catatan: Anda harus menentukan lokasi untuk membuat kueri tampilan INFORMATION_SCHEMA. Mengkueri tampilan INFORMATION_SCHEMA akan gagal dengan menampilkan error berikut jika lokasi eksekusi kueri tidak cocok dengan lokasi set data atau penentu regional yang digunakan:

 Table myproject: region-us.INFORMATION_SCHEMA.[VIEW] not found in location US

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. Penentu region tidak bersifat hierarkis, yang berarti multi-region Uni Eropa tidak mencakup region europe-* dan multi-region Amerika Serikat tidak mencakup region us-*. Misalnya, kueri berikut menampilkan metadata untuk semua set data di multi-region US untuk project tempat kueri dijalankan, tetapi tidak menyertakan set data di region us-west1:

-- Returns metadata for all datasets in the US multi-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 berjalan 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 wilayah, baca dan gabungkan hasil kueri secara lokal, atau salin tabel yang dihasilkan ke wilayah umum.

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 mungkin menyertakan metadata dari resource di region tersebut dari set data yang dihapus yang berada dalam jangka waktu perjalanan Anda.
Saat Anda mencantumkan resource dari tampilan INFORMATION_SCHEMA, izin hanya diperiksa di tingkat induk, bukan di tingkat baris individual. Oleh karena itu, kebijakan penolakan (pratinjau) yang menargetkan baris individual secara bersyarat menggunakan tag akan diabaikan.