Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Tampilan PROJECT_OPTIONS_CHANGES
Anda dapat membuat kueri tampilan INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES untuk mengambil metadata real-time tentang perubahan konfigurasi BigQuery suatu project.
Tampilan ini mencerminkan perubahan konfigurasi tingkat project yang dilakukan setelah 31 Januari 2024.
Izin yang diperlukan
Untuk mendapatkan konfigurasi, Anda memerlukan izin Identity and Access Management (IAM) bigquery.config.update di tingkat project. Peran IAM bawaan roles/bigquery.admin mencakup izin yang Anda perlukan untuk membuat konfigurasi.
Untuk mengetahui informasi selengkapnya tentang izin BigQuery terperinci, lihat peran dan izin.
Skema
Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES, hasil kueri akan berisi satu baris untuk setiap perubahan konfigurasi dalam sebuah project.
Tampilan INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES memiliki skema berikut:
Nama kolom
Jenis data
Nilai
update_time
TIMESTAMP
Waktu saat perubahan konfigurasi terjadi.
username
STRING
Untuk pengguna pihak pertama, ini adalah email pengguna mereka. Untuk pengguna pihak ketiga, nama yang ditampilkan adalah nama yang ditetapkan pengguna di penyedia identitas pihak ketiga.
updated_options
JSON
Objek JSON opsi konfigurasi yang diupdate pengguna dalam
perubahan, yang berisi nilai sebelumnya dan nilai baru kolom yang diupdate.
project_id
STRING
Project ID. Kolom ini kosong untuk perubahan konfigurasi
tingkat organisasi.
project_number
INTEGER
Nomor project. Kolom ini kosong untuk perubahan konfigurasi
tingkat organisasi.
Retensi data
Tampilan ini berisi sesi yang sedang berjalan dan histori sesi
yang selesai dalam 180 hari terakhir.
Cakupan dan sintaksis
Kueri terhadap tabel virtual ini harus memiliki penentu region.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-03 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eINFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES\u003c/code\u003e view provides real-time metadata about BigQuery project configuration changes made after January 31, 2024.\u003c/p\u003e\n"],["\u003cp\u003eAccessing configuration details via this view requires the \u003ccode\u003ebigquery.config.update\u003c/code\u003e IAM permission at the project level.\u003c/p\u003e\n"],["\u003cp\u003eEach row in the view represents a configuration change, detailing the update time, the user who made the change, the updated options in JSON format, and the associated project ID and number.\u003c/p\u003e\n"],["\u003cp\u003eThis view retains data on running sessions and completed sessions within the past 180 days, and it must be queried with a region qualifier.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently a Pre-GA feature meaning that it is available "as is" with limited support.\u003c/p\u003e\n"]]],[],null,["# PROJECT_OPTIONS_CHANGES view\n============================\n\n|\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n| **Note:** To get support or provide feedback for project-level configuration changes, contact [bq-project-config-service@google.com](mailto:bq-project-config-service@google.com).\n\nYou can query the `INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES` view to retrieve\nreal-time metadata about BigQuery configuration changes of a project.\nThis view reflects project-level configuration changes\nmade after January 31, 2024.\n\nRequired permissions\n--------------------\n\nTo get the configuration, you need the `bigquery.config.update`\nIdentity and Access Management (IAM) permission at the project level. The predefined\nIAM role `roles/bigquery.admin` includes the permissions that you\nneed to create a configuration.\n\nFor more information about granular BigQuery permissions, see\n[roles and permissions](/bigquery/docs/access-control).\n\nSchema\n------\n\nWhen you query the `INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES` view, the query\nresults contain one row for each configuration change in a project.\n\nThe `INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES` view has the following schema:\n\nData retention\n--------------\n\nThis view contains sessions that are running and the history of sessions\ncompleted in the past 180 days.\n\nScope and syntax\n----------------\n\nQueries against this view must have a [region qualifier](/bigquery/docs/information-schema-intro#syntax).\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: any [dataset region name](/bigquery/docs/locations). For example, `US`, or `us-west2`.\n\n\u003cbr /\u003e\n\n| **Note:** To learn how to extract a JSON scalar value from the `updated_options` column and convert it to a SQL STRING value such as `JSON_VALUE()`, see [JSON functions](/bigquery/docs/reference/standard-sql/json_functions#categories).\n\nExamples\n--------\n\nThe following example retrieves all columns from the\n`INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES` view. \n\n```googlesql\nSELECT\n *\nFROM\n `region-\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES;\n```\n| **Note:** `INFORMATION_SCHEMA` view names are case-sensitive.\n\nThe result is similar to the following:\n\n\u003cbr /\u003e\n\n```\n+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+\n| project_number | project_id | update_time | username | updated_options |\n|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|\n| 4471534625 | myproject1 | 2023-08-22 06:57:49 UTC | user1@gmail.com | {\"default_query_job_timeout_ms\":{\"new\":0,\"old\":1860369},\"default_time_zone\":{\"new\":\"America/New_York\",\"old\":\"\"}} |\n|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|\n| 5027725474 | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {\"default_interactive_query_queue_timeout_ms\":{\"new\":1860369,\"old\":1860008}} |\n+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+\n```\n\n\u003cbr /\u003e"]]
