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

Mengelola setelan konfigurasi

Administrator dan pemilik project BigQuery dapat mengelola setelan konfigurasi di tingkat organisasi dan project. Anda dapat menetapkan konfigurasi untuk menerapkan keamanan, mengontrol biaya, dan mengoptimalkan performa kueri di seluruh infrastruktur data Anda. Dengan menetapkan nilai default, Anda dapat memastikan kepatuhan dan efisiensi operasional yang konsisten, sehingga memudahkan pengelolaan lingkungan BigQuery Anda.

Bagian berikut menjelaskan cara menentukan setelan konfigurasi default. Setelan default dikonfigurasi di tingkat organisasi atau project, tetapi dapat diganti di tingkat sesi atau tugas.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menentukan setelan konfigurasi, minta administrator untuk memberi Anda peran IAM BigQuery Admin (roles/bigquery.admin). Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin bigquery.config.update, yang diperlukan untuk menentukan setelan konfigurasi.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk informasi selengkapnya tentang peran dan izin IAM dalam BigQuery, baca Peran dan izin bawaan.

Menentukan setelan global

Anda dapat menentukan setelan global di tingkat organisasi atau project.

Batasan

Setelan konfigurasi global tunduk pada batasan berikut:

Setelan project dan organisasi global tidak tersedia di lokasi BigQuery Omni.
Saat Anda mengubah setelan global default_location, perlu waktu hingga 10 menit untuk menerapkan perubahan. Sebelum setelan diterapkan, kueri yang memenuhi syarat mungkin dirutekan ke lokasi default sebelumnya.

Mengonfigurasi setelan organisasi global

Jika Anda tidak menentukan lokasi secara eksplisit, lokasi ditentukan dengan salah satu cara berikut:

Lokasi set data yang direferensikan 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.

Anda dapat mengonfigurasi setelan global di tingkat organisasi menggunakan pernyataan DDL ALTER ORGANIZATION SET OPTIONS. Lokasi default adalah satu-satunya setelan organisasi global. Lokasi default digunakan untuk menjalankan tugas saat lokasi tidak dapat disimpulkan dari permintaan.

Saat mengonfigurasi lokasi default, Anda tidak menentukan region tempat setelan tersebut berlaku. Anda tidak dapat menggabungkan setelan global dan regional dalam pernyataan DDL yang sama.

Untuk mengonfigurasi default_location di tingkat organisasi, ikuti langkah-langkah berikut:

Konsol

Buka halaman BigQuery di konsol Google Cloud .

Buka BigQuery
Klik editor kueri. Tab ini diberi label search_insights Untitled query.
Untuk mengonfigurasi default_location, masukkan pernyataan DDL berikut ke dalam Editor kueri:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
Ganti LOCATION dengan lokasi regional atau multi-regional. Nilai ini adalah lokasi yang digunakan untuk menjalankan tugas jika tidak dapat disimpulkan dari permintaan. Misalnya, lokasi default digunakan jika lokasi set data dalam kueri tidak dapat ditentukan.
Atau, untuk menghapus setelan global tingkat organisasi default_location, masukkan pernyataan DDL berikut ke Editor kueri:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );
```
Klik Run.

bq

Untuk mengonfigurasi default_location di tingkat organisasi, masukkan perintah bq query dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false.
```
ALTER ORGANIZATION
SET OPTIONS (
`default_location` = 'LOCATION'
);
```
Ganti LOCATION dengan lokasi region atau multi-region. Nilai ini adalah lokasi yang digunakan untuk menjalankan tugas jika tidak dapat disimpulkan dari permintaan. Misalnya, lokasi default digunakan jika lokasi set data dalam kueri tidak dapat ditentukan.
Untuk menghapus default_location di tingkat organisasi, masukkan perintah bq query dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false.
```
ALTER ORGANIZATION
SET OPTIONS (
`default_location` = NULL
);
```

API

Panggil metode jobs.query dan berikan pernyataan DDL dalam properti query isi permintaan.

Mengonfigurasi setelan project global

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.

Anda dapat mengonfigurasi setelan global di level project menggunakan 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 Anda menjalankan pernyataan DDL ALTER PROJECT.

Lokasi default adalah satu-satunya setelan project global. Saat mengonfigurasi lokasi default, Anda tidak menentukan region tempat setelan diterapkan. Anda tidak dapat menggabungkan setelan global dan regional dalam pernyataan DDL yang sama.

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.

Untuk mengonfigurasi default_location di level project, ikuti langkah-langkah berikut:

Konsol

Buka halaman BigQuery di konsol Google Cloud .

Buka BigQuery
Klik editor kueri. Tab ini diberi label search_insights Untitled query.
Untuk mengonfigurasi 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: lokasi region atau multi-region. Nilai ini adalah lokasi yang digunakan untuk menjalankan tugas saat tidak dapat disimpulkan dari permintaan. Misalnya, lokasi default digunakan jika lokasi set data dalam kueri tidak dapat ditentukan.
Atau, untuk menghapus setelan default_location, masukkan pernyataan DDL berikut ke dalam Query editor. Jika Anda menghapus default_location di tingkat project, setelan default tingkat organisasi akan digunakan, jika ada. Jika tidak, setelan default sistem akan digunakan.
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );
```
Klik Run.

bq

Untuk mengonfigurasi default_location di level project, masukkan perintah bq query dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false.
```
ALTER PROJECT PROJECT_ID
SET OPTIONS (
`default_location` = 'LOCATION'
);
```
Ganti kode berikut:
- PROJECT_ID: project ID.
- LOCATION: lokasi region atau multi-region. Nilai ini adalah lokasi yang digunakan untuk menjalankan tugas saat tidak dapat disimpulkan dari permintaan. Misalnya, lokasi default digunakan jika lokasi set data dalam kueri tidak dapat ditentukan.
Atau, untuk menghapus default_location di level project, masukkan perintah bq query dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false. Jika Anda menghapus default_location di level project, setelan default level organisasi akan digunakan, jika ada. Jika tidak, setelan default sistem akan digunakan.
```
ALTER PROJECT PROJECT_ID
SET OPTIONS (
`default_location` = NULL
);
```

API

Panggil metode jobs.query dan berikan pernyataan DDL di properti query isi permintaan.

Menentukan setelan wilayah

Anda dapat mengonfigurasi setelan regional di level organisasi atau project.

Mengelola kontrol pemesanan dan penagihan

Anda dapat mengontrol cara kueri menggunakan penagihan on-demand atau pemesanan. Setelan ini membantu memastikan prediktabilitas biaya dengan mengizinkan penggunaan pemesanan yang fleksibel atau mewajibkan kueri menggunakan slot pemesanan.

Kontrol pemesanan dan penagihan umum mencakup setelan seperti reservation_override_mode (Pratinjau) dan disable_on_demand_billing (Pratinjau). Untuk mengetahui daftar lengkap setelan dan opsi, 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.

Untuk mengonfigurasi setelan organisasi regional, ikuti langkah-langkah berikut. Contoh berikut menentukan beberapa konfigurasi regional default, termasuk 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)
INFORMATION_SCHEMA: diaktifkan

Untuk melihat semua setelan organisasi regional, buka organization_set_options_list.

Konsol

Buka halaman BigQuery di konsol Google Cloud .

Buka BigQuery
Klik editor kueri. Tab ini diberi label search_insights Untitled query.

Untuk mengonfigurasi setelan organisasi regional, masukkan pernyataan DDL berikut ke dalam Query editor:

  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 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 Query editor:

  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 dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false.

  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);

Ganti kode berikut:

REGION: region 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 perintah bq query dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false:

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.default_storage_billing_model`= NULL,
  `region-REGION.default_max_time_travel_hours` = NULL,
  `region-REGION.default_cloud_resource_connection_id` = NULL,
  `region-REGION.default_sql_dialect_option` = NULL,
  `region-REGION.enable_reservation_based_fairness` = NULL,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL);

API

Panggil metode jobs.query dan berikan pernyataan DDL dalam properti query isi permintaan.

Mengonfigurasi setelan project regional

Anda dapat mengonfigurasi setelan regional di level project menggunakan pernyataan DDL ALTER PROJECT SET OPTIONS. Saat menentukan konfigurasi, Anda harus menentukan region tempat konfigurasi tersebut diterapkan. Anda hanya dapat menggunakan satu region dalam setiap pernyataan.

Pernyataan DDL ALTER PROJECT SET OPTIONS secara opsional menerima variabel PROJECT_ID. Jika variabel PROJECT_ID tidak ditentukan, variabel tersebut akan ditetapkan secara default ke project saat ini tempat Anda menjalankan pernyataan DDL ALTER PROJECT.

Contoh berikut menentukan beberapa setelan tingkat project regional, termasuk yang berikut:

Zona waktu: America/Los_Angeles
Kunci Cloud KMS: contoh kunci
Waktu tunggu kueri: 1 jam (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)
Keadilan berbasis reservasi: diaktifkan
Kueri global: diaktifkan untuk menjalankan dan mengakses data
INFORMATION_SCHEMA: diaktifkan

Untuk melihat semua setelan project regional, buka project_set_options_list.

Konsol

Buka halaman BigQuery di konsol Google Cloud .

Buka BigQuery
Klik editor kueri. Tab ini diberi label 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 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 Query editor:

  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_info_schema_storage` = NULL);

Klik Run.

bq

Untuk mengonfigurasi setelan project regional, masukkan perintah bq query dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false.

ALTER PROJECT PROJECT_ID
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_reservation_based_fairness` = true);

Ganti kode berikut:

PROJECT_ID: project ID.
REGION: region 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 dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false:

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_reservation_based_fairness` = false,
`region-REGION.enable_global_queries_execution` = NULL,
`region-REGION.enable_global_queries_data_access` = 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 tabel virtual 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.

Mungkin perlu waktu beberapa menit agar konfigurasi baru menjadi efektif dan ditampilkan dalam tampilan INFORMATION_SCHEMA.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengambil setelan konfigurasi, minta administrator untuk memberi Anda peran IAM BigQuery Job User (roles/bigquery.jobUser) pada project yang ditentukan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin bigquery.config.get, yang diperlukan untuk mengambil setelan konfigurasi.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk informasi selengkapnya tentang peran dan izin IAM dalam BigQuery, baca Peran dan izin bawaan.

Contoh

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 melihat setelan organisasi lokasi default saja, 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 konfigurasi global efektif lokasi default 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 lokasi default saja untuk project default Anda, jalankan kueri berikut:

SELECT
    option_value
FROM INFORMATION_SCHEMA.PROJECT_OPTIONS
WHERE option_name = 'default_location'

Melihat setelan regional

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

Bagian berikut menjelaskan setelan konfigurasi yang dapat Anda tentukan.

Setelan eksekusi tugas dan kueri

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 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.
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_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 tugas skrip, Anda harus menggunakan metode API jobs.insert dan menetapkan 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 tetap 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.
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 secara default. Untuk project yang dibuat sebelum 10 Oktober 2026 yang menonaktifkan opsi ini (false), slot tidak ada aktivitas didistribusikan secara merata di semua project kueri. Jika diaktifkan (true), slot tidak ada aktivitas akan dibagikan secara merata di semua pemesanan terlebih dahulu, lalu di seluruh project dalam 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. Ini mencakup kueri dengan kata kunci DATETIME eksplisit, literal string yang dikonversi secara implisit dan diteruskan sebagai parameter ke fungsi waktu seperti DATETIME_DIFF('2022-10-01', ...), fungsi PARSE_DATETIME(), dan lainnya. Karena alasan ini, lebih aman untuk hanya menetapkan parameter default_time_zone 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 ini:
- '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.

Setelan pengelolaan data

Gunakan setelan berikut untuk menentukan aturan pembuatan, keamanan, dan siklus proses data.

default_column_name_character_map: Cakupan dan penanganan default karakter dalam nama kolom. Jika tidak disetel, 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 di project tabel akan lebih diutamakan. Setelan ini hanya dapat dikonfigurasi di tingkat organisasi 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. Sebagai contoh, lihat Mengonfigurasi setelan organisasi dan Mengonfigurasi setelan project.
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 mengaktifkannya. Setelah opsi ini diaktifkan, kueri akan langsung berhasil dan menampilkan data yang dihasilkan sejak saat itu dan seterusnya. 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 penagihan dan koneksi resource.

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. Perhatikan bahwa 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 membuat tabel dan model. Hanya tentukan ID atau nama koneksi, dan kecualikan project ID dan awalan region yang dilampirkan. Menggunakan koneksi default dapat menyebabkan izin yang diberikan ke akun layanan koneksi diperbarui, bergantung pada jenis tabel atau model yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Ringkasan koneksi default.
reservation_override_mode (Pratinjau): Menentukan cara reservasi kueri dapat diganti 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 tersebut. Jika true, semua kueri harus menggunakan reservasi 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 mengetahui informasi selengkapnya, lihat Harga.