Mengelola rutinitas

Di BigQuery, rutinitas adalah jenis resource yang mencakup hal-hal berikut:

Prosedur tersimpan.
Fungsi yang ditentukan pengguna (UDF), termasuk fungsi jarak jauh.
Fungsi tabel.

Dokumen ini menjelaskan tugas-tugas yang umum untuk semua jenis rutinitas di BigQuery.

Izin

Untuk menjalankan rutinitas, Anda harus memiliki izin bigquery.routines.get pada set data yang berisi rutinitas tersebut.

Secara default, Anda juga memerlukan izin untuk mengakses resource apa pun yang dirujuk rutinitas, seperti tabel atau tampilan. Untuk fungsi UDF dan tabel, Anda dapat mengizinkan fungsi untuk mengakses resource tersebut atas nama pemanggil. Untuk mengetahui informasi selengkapnya, lihat Fungsi yang diotorisasi.

Membuat rutinitas

Untuk membuat rutinitas, Anda harus memiliki izin bigquery.routines.create.

SQL

Bergantung pada jenis rutinitas, jalankan salah satu pernyataan DDL berikut:

API

Panggil metode routines.insert dengan resource Routine yang ditentukan.

Membuat daftar rutinitas

Untuk membuat daftar rutinitas dalam set data, Anda harus memiliki izin bigquery.routines.get dan bigquery.routines.list.

Konsol

Di konsol Google Cloud, buka halaman BigQuery.

Buka BigQuery
Di panel Explorer, luaskan project Anda dan pilih set data.
Perluas daftar Rutinitas.

SQL

Buat kueri tampilan INFORMATION_SCHEMA.ROUTINES:

Di konsol Google Cloud, buka halaman BigQuery.

Buka BigQuery

Di editor kueri, masukkan pernyataan berikut:

SELECT
  COLUMN_LIST
FROM
   { DATASET | REGION }.INFORMATION_SCHEMA.ROUTINES;

Klik Run.

Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

Ganti kode berikut:

COLUMN_LIST: daftar kolom yang dipisahkan koma dari tampilan INFORMATION_SCHEMA.ROUTINES.
DATASET: nama set data di project Anda.
REGION: penentu region.

Contoh:

SELECT
  routine_name, routine_type, routine_body
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINES;

+------------------+----------------+--------------+
|   routine_name   |  routine_type  | routine_body |
+------------------+----------------+--------------+
| AddFourAndDivide | FUNCTION       | SQL          |
| create_customer  | PROCEDURE      | SQL          |
| names_by_year    | TABLE FUNCTION | SQL          |
+------------------+----------------+--------------+

bq

Gunakan perintah bq ls dengan flag --routines:

bq ls --routines DATASET

Ganti kode berikut:

DATASET: nama set data di project Anda.

Contoh:

bq ls --routines mydataset

         Id              Routine Type        Language    Creation Time    Last Modified Time
------------------ ----------------------- ---------- ----------------- --------------------
 AddFourAndDivide   SCALAR_FUNCTION         SQL        05 May 01:12:03   05 May 01:12:03
 create_customer    PROCEDURE               SQL        21 Apr 19:55:51   21 Apr 19:55:51
 names_by_year      TABLE_VALUED_FUNCTION   SQL        01 Sep 22:59:17   01 Sep 22:59:17

API

Panggil metode routines.list dengan ID set data.

Melihat isi rutinitas

Untuk melihat isi rutinitas, Anda harus memiliki izin bigquery.routines.get.

Konsol

Di konsol Google Cloud, buka halaman BigQuery.

Buka BigQuery
Di panel Explorer, luaskan project Anda dan pilih set data.
Perluas daftar Rutinitas.
Pilih rutinitas. Isi rutinitas tercantum di bagian Kueri rutinitas.

SQL

Pilih kolom routine_definition dari tampilan INFORMATION_SCHEMA.ROUTINES:

Di konsol Google Cloud, buka halaman BigQuery.

Buka BigQuery

Di editor kueri, masukkan pernyataan berikut:

SELECT
  routine_definition
FROM
  { DATASET | REGION }.INFORMATION_SCHEMA.ROUTINES
WHERE
  routine_name = ROUTINE_NAME;

Klik Run.

Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

Ganti kode berikut:

DATASET: nama set data di project Anda.
REGION: penentu region.
ROUTINE_NAME: nama rutinitas.

Contoh:

SELECT
  routine_definition
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINES
WHERE
  routine_name = 'AddFourAndDivide';

+--------------------+
| routine_definition |
+--------------------+
| (x + 4) / y        |
+--------------------+

bq

Gunakan perintah bq show dengan flag --routine:

bq show --routine DATASET.ROUTINE_NAME

Ganti kode berikut:

DATASET: nama set data di project Anda.
ROUTINE_NAME: nama rutinitas.

Contoh:

bq show --routine mydataset.AddFourAndDivide

         Id           Routine Type     Language             Signature             Definition     Creation Time    Last Modified Time
 ------------------ ----------------- ---------- ------------------------------- ------------- ----------------- --------------------
  AddFourAndDivide   SCALAR_FUNCTION   SQL        (x INT64, y INT64) -> FLOAT64   (x + 4) / y   05 May 01:12:03   05 May 01:12:03

API

Panggil metode routines.get dengan ID set data dan nama rutinitas. Isi rutinitas ditampilkan dalam objek Routine.

Menghapus rutinitas

Untuk menghapus rutinitas, Anda harus memiliki izin bigquery.routines.delete.

Konsol

Di konsol Google Cloud, buka halaman BigQuery.

Buka BigQuery
Di panel Explorer, luaskan project Anda dan pilih set data.
Perluas daftar Rutinitas.
Pilih rutinitas.
Luaskan opsi Tindakan, lalu klik Hapus.
Ketikkan "delete" di dialog, lalu klik Hapus untuk mengonfirmasi.

SQL

Bergantung pada jenis rutinitas, jalankan salah satu pernyataan DDL berikut:

Contoh:

DROP FUNCTION IF EXISTS mydataset.AddFourAndDivide

bq

Gunakan perintah bq rm dengan flag --routine:

bq rm --routine DATASET.ROUTINE_NAME

Ganti kode berikut:

DATASET: nama set data di project Anda.
ROUTINE_NAME: nama rutinitas.

Contoh:

bq rm --routine mydataset.AddFourAndDivide

API

Panggil metode routines.delete dengan ID set data dan nama rutinitas.