Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

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:

Tentukan setelan konfigurasi: Admin BigQuery (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.update di organisasi atau project Anda
Mengambil setelan konfigurasi: bigquery.config.get pada 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 tingkat organisasi atau project. Lokasi default (default_location) adalah satu-satunya setelan global yang dapat Anda konfigurasi.

Jika Anda tidak menentukan lokasi secara eksplisit, lokasi 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 di asia-northeast1.
Wilayah yang ditentukan untuk koneksi yang dirujuk 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 project global tidak didukung di lokasi BigQuery Omni. Anda tidak dapat menetapkan default_location ke 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 OPTIONS atau ALTER PROJECT SET OPTIONS yang 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 Google Cloud , buka halaman BigQuery.

Buka 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 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 mereferensikan set data atau koneksi apa pun.
Atau, untuk menghapus setelan default_location di tingkat organisasi, masukkan pernyataan DDL berikut ke dalam 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 tanda --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 mereferensikan set data atau koneksi apa pun.

Atau, untuk menghapus setelan default_location di tingkat organisasi, masukkan bq query perintah dengan tanda --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 Google Cloud , buka halaman BigQuery.

Buka 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_location di level project, masukkan pernyataan DDL berikut ke editor kueri:
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );
```
Jika Anda menghapus setelan default_location di tingkat project, BigQuery akan menggunakan setelan default tingkat organisasi, jika ada, atau setelan default sistem.
Klik Run.

bq

Untuk mengonfigurasi setelan default_location di tingkat project, masukkan perintah bq query dengan tanda --use_legacy_sql yang 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 tingkat project, masukkan perintah bq query dengan tanda --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 dalam 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 level 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 umum untuk reservasi dan penagihan mencakup reservation_override_mode (Pratinjau) dan disable_on_demand_billing (Pratinjau). 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_SCHEMA indeks 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 Google Cloud , buka halaman BigQuery.

Buka 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, us atau europe-west6. Nilai untuk REGION harus 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, us atau europe-west6. Nilai untuk REGION harus sama untuk setiap opsi dalam perintah.
KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk 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 tingkat 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.

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_SCHEMA indeks 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 Google Cloud , buka halaman BigQuery.

Buka 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, us atau europe-west6. Nilai untuk REGION harus 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 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, us atau europe-west6. Nilai untuk REGION harus sama untuk setiap opsi dalam perintah.
KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk 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 dalam 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 dapat 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 tampilan 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 dijalankan, 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, defaultnya 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 dan 48 jam. Waktu tunggu ini hanya berlaku untuk tugas kueri individual dan tugas turunan skrip. Untuk menetapkan waktu tunggu untuk tugas skrip, gunakan metode API jobs.insert dan tetapkan kolom jobTimeoutMs.

Catatan: Setelan default_query_job_timeout_ms juga berlaku untuk tugas kueri berkelanjutan. Untuk mengganti setelan tingkat project ini untuk kueri berkelanjutan tertentu, tetapkan waktu tunggu tugas ke kueri berkelanjutan yang dimaksud. Kueri berkelanjutan masih mematuhi runtime maksimum.
default_location: Setelan konfigurasi default_location digunakan untuk menjalankan tugas saat lokasi tidak ditetapkan atau tidak dapat ditentukan. Jika default_location tidak ditetapkan, tugas akan berjalan di multi-region US. Untuk mengetahui informasi selengkapnya, lihat Menentukan lokasi.
enable_reservation_based_fairness: Opsi yang menentukan cara slot tidak ada aktivitas 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 adalah FALSE, yang berarti slot tidak ada aktivitas didistribusikan secara merata ke semua project kueri. Jika Anda mengaktifkan opsi ini, slot tidak ada aktivitas 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 tingkat 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.

Catatan: Jika Anda ingin menetapkan zona waktu default, pastikan kueri yang sudah ada yang menggunakan literal DATETIME tidak terpengaruh. Kueri yang terpengaruh mencakup kueri yang menggunakan kata kunci DATETIME eksplisit, literal string yang dikonversi secara implisit dan diteruskan ke fungsi waktu seperti DATETIME_DIFF('2022-10-01', ...), dan fungsi PARSE_DATETIME(). Oleh karena itu, lebih aman untuk menetapkan setelan default_time_zone hanya pada project baru.
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: Gunakan setelan dialek kueri default, yang setara dengan 'default_legacy_sql'.
enable_global_queries_execution: Opsi yang menentukan apakah kueri global dapat dijalankan. Nilai defaultnya adalah FALSE, 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 adalah FALSE, 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 dapat digunakan kembali diaktifkan untuk kueri. Nilai defaultnya adalah off, yang berarti alias kolom yang dapat 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 disetel untuk mengganti karakter yang tidak didukung dalam nama kolom. Untuk informasi selengkapnya, lihat load_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 tingkat organisasi, BigQuery akan mengevaluasi kebijakan data project tabel dan 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 dengan menggunakan pernyataan ALTER 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.

Catatan: untuk menetapkan kunci Cloud KMS default, Anda harus memberikan peran Encrypter/Decrypter ke semua akun layanan BigQuery yang digunakan dalam project atau organisasi. Jika akun layanan dalam project atau organisasi tidak memiliki izin yang sesuai, semua kueri yang dijalankan oleh akun layanan akan gagal. Untuk mengetahui informasi tentang cara menetapkan peran Encrypter/Decrypter, lihat Menetapkan peran Encrypter/Decrypter. Jika Anda menetapkan kunci Cloud KMS default tanpa terlebih dahulu menetapkan peran yang sesuai, Anda dapat menghapus kunci default dengan menetapkan nilainya ke NULL. Untuk melihat contoh, lihat Mengonfigurasi setelan organisasi regional dan Mengonfigurasi setelan project regional.
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 dapat dibagi dengan 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 tampilan INFORMATION_SCHEMA.TABLE_STORAGE dan SEARCH_INDEXES serta variannya. Opsi ini tidak diaktifkan secara default. Jika Anda membuat kueri tampilan ini untuk pertama kalinya tanpa menetapkan opsi ini ke TRUE, kueri akan gagal dan memberikan petunjuk untuk mengaktifkan opsi tersebut. Setelah Anda mengaktifkan opsi ini, kueri akan berhasil dengan segera dan menampilkan data yang dihasilkan mulai 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 ke PHYSICAL untuk menggunakan byte fisik saat menghitung biaya penyimpanan atau ke LOGICAL untuk menggunakan byte logis. Mengubah model penagihan penyimpanan default tidak 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 project ID terlampir dan awalan region. 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 (Pratinjau): Menentukan cara penggantian reservasi kueri di region (misalnya, 'ALLOW_ANY_OVERRIDE'). Untuk mengetahui detailnya, lihat daftar opsi ALTER PROJECT SET OPTIONS.
disable_on_demand_billing (Pratinjau): Menentukan apakah penagihan on-demand dinonaktifkan untuk kueri di region. Jika true, semua kueri harus menggunakan pemesanan yang ditetapkan atau akan gagal. Untuk mengetahui detailnya, lihat daftar opsi ALTER 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.