Mengelola setelan konfigurasi

Administrator BigQuery dan pemilik project 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 yang konsisten dan efisiensi operasional, sehingga mempermudah 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 bawaan 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, diperlukan waktu hingga 10 menit untuk menerapkannya. Sebelum setelan diterapkan, kueri yang memenuhi syarat dapat dirutekan ke lokasi default sebelumnya.

Mengonfigurasi setelan organisasi global

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 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 jika lokasi tidak dapat disimpulkan dari permintaan.

Saat mengonfigurasi lokasi default, Anda tidak menentukan region tempat setelan diterapkan. 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 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.
Atau, untuk menghapus setelan global tingkat organisasi default_location, masukkan pernyataan DDL berikut ke Query editor:
```
  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.
```
  bq query --use_legacy_sql=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.
```
  bq query --use_legacy_sql=false \
  'ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL);'
```

API

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

Fungsi DDL memperluas informasi yang ditampilkan oleh resource Jobs. statistics.query.statementType mencakup nilai tambahan berikut:

CREATE_TABLE
CREATE_TABLE_AS_SELECT
DROP_TABLE
CREATE_VIEW
DROP_VIEW

statistics.query memiliki 2 kolom tambahan:

ddlOperationPerformed: Operasi DDL yang dilakukan, mungkin bergantung pada keberadaan target DDL. Nilai saat ini mencakup:
- CREATE: Kueri membuat target DDL.
- SKIP: No-op. Contoh — CREATE TABLE IF NOT EXISTS dikirimkan, dan tabel ada. Atau DROP TABLE IF EXISTS dikirimkan, dan tabel tidak ada.
- REPLACE: Kueri menggantikan target DDL. Contoh — CREATE OR REPLACE TABLE dikirimkan, dan tabel sudah ada.
- DROP: Kueri menghapus target DDL.
ddlTargetTable: Saat Anda mengirimkan pernyataan CREATE TABLE/VIEW atau pernyataan DROP TABLE/VIEW, tabel target ditampilkan sebagai objek dengan 3 kolom:

"projectId": string
"datasetId": string
"tableId": string

Mengonfigurasi setelan project global

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 di asia-northeast1.
Wilayah yang ditentukan untuk koneksi yang dirujuk dalam permintaan.
Lokasi tabel tujuan.

Anda dapat mengonfigurasi setelan global di tingkat project menggunakan pernyataan DDL ALTER PROJECT SET OPTIONS. Pernyataan DDL ALTER PROJECT SET OPTIONS secara opsional menerima variabel PROJECT_ID. Jika PROJECT_ID 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 tingkat 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 jika 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 tingkat project, masukkan perintah bq query dan berikan pernyataan DDL berikut sebagai parameter kueri. Tetapkan flag use_legacy_sql ke false.
```
  bq query --use_legacy_sql=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 jika tidak dapat disimpulkan dari permintaan. Misalnya, lokasi default digunakan jika lokasi set data dalam kueri tidak dapat ditentukan.
Atau, untuk menghapus default_location di tingkat 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 tingkat project, setelan default tingkat organisasi akan digunakan, jika ada. Jika tidak, setelan default sistem akan digunakan.
```
  bq query --use_legacy_sql=false \
  'ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL);'
```

API

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

Fungsi DDL memperluas informasi yang ditampilkan oleh resource Jobs. statistics.query.statementType mencakup nilai tambahan berikut:

CREATE_TABLE
CREATE_TABLE_AS_SELECT
DROP_TABLE
CREATE_VIEW
DROP_VIEW

statistics.query memiliki 2 kolom tambahan:

ddlOperationPerformed: Operasi DDL yang dilakukan, mungkin bergantung pada keberadaan target DDL. Nilai saat ini mencakup:
- CREATE: Kueri membuat target DDL.
- SKIP: No-op. Contoh — CREATE TABLE IF NOT EXISTS dikirimkan, dan tabel ada. Atau DROP TABLE IF EXISTS dikirimkan, dan tabel tidak ada.
- REPLACE: Kueri menggantikan target DDL. Contoh — CREATE OR REPLACE TABLE dikirimkan, dan tabel sudah ada.
- DROP: Kueri menghapus target DDL.
ddlTargetTable: Saat Anda mengirimkan pernyataan CREATE TABLE/VIEW atau pernyataan DROP TABLE/VIEW, tabel target ditampilkan sebagai objek dengan 3 kolom:

"projectId": string
"datasetId": string
"tableId": string

Menentukan setelan regional

Anda dapat mengonfigurasi setelan regional di tingkat organisasi atau project.

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 ini:

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)

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

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

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 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.

Fungsi DDL memperluas informasi yang ditampilkan oleh resource Jobs. statistics.query.statementType mencakup nilai tambahan berikut:

CREATE_TABLE
CREATE_TABLE_AS_SELECT
DROP_TABLE
CREATE_VIEW
DROP_VIEW

statistics.query memiliki 2 kolom tambahan:

ddlOperationPerformed: Operasi DDL yang dilakukan, mungkin bergantung pada keberadaan target DDL. Nilai saat ini mencakup:
- CREATE: Kueri membuat target DDL.
- SKIP: No-op. Contoh — CREATE TABLE IF NOT EXISTS dikirimkan, dan tabel ada. Atau DROP TABLE IF EXISTS dikirimkan, dan tabel tidak ada.
- REPLACE: Kueri menggantikan target DDL. Contoh — CREATE OR REPLACE TABLE dikirimkan, dan tabel sudah ada.
- DROP: Kueri menghapus target DDL.
ddlTargetTable: Saat Anda mengirimkan pernyataan CREATE TABLE/VIEW atau pernyataan DROP TABLE/VIEW, tabel target ditampilkan sebagai objek dengan 3 kolom:

"projectId": string
"datasetId": string
"tableId": string

Mengonfigurasi setelan project regional

Anda dapat mengonfigurasi setelan regional di tingkat 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 di 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:

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

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

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

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.

Fungsi DDL memperluas informasi yang ditampilkan oleh resource Jobs. statistics.query.statementType mencakup nilai tambahan berikut:

CREATE_TABLE
CREATE_TABLE_AS_SELECT
DROP_TABLE
CREATE_VIEW
DROP_VIEW

statistics.query memiliki 2 kolom tambahan:

ddlOperationPerformed: Operasi DDL yang dilakukan, mungkin bergantung pada keberadaan target DDL. Nilai saat ini mencakup:
- CREATE: Kueri membuat target DDL.
- SKIP: No-op. Contoh — CREATE TABLE IF NOT EXISTS dikirimkan, dan tabel ada. Atau DROP TABLE IF EXISTS dikirimkan, dan tabel tidak ada.
- REPLACE: Kueri menggantikan target DDL. Contoh — CREATE OR REPLACE TABLE dikirimkan, dan tabel sudah ada.
- DROP: Kueri menghapus target DDL.
ddlTargetTable: Saat Anda mengirimkan pernyataan CREATE TABLE/VIEW atau pernyataan DROP TABLE/VIEW, tabel target ditampilkan sebagai objek dengan 3 kolom:

"projectId": string
"datasetId": string
"tableId": string

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.

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) di 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 hanya konfigurasi global efektif lokasi default 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 hanya setelan lokasi default 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 kueri dan tugas

Gunakan setelan berikut untuk mengontrol cara kueri dijalankan, diatur waktunya, dan dimasukkan dalam antrean.

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 waktu proses maksimum.
default_location: Setelan konfigurasi default_location digunakan untuk menjalankan tugas saat lokasi tidak ditetapkan atau tidak dapat ditentukan. Jika default_location tidak disetel, tugas akan berjalan di multi-region US.
enable_reservation_based_fairness: Opsi yang menentukan cara slot tidak digunakan dibagikan. Nilai defaultnya adalah salah (false), yang berarti slot tidak ada aktivitas didistribusikan secara merata di semua project kueri. Jika diaktifkan, slot tidak ada aktivitas dibagikan secara merata di semua reservasi terlebih dahulu, lalu di seluruh project dalam reservasi. Untuk mengetahui informasi selengkapnya, lihat keseimbangan berbasis reservasi. Opsi ini hanya didukung di level project. Anda tidak dapat menentukannya di tingkat organisasi atau tugas.
default_time_zone: Zona waktu default yang akan 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:
- 'default_legacy_sql' (default): Gunakan 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_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.

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 terlampir. Penggunaan 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.

Harga

Tidak ada biaya tambahan untuk menggunakan layanan konfigurasi BigQuery. Untuk mengetahui informasi selengkapnya, lihat Harga.