Mengelola setelan konfigurasi default
Setelan konfigurasi default di BigQuery dapat membantu organisasi Anda menerapkan keamanan, mengontrol biaya, dan mengoptimalkan performa kueri. Sebagai administrator BigQuery atau Project Owner, Anda dapat menentukan, menghapus, dan mengambil setelan default ini di tingkat organisasi dan project, atau menggantinya untuk setiap sesi dan tugas.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk menentukan atau mengambil setelan konfigurasi, minta administrator untuk memberi Anda peran IAM berikut:
-
Menentukan setelan konfigurasi:
BigQuery Admin (
roles/bigquery.admin) di organisasi atau project Anda -
Mengambil setelan konfigurasi:
BigQuery Job User (
roles/bigquery.jobUser) di project yang ditentukan
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk menentukan atau mengambil setelan konfigurasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk menentukan atau mengambil setelan konfigurasi:
-
Tentukan setelan konfigurasi:
bigquery.config.updatedi organisasi atau project Anda -
Mengambil setelan konfigurasi:
bigquery.config.getpada project yang ditentukan
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Untuk mengetahui informasi lebih lanjut tentang peran dan izin IAM di BigQuery, baca Peran dan izin bawaan.
Menentukan setelan global
Setelan global berlaku di semua lokasi dan tidak menggunakan awalan region-REGION.. Sebaliknya,
setelan regional hanya berlaku untuk lokasi
tertentu. Anda dapat menentukan setelan global di level organisasi atau project.
Lokasi default (default_location) adalah satu-satunya setelan global yang dapat Anda konfigurasi.
Jika Anda tidak menentukan lokasi secara eksplisit, lokasi akan ditentukan dengan salah satu cara berikut:
- Lokasi set data yang dirujuk dalam permintaan. Misalnya, jika kueri mereferensikan tabel atau tampilan dalam set data yang disimpan di region
asia-northeast1, tugas kueri akan berjalan diasia-northeast1. - Region yang ditentukan untuk koneksi yang direferensikan dalam permintaan.
- Lokasi tabel tujuan.
Jika lokasi tidak ditentukan secara eksplisit, dan tidak dapat ditentukan dari resource dalam permintaan, lokasi default akan digunakan. Jika lokasi default tidak ditetapkan, tugas akan berjalan di multi-region US.
Batasan
Setelan konfigurasi global tunduk pada batasan berikut:
- Setelan organisasi dan setelan project global tidak didukung di lokasi BigQuery Omni.
Anda tidak dapat menetapkan
default_locationke lokasi BigQuery Omni, atau mengonfigurasi atau melihat setelan global di lokasi BigQuery Omni. - Anda tidak dapat menggabungkan setelan global dan regional dalam pernyataan DDL
ALTER ORGANIZATION SET OPTIONSatauALTER PROJECT SET OPTIONSyang sama. - Saat Anda mengubah setelan global
default_location, perubahan tersebut dapat memerlukan waktu hingga 10 menit untuk diterapkan. Hingga setelan diterapkan, BigQuery mungkin merutekan tugas yang mengandalkan lokasi default ke lokasi default sebelumnya.
Mengonfigurasi setelan organisasi global
Anda dapat mengonfigurasi setelan global di tingkat organisasi menggunakan
pernyataan DDL ALTER ORGANIZATION SET OPTIONS.
Lokasi default (default_location) adalah satu-satunya setelan global yang dapat Anda konfigurasi di tingkat organisasi. Semua setelan tingkat organisasi lainnya
adalah setelan regional.
Pernyataan DDL ALTER ORGANIZATION SET OPTIONS berlaku untuk organisasi
tempat project saat ini berada.
Untuk mengonfigurasi setelan default_location di tingkat organisasi, ikuti
langkah-langkah berikut:
Konsol
Di konsol Cloud de Confiance , buka halaman BigQuery.
Untuk membuka editor kueri, klik search_insights Untitled query.
Untuk mengonfigurasi setelan
default_location, masukkan pernyataan DDL berikut ke dalam editor kueri:ALTER ORGANIZATION SET OPTIONS ( `default_location` = 'LOCATION' );
Ganti
LOCATIONdengan lokasi region atau multi-region BigQuery. Nilai ini adalah lokasi yang digunakan BigQuery untuk menjalankan tugas saat lokasi tugas tidak dapat disimpulkan dari permintaan—misalnya, saat kueri tidak mereferensikan set data atau koneksi apa pun.Atau, untuk menghapus setelan
default_locationdi tingkat organisasi, masukkan pernyataan DDL berikut ke editor kueri:ALTER ORGANIZATION SET OPTIONS ( `default_location` = NULL );
Klik Run.
bq
Untuk mengonfigurasi setelan default_location di tingkat organisasi, masukkan
perintah bq query
dengan flag --use_legacy_sql yang ditetapkan ke false, dan berikan pernyataan DDL
berikut sebagai parameter kueri:
ALTER ORGANIZATION SET OPTIONS ( `default_location` = 'LOCATION' );
Ganti LOCATION dengan lokasi region atau multi-region BigQuery. Nilai ini adalah lokasi yang digunakan BigQuery untuk menjalankan tugas saat lokasi tugas tidak dapat disimpulkan dari permintaan—misalnya, saat kueri tidak merujuk ke set data atau koneksi apa pun.
Atau, untuk menghapus setelan default_location di tingkat organisasi, masukkan perintah bq query dengan flag --use_legacy_sql yang ditetapkan ke false, dan berikan pernyataan DDL berikut sebagai parameter kueri:
ALTER ORGANIZATION SET OPTIONS ( `default_location` = NULL );
API
Panggil metode jobs.query dan berikan pernyataan DDL di properti query isi permintaan.
Mengonfigurasi setelan project global
Anda dapat mengonfigurasi setelan global di level project menggunakan
pernyataan DDL ALTER PROJECT SET OPTIONS.
Lokasi default (default_location) adalah satu-satunya setelan global yang dapat Anda konfigurasi di level project. Semua setelan level project lainnya adalah setelan regional.
Pernyataan DDL ALTER PROJECT SET OPTIONS secara opsional menerima variabel PROJECT_ID. Jika Anda tidak menentukan
PROJECT_ID, pernyataan akan ditetapkan secara default ke project
tempat Anda menjalankan pernyataan DDL ALTER PROJECT.
Konfigurasi tingkat project akan mengganti konfigurasi tingkat organisasi. Selanjutnya, konfigurasi tingkat sesi dapat mengganti konfigurasi level project, dan konfigurasi tingkat tugas dapat mengganti konfigurasi tingkat sesi.
Untuk mengonfigurasi setelan default_location di level project, ikuti langkah-langkah berikut:
Konsol
Di konsol Cloud de Confiance , buka halaman BigQuery.
Untuk membuka editor kueri, klik search_insights Untitled query.
Untuk mengonfigurasi setelan
default_location, masukkan pernyataan DDL berikut ke dalam editor kueri:ALTER PROJECT PROJECT_ID SET OPTIONS ( `default_location` = 'LOCATION' );
Ganti kode berikut:
PROJECT_ID: project ID.LOCATION: region atau lokasi multi-region BigQuery. Nilai ini adalah lokasi yang digunakan BigQuery untuk menjalankan tugas saat lokasi tugas tidak dapat disimpulkan dari permintaan—misalnya, saat kueri tidak mereferensikan set data atau koneksi apa pun.
Atau, untuk menghapus setelan
default_locationdi level project, masukkan pernyataan DDL berikut ke editor kueri:ALTER PROJECT PROJECT_ID SET OPTIONS ( `default_location` = NULL );
Jika Anda menghapus setelan
default_locationdi level project, BigQuery akan menggunakan setelan default level organisasi, jika ada, atau setelan default sistem.Klik Run.
bq
Untuk mengonfigurasi setelan default_location di level project, masukkan
perintah bq query
dengan flag --use_legacy_sql ditetapkan ke false, dan berikan pernyataan DDL berikut
sebagai parameter kueri:
ALTER PROJECT PROJECT_ID SET OPTIONS ( `default_location` = 'LOCATION' );
Ganti kode berikut:
PROJECT_ID: project ID.LOCATION: region atau lokasi multi-region BigQuery. Nilai ini adalah lokasi yang digunakan BigQuery untuk menjalankan tugas saat lokasi tugas tidak dapat disimpulkan dari permintaan—misalnya, saat kueri tidak mereferensikan set data atau koneksi apa pun.
Atau, untuk menghapus setelan default_location di level project,
masukkan perintah bq query
dengan flag --use_legacy_sql yang ditetapkan ke false, dan berikan pernyataan DDL berikut
sebagai parameter kueri:
ALTER PROJECT PROJECT_ID SET OPTIONS ( `default_location` = NULL );
Jika Anda menghapus setelan default_location di level project, BigQuery akan menggunakan setelan default level organisasi, jika ada, atau setelan default sistem.
API
Panggil metode jobs.query dan berikan pernyataan DDL di properti query isi permintaan.
Menentukan setelan wilayah
Setelan regional berlaku untuk lokasi tertentu dan memerlukan awalan region-REGION.. Anda dapat mengonfigurasi setelan regional di tingkat organisasi atau project.
Kontrol pemesanan dan penagihan
Anda dapat mengonfigurasi setelan tingkat project regional untuk mengontrol cara kueri menggunakan pemesanan atau penagihan on-demand. Setelan ini membantu memastikan prediktabilitas biaya dengan mengizinkan penggunaan pemesanan yang fleksibel atau mewajibkan kueri menggunakan slot pemesanan.
Kontrol pemesanan dan penagihan yang umum mencakup reservation_override_mode dan
disable_on_demand_billing. Untuk mengonfigurasi setelan ini, lihat
Mengonfigurasi setelan project regional. Untuk mengetahui
daftar lengkap opsi project, lihat
daftar opsi ALTER PROJECT SET OPTIONS.
Mengonfigurasi setelan organisasi regional
Anda dapat mengonfigurasi setelan regional di tingkat organisasi menggunakan
pernyataan DDL ALTER ORGANIZATION SET OPTIONS. Anda harus
menentukan region tempat setiap setelan organisasi diterapkan. Anda hanya dapat menggunakan satu region dalam pernyataan.
Contoh di bagian ini menentukan setelan organisasi regional default berikut:
- Zona waktu:
America/Chicago - Kunci Cloud KMS: kunci yang ditentukan pengguna
- Waktu tunggu kueri: 30 menit (1.800.000 milidetik)
- Waktu tunggu antrean kueri interaktif: 10 menit (600.000 milidetik)
- Waktu tunggu antrean kueri batch: 20 menit (1.200.000 milidetik)
- Penyimpanan tabel dan tampilan
INFORMATION_SCHEMAindeks penelusuran (enable_info_schema_storage): diaktifkan
Untuk mengetahui informasi selengkapnya tentang semua setelan organisasi regional, lihat
organization_set_options_list.
Untuk mengonfigurasi setelan organisasi regional, ikuti langkah-langkah berikut:
Konsol
Di konsol Cloud de Confiance , buka halaman BigQuery.
Untuk membuka editor kueri, klik search_insights Untitled query.
Untuk mengonfigurasi setelan organisasi regional, masukkan pernyataan DDL berikut ke dalam editor kueri:
ALTER ORGANIZATION SET OPTIONS ( `region-REGION.default_time_zone`= 'America/Chicago', -- Ensure all service accounts under the organization have permission to KMS_KEY `region-REGION.default_kms_key_name` = KMS_KEY, `region-REGION.default_query_job_timeout_ms` = 1800000, `region-REGION.default_interactive_query_queue_timeout_ms` = 600000, `region-REGION.default_batch_query_queue_timeout_ms` = 1200000, `region-REGION.enable_info_schema_storage` = true);
Ganti kode berikut:
REGION: region BigQuery yang terkait dengan project atau organisasi Anda—misalnya,usataueurope-west6. Nilai untukREGIONharus sama untuk setiap opsi dalam perintah.KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk mengetahui informasi selengkapnya, lihat Kunci Cloud KMS yang dikelola pelanggan.
Atau, untuk menghapus setelan organisasi regional, masukkan pernyataan DDL berikut ke dalam editor kueri:
ALTER ORGANIZATION SET OPTIONS ( `region-REGION.default_time_zone` = NULL, `region-REGION.default_kms_key_name` = NULL, `region-REGION.default_query_job_timeout_ms` = NULL, `region-REGION.default_interactive_query_queue_timeout_ms` = NULL, `region-REGION.default_batch_query_queue_timeout_ms` = NULL, `region-REGION.enable_info_schema_storage` = NULL);
Klik Run.
bq
Untuk mengonfigurasi setelan organisasi regional, masukkan
perintah bq query
dengan flag --use_legacy_sql yang ditetapkan ke false, dan berikan pernyataan DDL berikut
sebagai parameter kueri:
ALTER ORGANIZATION SET OPTIONS ( `region-REGION.default_time_zone`= 'America/Chicago', -- Ensure all service accounts under the organization have permission to KMS_KEY `region-REGION.default_kms_key_name` = KMS_KEY, `region-REGION.default_query_job_timeout_ms` = 1800000, `region-REGION.default_interactive_query_queue_timeout_ms` = 600000, `region-REGION.default_batch_query_queue_timeout_ms` = 1200000, `region-REGION.enable_info_schema_storage` = true);
Ganti kode berikut:
REGION: region BigQuery yang terkait dengan project atau organisasi Anda—misalnya,usataueurope-west6. Nilai untukREGIONharus sama untuk setiap opsi dalam perintah.KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk mengetahui informasi selengkapnya, lihat Kunci Cloud KMS yang dikelola pelanggan.
Atau, untuk menghapus setelan organisasi regional, masukkan
perintah bq query
dengan flag --use_legacy_sql yang ditetapkan ke false, dan berikan pernyataan DDL berikut
sebagai parameter kueri:
ALTER ORGANIZATION SET OPTIONS ( `region-REGION.default_time_zone` = NULL, `region-REGION.default_kms_key_name` = NULL, `region-REGION.default_query_job_timeout_ms` = NULL, `region-REGION.default_interactive_query_queue_timeout_ms` = NULL, `region-REGION.default_batch_query_queue_timeout_ms` = NULL, `region-REGION.enable_info_schema_storage` = NULL);
API
Panggil metode jobs.query dan berikan pernyataan DDL di properti query isi permintaan.
Mengonfigurasi setelan project regional
Anda dapat mengonfigurasi setelan regional di level project menggunakan
pernyataan DDL ALTER PROJECT SET OPTIONS.
Anda harus menentukan region tempat setiap setelan project diterapkan. Anda hanya dapat menggunakan satu region dalam pernyataan.
Konfigurasi tingkat project akan mengganti konfigurasi tingkat organisasi. Selanjutnya, konfigurasi tingkat sesi dapat mengganti konfigurasi level project, dan konfigurasi tingkat tugas dapat mengganti konfigurasi tingkat sesi.
Pernyataan DDL ALTER PROJECT SET OPTIONS secara opsional menerima variabel PROJECT_ID. Jika Anda tidak menentukan PROJECT_ID, pernyataan akan ditetapkan secara default ke project tempat Anda menjalankan pernyataan DDL ALTER PROJECT.
Contoh di bagian ini menentukan setelan project regional default berikut:
- Zona waktu:
America/Los_Angeles - Kunci Cloud KMS: kunci yang ditentukan pengguna
- Waktu tunggu kueri: 1 jam (3.600.000 milidetik)
- Waktu tunggu antrean kueri interaktif: 10 menit (600.000 milidetik)
- Waktu tunggu antrean kueri batch: 20 menit (1.200.000 milidetik)
- Keadilan berbasis pemesanan: diaktifkan
- Kueri global: diaktifkan untuk menjalankan dan mengakses data
- Penyimpanan tabel dan tampilan
INFORMATION_SCHEMAindeks penelusuran (enable_info_schema_storage): diaktifkan
Untuk mengetahui informasi selengkapnya tentang semua setelan project regional, lihat
project_set_options_list.
Untuk mengonfigurasi setelan project regional, ikuti langkah-langkah berikut:
Konsol
Di konsol Cloud de Confiance , buka halaman BigQuery.
Untuk membuka editor kueri, klik search_insights Untitled query.
Untuk mengonfigurasi setelan project regional, masukkan pernyataan DDL berikut ke dalam editor kueri:
ALTER PROJECT PROJECT_ID SET OPTIONS ( `region-REGION.default_time_zone` = 'America/Los_Angeles', -- Ensure all service accounts under the project have permission to KMS_KEY `region-REGION.default_kms_key_name` = KMS_KEY, `region-REGION.default_query_job_timeout_ms` = 3600000, `region-REGION.default_interactive_query_queue_timeout_ms` = 600000, `region-REGION.default_batch_query_queue_timeout_ms` = 1200000, `region-REGION.enable_reservation_based_fairness` = true, `region-REGION.enable_global_queries_execution` = true, `region-REGION.enable_global_queries_data_access` = true, `region-REGION.enable_info_schema_storage` = true);
Ganti kode berikut:
PROJECT_ID: project ID.REGION: region BigQuery yang terkait dengan project atau organisasi Anda—misalnya,usataueurope-west6. Nilai untukREGIONharus sama untuk setiap opsi dalam perintah.KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk informasi lebih lanjut, lihat Kunci Cloud KMS yang dikelola pelanggan.
Atau, untuk menghapus setelan project regional, masukkan pernyataan DDL berikut ke dalam editor kueri:
ALTER PROJECT PROJECT_ID SET OPTIONS ( `region-REGION.default_time_zone` = NULL, `region-REGION.default_kms_key_name` = NULL, `region-REGION.default_query_job_timeout_ms` = NULL, `region-REGION.default_interactive_query_queue_timeout_ms` = NULL, `region-REGION.default_batch_query_queue_timeout_ms` = NULL, `region-REGION.enable_reservation_based_fairness` = false, `region-REGION.enable_global_queries_execution` = NULL, `region-REGION.enable_global_queries_data_access` = NULL, `region-REGION.enable_info_schema_storage` = NULL);
Klik Run.
bq
Untuk mengonfigurasi setelan project regional, masukkan
perintah bq query
dengan flag --use_legacy_sql yang ditetapkan ke false, dan berikan pernyataan DDL
berikut sebagai parameter kueri:
ALTER PROJECT PROJECT_ID SET OPTIONS ( `region-REGION.default_time_zone` = 'America/Los_Angeles', -- Ensure all service accounts under the project have permission to KMS_KEY `region-REGION.default_kms_key_name` = KMS_KEY, `region-REGION.default_query_job_timeout_ms` = 3600000, `region-REGION.default_interactive_query_queue_timeout_ms` = 600000, `region-REGION.default_batch_query_queue_timeout_ms` = 1200000, `region-REGION.enable_reservation_based_fairness` = true, `region-REGION.enable_global_queries_execution` = true, `region-REGION.enable_global_queries_data_access` = true, `region-REGION.enable_info_schema_storage` = true);
Ganti kode berikut:
PROJECT_ID: project ID.REGION: region BigQuery yang terkait dengan project atau organisasi Anda—misalnya,usataueurope-west6. Nilai untukREGIONharus sama untuk setiap opsi dalam perintah.KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk mengetahui informasi selengkapnya, lihat Kunci Cloud KMS yang dikelola pelanggan.
Atau, untuk menghapus setelan project regional, masukkan
perintah bq query
dengan flag --use_legacy_sql yang ditetapkan ke false, dan berikan pernyataan DDL berikut
sebagai parameter kueri:
ALTER PROJECT PROJECT_ID SET OPTIONS ( `region-REGION.default_time_zone` = NULL, `region-REGION.default_kms_key_name` = NULL, `region-REGION.default_query_job_timeout_ms` = NULL, `region-REGION.default_interactive_query_queue_timeout_ms` = NULL, `region-REGION.default_batch_query_queue_timeout_ms` = NULL, `region-REGION.enable_reservation_based_fairness` = false, `region-REGION.enable_global_queries_execution` = NULL, `region-REGION.enable_global_queries_data_access` = NULL, `region-REGION.enable_info_schema_storage` = NULL);
API
Panggil metode jobs.query dan berikan pernyataan DDL di properti query isi permintaan.
Mengambil setelan konfigurasi
Anda dapat melihat setelan konfigurasi untuk organisasi atau project
menggunakan tampilan INFORMATION_SCHEMA
berikut:
INFORMATION_SCHEMA.PROJECT_OPTIONS: konfigurasi yang diterapkan ke project.INFORMATION_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 organisasi.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS: konfigurasi yang diterapkan ke organisasi.
Konfigurasi baru mungkin memerlukan waktu beberapa menit untuk diterapkan dan muncul di
tampilan INFORMATION_SCHEMA.
Contoh kueri untuk mengambil setelan
Gunakan contoh kueri berikut untuk mengambil setelan project dan organisasi Anda dari tabel virtual INFORMATION_SCHEMA.
Melihat setelan global
Untuk melihat semua setelan organisasi global, jalankan kueri berikut:
SELECT * FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;
Untuk hanya melihat setelan organisasi default_location, jalankan kueri berikut:
SELECT option_value FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS WHERE option_name = 'default_location'
Untuk melihat semua konfigurasi global yang efektif untuk project default Anda, jalankan kueri berikut:
SELECT * FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;
Untuk melihat setelan default_location yang efektif saja untuk project default Anda,
jalankan kueri berikut:
SELECT option_value FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS WHERE option_name = 'default_location'
Untuk melihat semua konfigurasi global untuk project default Anda, jalankan kueri berikut:
SELECT * FROM INFORMATION_SCHEMA.PROJECT_OPTIONS;
Untuk melihat setelan default_location saja untuk project default Anda, jalankan kueri berikut:
SELECT option_value FROM INFORMATION_SCHEMA.PROJECT_OPTIONS WHERE option_name = 'default_location'
Melihat setelan wilayah
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;
Setelan konfigurasi default
Bagian berikut menjelaskan setelan konfigurasi yang dapat Anda tentukan.
Setelan eksekusi kueri dan tugas
Gunakan setelan berikut untuk mengontrol cara kueri dieksekusi, diatur waktunya, dan diantrekan.
default_batch_query_queue_timeout_ms: Jumlah waktu default, dalam milidetik, saat kueri batch menunggu dalam antrean kueri. 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.default_interactive_query_queue_timeout_ms: Jumlah waktu default dalam milidetik saat kueri interaktif menunggu dalam antrean kueri. Jika tidak disetel, default-nya adalah 6 jam. Nilai minimumnya adalah 1 milidetik, dan nilai maksimumnya adalah 48 jam. Untuk menonaktifkan antrean kueri interaktif, tetapkan nilai ke-1.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 5 menit hingga 48 jam. Waktu tunggu ini hanya berlaku untuk tugas kueri individual dan tugas turunan skrip. Untuk menetapkan waktu tunggu untuk tugas skrip, gunakan metode APIjobs.insertdan tetapkan kolomjobTimeoutMs.default_location: Setelan konfigurasidefault_locationdigunakan untuk menjalankan tugas saat lokasi tidak ditetapkan atau tidak dapat ditentukan. Jikadefault_locationtidak ditetapkan, tugas akan berjalan di multi-regionUS. Untuk mengetahui informasi selengkapnya, lihat Menentukan lokasi.enable_reservation_based_fairness: Opsi yang menentukan cara slot tidak aktif dibagikan. Untuk project administrasi yang dibuat setelah 10 Oktober 2026, opsi ini diaktifkan (TRUE) secara default. Untuk project yang dibuat sebelum 10 Oktober 2026, nilai defaultnya adalahFALSE, yang berarti slot tidak aktif didistribusikan secara merata di semua project kueri. Jika Anda mengaktifkan opsi ini, slot tidak aktif akan dibagikan secara merata di semua pemesanan terlebih dahulu, lalu di seluruh project dalam setiap pemesanan. Untuk mengetahui informasi selengkapnya, lihat keadilan berbasis pemesanan. Opsi ini hanya didukung di level project. Anda tidak dapat menentukannya di tingkat organisasi atau tugas.default_time_zone: Zona waktu default untuk digunakan dalam fungsi GoogleSQL 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_query_optimizer_options: Pengoptimalan kueri berbasis histori. Opsi ini dapat berupa salah satu dari berikut:'adaptive=on': Menggunakan pengoptimalan kueri berbasis histori.'adaptive=off': Jangan gunakan pengoptimalan kueri berbasis histori.NULL(default): Menggunakan setelan pengoptimalan kueri berbasis histori default, yang setara dengan'adaptive=on'.
default_sql_dialect_option: Dialek kueri SQL default untuk menjalankan tugas kueri menggunakan alat command line bq atau BigQuery API. Mengubah setelan ini tidak memengaruhi dialek default di konsol. Opsi ini dapat berupa salah satu dari berikut:'default_legacy_sql'(default): Menggunakan legacy SQL jika dialek kueri tidak ditentukan di tingkat tugas.'default_google_sql': Gunakan GoogleSQL jika dialek kueri tidak ditentukan di tingkat tugas.'only_google_sql': Gunakan GoogleSQL jika dialek kueri tidak ditentukan di tingkat tugas. Menolak tugas dengan dialek kueri yang ditetapkan ke legacy SQL.NULL: Menggunakan setelan dialek kueri default, yang setara dengan'default_legacy_sql'.
enable_global_queries_execution: Opsi yang menentukan apakah kueri global dapat dijalankan. Nilai defaultnya adalahFALSE, yang berarti kueri global tidak diaktifkan.enable_global_queries_data_access: Opsi yang menentukan apakah kueri global dapat mengakses data yang disimpan di region. Nilai defaultnya adalahFALSE, yang berarti kueri global tidak dapat menyalin data dari region ini, terlepas dari project tempat kueri tersebut dijalankan.reusable_column_aliases_mode: Opsi yang menentukan apakah alias kolom yang bisa digunakan kembali diaktifkan untuk kueri. Nilai defaultnya adalahoff, yang berarti alias kolom yang bisa digunakan kembali tidak diaktifkan. Untuk mengetahui informasi selengkapnya, lihat Alias kolom yang dapat digunakan kembali.
Setelan pengelolaan data
Gunakan setelan berikut untuk menentukan aturan pembuatan, keamanan, dan siklus proses data.
default_column_name_character_map: Cakupan default dan penanganan karakter dalam nama kolom. Jika tidak ditetapkan, tugas pemuatan yang menggunakan karakter yang tidak didukung dalam nama kolom akan gagal dengan pesan error. Beberapa tabel lama mungkin ditetapkan untuk mengganti karakter yang tidak didukung dalam nama kolom. Untuk informasi selengkapnya, lihatload_option_list.default_data_policy_projects: Daftar default project yang kebijakan datanya dievaluasi saat mengakses kolom yang dilindungi oleh tag tata kelola data. Secara default, hanya kebijakan data project tabel yang dievaluasi. Saat Anda mengonfigurasi project kebijakan data default di level organisasi, BigQuery akan mengevaluasi kebijakan data project tabel dan kebijakan data project kebijakan data default. Jika ada kebijakan yang bertentangan di kedua project, kebijakan data dalam project tabel akan diprioritaskan. Anda hanya dapat mengonfigurasi setelan ini di tingkat organisasi menggunakan pernyataanALTER ORGANIZATION SET OPTIONS—misalnya,region-us.default_data_policy_projects = ["my_default_project"]. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi project kebijakan data default.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_max_time_travel_hours: Periode perjalanan waktu default dalam jam untuk set data baru. Durasi ini harus berada dalam rentang 48 hingga 168, inklusif, dan harus habis dibagi 24. Mengubah jam perjalanan waktu maksimum default tidak memengaruhi set data yang ada. Untuk mengetahui informasi selengkapnya, lihat Perjalanan Waktu dan retensi data.enable_info_schema_storage: Opsi yang memberikan akses ke tampilanINFORMATION_SCHEMA.TABLE_STORAGEdanSEARCH_INDEXESserta variannya. Secara default, opsi ini tidak diaktifkan. Jika Anda membuat kueri tampilan ini untuk pertama kalinya tanpa menetapkan opsi ini keTRUE, kueri akan gagal dan memberikan petunjuk untuk mengaktifkan opsi tersebut. Setelah Anda mengaktifkan opsi ini, kueri akan langsung berhasil dan menampilkan data yang dihasilkan sejak saat itu. Pengisian ulang data historis secara lengkap dapat memerlukan waktu sekitar satu hari agar tersedia dalam tampilan. Jika Anda menggunakan tampilan ini sebelum setelan ini diperkenalkan, opsi ini sudah diaktifkan.
Setelan biaya dan resource
Gunakan setelan berikut untuk menentukan cara resource ditagih dan dihubungkan.
default_storage_billing_model: Model penagihan penyimpanan default untuk set data baru. Tetapkan nilai kePHYSICALuntuk menggunakan byte fisik saat menghitung biaya penyimpanan atau keLOGICALuntuk menggunakan byte logis. Mengubah model penagihan penyimpanan default tidak akan memengaruhi set data yang ada. Untuk mengetahui informasi selengkapnya, lihat Model penagihan penyimpanan.default_cloud_resource_connection_id: Koneksi default yang akan digunakan saat Anda membuat tabel dan model. Tentukan hanya ID atau nama koneksi, dan kecualikan awalan project ID dan region yang dilampirkan. Saat Anda menggunakan koneksi default, BigQuery mungkin memperbarui izin yang diberikan ke akun layanan koneksi, bergantung pada jenis tabel atau model yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Ringkasan koneksi default.reservation_override_mode: Menentukan cara penggantian pemesanan kueri di region (misalnya,'ALLOW_ANY_OVERRIDE'). Untuk mengetahui detailnya, lihat daftar opsiALTER PROJECT SET OPTIONS.disable_on_demand_billing: Menentukan apakah penagihan on-demand dinonaktifkan untuk kueri di region tersebut. Jikatrue, semua kueri harus menggunakan pemesanan yang ditetapkan atau kueri tersebut akan gagal. Untuk mengetahui detailnya, lihat daftar opsiALTER PROJECT SET OPTIONS.preflight_fluid_autoscaling_reservations: Daftar pemesanan yang diikutsertakan dalam penskalaan fleksibel untuk penagihan per detik tanpa durasi minimum. Untuk mengetahui informasi selengkapnya, lihat Memahami pemesanan.
Harga
Tidak ada biaya tambahan untuk menggunakan layanan konfigurasi BigQuery. Untuk informasi lebih lanjut, lihat Harga BigQuery.