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

Sintaks

CALL BQ.CANCEL_INDEX_ALTERATION(table_name, index_name);

Deskripsi

Membatalkan perubahan yang dimulai pengguna pada indeks penelusuran atau membangun ulang indeks vektor.

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 direktori data tabel di Cloud Storage dalam format 'gs://table_data_directory/subdirectory/.../'. Agar pemuatan ulang selektif berfungsi dengan benar, parameter jalur Cloud Storage harus menyertakan jalur tertentu atau karakter pengganti. Untuk informasi selengkapnya, lihat Dukungan karakter pengganti untuk URI Cloud Storage. Hal ini memungkinkan Anda memuat ulang metadata tabel saja dari subdirektori tersebut dan dengan demikian 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 direferensikan oleh set data tertaut melalui set data eksternal.
  • Pemuatan ulang 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.

BQ.SHOW_GRAPH_EXPAND_SCHEMA

Sintaks

CALL BQ.SHOW_GRAPH_EXPAND_SCHEMA(graph_name, output_schema);

Deskripsi

Mengisi variabel output_schema yang Anda berikan dengan skema tabel yang ditampilkan dengan memanggil GRAPH_EXPAND TVF pada graph_name.

Tentukan nama grafik sebagai string dengan format '[project_id.]dataset.graph'. Setiap kolom yang ditampilkan oleh TVF GRAPH_EXPAND mewakili properti dalam grafik. Output mencakup nama, jenis, dan mode untuk setiap kolom. Jika properti memiliki deskripsi atau sinonim yang ditentukan di dalamnya, properti tersebut akan muncul di kolom description untuk kolom tersebut. Jika properti menentukan metrik, maka output akan menyertakan "is_measure":true untuk kolom tersebut.

Contoh

DECLARE schema STRING;
CALL BQ.SHOW_GRAPH_EXPAND_SCHEMA('my_project.my_dataset.my_graph', schema);
SELECT schema;

Outputnya akan terlihat mirip seperti berikut:

{
  "fields":[
    {
      "name":"Department_dept_name",
      "type":"STRING",
      "mode":"NULLABLE",
      "description":
        "{\"description\":\"The name of the academic department\",
          \"synonyms\":[\"division\"]}"
    },
    {
      "name":"Department_budget",
      "type":"FLOAT",
      "mode":"NULLABLE"
    },
    {
      "name":"Department_total_budget",
      "type":"FLOAT",
      "mode":"NULLABLE",
      "is_measure":true
    }
  ]
}