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.CANCEL_INDEX_ALTERATION

Sintaksis

CALL BQ.CANCEL_INDEX_ALTERATION(table_name, index_name);

Deskripsi

Membatalkan pembangunan ulang indeks vektor yang dimulai pengguna.

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

Anda harus menjalankan prosedur ini di lokasi yang sama dengan tabel yang diindeks. Untuk menetapkan lokasi kueri, lihat Menentukan lokasi.

Contoh

CALL BQ.CANCEL_INDEX_ALTERATION('my_project.my_dataset.indexed_table', 'my_index');

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 secara opsional menentukan satu atau beberapa subdirektori dari direktori data tabel di Cloud Storage dalam format 'gs://table_data_directory/subdirectory/.../'. Dengan demikian, Anda dapat memperbarui hanya 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 tabel BigLake secara selektif:

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

Batasan

Pemuatan ulang cache metadata tidak didukung untuk tabel yang dirujuk oleh set data tertaut melalui set data eksternal.
Refresh cache metadata tidak boleh digunakan dalam Transaksi multi-pernyataan.

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.