Mengelola konfigurasi default
Dokumen ini menjelaskan cara membuat dan mengambil setelan konfigurasi default di tingkat organisasi atau project.
Untuk membantu mengelola tugas, Anda dapat mengonfigurasi setelan default dalam BigQuery. Setelan yang menggunakan layanan ini dikonfigurasi di tingkat organisasi atau project, tetapi dapat diganti di tingkat sesi atau tugas. Anda dapat mengonfigurasi setelan default bersama dengan kebijakan organisasi terkait untuk menerapkan perilaku default.
Harga
Tidak ada biaya tambahan untuk menggunakan layanan konfigurasi BigQuery. Untuk informasi selengkapnya, lihat pricing.
Konfigurasi default
Anda dapat menetapkan konfigurasi default untuk setelan berikut:
default_time_zone
: Zona waktu default untuk digunakan dalam fungsi SQL yang bergantung pada zona waktu, jika zona waktu tidak ditentukan sebagai argumen. Konfigurasi ini tidak berlaku untuk tabel berpartisi kolom satuan waktu (yang menggunakan UTC sebagai zona waktu), transfer jadwal Storage Transfer Service, atau memuat data dengan alat command line bq. Untuk informasi selengkapnya, lihat zona waktu.default_kms_key_name
: Kunci Cloud Key Management Service default untuk mengenkripsi data tabel, termasuk tabel sementara atau anonim. Untuk informasi lebih lanjut, lihat Kunci Cloud KMS yang dikelola pelanggan.default_query_job_timeout_ms
: Waktu default saat waktu tugas kueri habis, termasuk waktu tugas diantrekan dan waktu yang dihabiskan untuk berjalan. Periode waktu tunggu habis harus antara lima menit hingga enam jam.default_interactive_query_queue_timeout_ms
: Jumlah waktu default, dalam milidetik, saat kueri interaktif dimasukkan ke antrean. Jika tidak disetel, default-nya adalah enam jam. Nilai minimumnya adalah 1 milidetik. Nilai maksimumnya adalah 48 jam. Untuk menonaktifkan antrean kueri interaktif, setel nilai ke -1.default_batch_query_queue_timeout_ms
: Jumlah waktu default, dalam milidetik, saat kueri batch dimasukkan ke antrean. Jika tidak disetel, defaultnya adalah 24 jam. Nilai minimumnya adalah 1 milidetik. Nilai maksimumnya adalah 48 jam. Untuk menonaktifkan antrean kueri batch, setel nilai ke -1.
Membuat konfigurasi default
Bagian ini menjelaskan cara membuat konfigurasi.
Izin yang diperlukan
Untuk membuat konfigurasi, Anda memerlukan izin Identity and Access Management (IAM) bigquery.config.update
. Peran IAM bawaan roles/bigquery.admin
mencakup izin yang Anda perlukan untuk membuat konfigurasi.
Untuk informasi selengkapnya tentang peran dan izin IAM dalam BigQuery, baca Peran dan izin bawaan.
Mengonfigurasi setelan default
Anda dapat mengonfigurasi setelan default di tingkat organisasi atau project menggunakan pernyataan SQL berikut. Saat membuat konfigurasi, Anda harus menentukan region tempat konfigurasi tersebut diterapkan. Anda hanya dapat menggunakan satu region untuk setiap pernyataan.
Mengonfigurasi setelan organisasi
Untuk mengonfigurasi setelan organisasi, gunakan
pernyataan DDL ALTER ORGANIZATION SET OPTIONS
.
Contoh berikut menetapkan zona waktu default ke America/Chicago
, kunci Cloud KMS default ke kunci yang ditentukan pengguna, waktu tunggu kueri default ke 30 menit, waktu tunggu antrean kueri interaktif default ke 10 menit, dan waktu tunggu antrean kueri batch default ke 20 menit:
ALTER ORGANIZATION SET OPTIONS ( `REGION.default_time_zone `= 'America/Chicago', -- Ensure all service accounts under the organization have permission to KMS_KEY `REGION.default_kms_key_name` = KMS_KEY, `REGION.default_query_job_timeout_ms` = 1800000, `REGION.default_interactive_query_queue_timeout_ms` = 600000, `REGION.default_batch_query_queue_timeout_ms` = 1200000);
Ganti kode berikut:
- REGION: region yang terkait dengan project atau organisasi Anda. Misalnya,
region-us
atauregion-europe-west6
. - KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk mengetahui informasi selengkapnya tentang kunci Cloud KMS, baca Kunci Cloud KMS yang dikelola pelanggan.
Contoh berikut menghapus semua setelan default tingkat organisasi:
ALTER ORGANIZATION SET OPTIONS ( `REGION.default_time_zone` = NULL, `REGION.default_kms_key_name` = NULL, `REGION.default_query_job_timeout_ms` = NULL, `REGION.default_interactive_query_queue_timeout_ms` = NULL, `REGION.default_batch_query_queue_timeout_ms` = NULL);
Konfigurasikan setelan project
Untuk mengonfigurasi setelan project, gunakan
pernyataan DDL ALTER PROJECT SET OPTIONS
.
Pernyataan DDL ALTER PROJECT SET OPTIONS
secara opsional menerima variabel project_id
. Jika tidak ditentukan, project_id
akan ditetapkan secara default ke project saat ini tempat kueri berjalan.
Contoh berikut menetapkan zona waktu default ke America/Los_Angeles
, kunci Cloud KMS default ke kunci contoh, waktu tunggu kueri default ke 1 jam, waktu tunggu antrean kueri interaktif default ke 10 menit, dan waktu tunggu antrean kueri batch default hingga 20 menit:
ALTER PROJECT project_id SET OPTIONS ( `REGION.default_time_zone` = 'America/Los_Angeles', -- Ensure all service accounts under the project have permission to KMS_KEY `REGION.default_kms_key_name` = KMS_KEY, `REGION.default_query_job_timeout_ms` = 3600000, `REGION.default_interactive_query_queue_timeout_ms` = 600000, `REGION.default_batch_query_queue_timeout_ms` = 1200000);
Contoh berikut menghapus semua setelan default tingkat project. Setelan default menggunakan setelan default tingkat organisasi apa pun, jika ada. Jika tidak, semua setelan default akan ditetapkan ke default global.
ALTER PROJECT project_id SET OPTIONS ( `REGION.default_time_zone` = NULL, `REGION.default_kms_key_name` = NULL, `REGION.default_query_job_timeout_ms` = NULL, `REGION.default_interactive_query_queue_timeout_ms` = NULL, `REGION.default_batch_query_queue_timeout_ms` = NULL);
Konfigurasi tingkat project akan mengganti konfigurasi tingkat organisasi. Konfigurasi tingkat project kemudian dapat diganti oleh konfigurasi tingkat sesi, yang dapat diganti oleh konfigurasi tingkat tugas.
Mengambil nilai konfigurasi
Anda dapat melihat setelan konfigurasi default untuk organisasi atau project dengan melihat skema informasi. Ada tiga tampilan yang berbeda untuk kueri:
INFORMATION_SCHEMA.PROJECT_OPTIONS
: konfigurasi yang diterapkan ke projectINFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
: konfigurasi efektif yang diterapkan ke project. Konfigurasi yang efektif mencakup semua konfigurasi yang ditetapkan di tingkat project serta semua setelan yang diwarisi oleh project dari organisasiINFORMATION_SCHEMA.ORGANIZATION_OPTIONS
: konfigurasi yang diterapkan ke organisasi
Mungkin perlu waktu beberapa menit agar konfigurasi baru menjadi efektif dan
ditampilkan dalam tampilan INFORMATION_SCHEMA
.
Izin yang diperlukan
Untuk mengambil nilai konfigurasi, Anda memerlukan izin IAM bigquery.config.get
.
Setiap peran IAM bawaan berikut mencakup izin yang Anda perlukan untuk mendapatkan konfigurasi dari tampilan INFORMATION_SCHEMA
:
roles/bigquery.jobUser
roles/bigquery.dataEditor
roles/bigquery.dataUser
Untuk informasi selengkapnya tentang peran dan izin IAM dalam BigQuery, baca Peran dan izin bawaan.
Contoh
Untuk melihat konfigurasi di bagian organisasi dalam region us
, jalankan kueri berikut:
SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;
Untuk melihat konfigurasi yang efektif pada project default Anda di region us
, jalankan kueri berikut:
SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;
Untuk melihat konfigurasi pada project default Anda di region us
, jalankan kueri berikut:
SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;