Referensi prosedur sistem

BigQuery mendukung prosedur sistem berikut, yang dapat digunakan mirip dengan prosedur tersimpan yang dibuat pengguna.

BQ.ABORT_SESSION

Sintaks

CALL BQ.ABORT_SESSION([session_id]);

Deskripsi

Menghentikan sesi Anda saat ini.

Secara opsional, Anda dapat menentukan ID sesi, yang memungkinkan Anda menghentikan sesi jika prosedur sistem tidak dipanggil dari sesi tersebut.

Untuk mengetahui informasi selengkapnya, lihat Menghentikan sesi.

BQ.JOBS.CANCEL

Sintaks

CALL BQ.JOBS.CANCEL(job);

Deskripsi

Membatalkan tugas yang sedang berjalan.

Tentukan tugas sebagai string dengan format '[project_id.]job_id'. Jika menjalankan prosedur sistem ini dari project yang berbeda dengan tugas, Anda harus menyertakan project ID. Anda harus menjalankan prosedur di lokasi yang sama dengan tugas.

Untuk informasi selengkapnya, lihat Membatalkan tugas.

BQ.REFRESH_EXTERNAL_METADATA_CACHE

Sintaks

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE(table_name [, [subdirectory_uri, …]]);

Deskripsi

Memuat ulang cache metadata dari tabel BigLake atau tabel objek. Prosedur ini akan gagal jika Anda menjalankannya pada tabel yang memiliki mode caching metadata yang disetel ke AUTOMATIC.

Untuk menjalankan prosedur sistem ini, Anda memerlukan izin bigquery.tables.update dan bigquery.tables.updateData.

Tentukan nama tabel sebagai string dengan format '[project_id.]dataset.table'. Jika Anda menjalankan prosedur sistem ini dari project yang berbeda dengan tabel, Anda harus menyertakan project ID.

Untuk tabel BigLake, Anda dapat menentukan satu atau beberapa subdirektori direktori data tabel di Cloud Storage dalam format 'gs://table_data_directory/subdirectory/.../'. Dengan demikian, Anda hanya dapat memuat ulang metadata tabel dari subdirektori tersebut dan menghindari pemrosesan metadata yang tidak perlu.

Contoh

Untuk memuat ulang semua metadata untuk tabel:

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table')

Untuk memuat ulang metadata secara selektif untuk tabel BigLake:

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table', ['gs://source/uri/sub/path/d1/*', 'gs://source/uri/sub/path/d2/*'])

Batasan

Pembaruan cache metadata tidak didukung untuk tabel yang dirujuk oleh set data tertaut di atas set data eksternal.

BQ.REFRESH_MATERIALIZED_VIEW

Sintaks

CALL BQ.REFRESH_MATERIALIZED_VIEW(view_name);

Deskripsi

Memuat ulang tampilan terwujud.

Tentukan nama tampilan terwujud sebagai string dengan format '[project_id.]dataset.table'. Jika menjalankan prosedur sistem ini dari project yang berbeda dengan tampilan terwujud, Anda harus menyertakan ID project.

Untuk informasi selengkapnya, lihat Pemuatan ulang manual.