Halaman ini diterjemahkan oleh Cloud Translation API.

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.

Menentukan setelan konfigurasi

Bagian berikut menjelaskan cara menentukan setelan konfigurasi default. Setelan default dikonfigurasi di tingkat organisasi atau project, tetapi dapat diganti di tingkat sesi atau tugas. Untuk menerapkan perilaku default, Anda dapat mengonfigurasi setelan default bersama dengan kebijakan organisasi terkait.

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.

Mengonfigurasi setelan organisasi

Anda dapat mengonfigurasi setelan di tingkat organisasi menggunakan pernyataan GoogleSQL berikut. Saat menentukan konfigurasi, Anda harus menentukan region tempat konfigurasi tersebut diterapkan. Anda hanya dapat menggunakan satu region untuk setiap pernyataan.

Untuk mengonfigurasi setelan organisasi, gunakan pernyataan DDL ALTER ORGANIZATION SET OPTIONS. Contoh berikut menentukan beberapa konfigurasi default, termasuk:

Zona waktu: America/Chicago
Kunci Cloud KMS: kunci yang ditentukan pengguna
Waktu tunggu kueri: 30 menit (1800000 milidetik)
Waktu tunggu antrean kueri interaktif: 10 menit (600000 milidetik)
Waktu tunggu antrean kueri batch: 20 menit (1200000 milidetik)

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.default_storage_billing_model`= BILLING_MODEL,
  `region-REGION.default_max_time_travel_hours` = 72);

Ganti kode berikut:

REGION: region yang terkait dengan project atau organisasi Anda—misalnya, us atau europe-west6.
KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Kunci Cloud KMS yang dikelola pelanggan.
BILLING_MODEL: model penyimpanan untuk set data baru—misalnya, PHYSICAL untuk byte fisik.

Contoh berikut menghapus semua setelan default tingkat organisasi:

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

Konfigurasikan setelan project

Anda dapat mengonfigurasi setelan di tingkat project menggunakan pernyataan GoogleSQL berikut. Saat menentukan konfigurasi, Anda harus menentukan region tempat konfigurasi tersebut diterapkan. Anda hanya dapat menggunakan satu region untuk setiap pernyataan.

Untuk mengonfigurasi setelan project, gunakan pernyataan DDL ALTER PROJECT SET OPTIONS. Pernyataan DDL ALTER PROJECT SET OPTIONS secara opsional menerima variabel PROJECT_ID. Jika tidak ditentukan, PROJECT_ID akan ditetapkan secara default ke project saat ini tempat kueri berjalan. Contoh berikut menentukan beberapa konfigurasi default:

Zona waktu: America/Los_Angeles
Kunci Cloud KMS: contoh kunci
Waktu tunggu kueri: 1 jam
Waktu tunggu antrean kueri interaktif: 10 menit
Waktu tunggu antrean kueri batch: 20 menit
Keadilan berbasis reservasi: diaktifkan

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.default_storage_billing_model`= BILLING_MODEL,
  `region-REGION.default_max_time_travel_hours` = 72,
  `region-REGION.default_cloud_resource_connection_id` = CONNECTION_ID,
  `region-REGION.default_sql_dialect_option` = 'default_google_sql',
  `region-REGION.enable_reservation_based_fairness` = true);

Ganti kode berikut:

PROJECT_ID: ID project.
REGION: region yang terkait dengan project atau organisasi Anda—misalnya, us atau europe-west6.
KMS_KEY: kunci Cloud KMS yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Kunci Cloud KMS yang dikelola pelanggan.
BILLING_MODEL: model penyimpanan untuk set data baru—misalnya, PHYSICAL untuk byte fisik.
CONNECTION_ID: ID koneksi yang akan digunakan sebagai koneksi default untuk tabel dan model.

Contoh berikut menghapus semua setelan default tingkat project. Setelan default menggunakan setelan default tingkat organisasi apa pun, jika ada. Jika tidak, semua setelan default akan ditetapkan ke default global.

ALTER PROJECT PROJECT_ID
SET OPTIONS (
  `region-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);

Konfigurasi tingkat project akan mengganti konfigurasi tingkat organisasi. Konfigurasi tingkat project kemudian dapat diganti oleh konfigurasi tingkat sesi, yang dapat diganti oleh konfigurasi tingkat tugas.

Mengambil 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

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.
enable_reservation_based_fairness: Opsi yang menentukan cara slot tidak aktif 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 tingkat 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 ini:
- '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): 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'.

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.