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 SEARCH_INDEX_COLUMN_OPTIONS 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 PARTITIONS TABLES TABLE_OPTIONS TABLE_CONSTRAINTS TABLE_SNAPSHOTS TABLE_STORAGE_BY_PROJECT^† TABLE_STORAGE_BY_FOLDER TABLE_STORAGE_BY_ORGANIZATION TABLE_STORAGE_USAGE_TIMELINE TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
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.

Catatan: Tidak semua tampilan INFORMATION_SCHEMA didukung untuk tabel sistem BigQuery Omniry. Anda dapat melihat metadata resource dengan INFORMATION_SCHEMA untuk Amazon S3 dan Azure Storage.

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:

• INFORMATION_SCHEMA.PARTITIONS
• INFORMATION_SCHEMA.SEARCH_INDEXES
• INFORMATION_SCHEMA.SEARCH_INDEX_COLUMNS
• INFORMATION_SCHEMA.SEARCH_INDEX_OPTIONS

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.