Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Vue PROJECT_OPTIONS_CHANGES
Vous pouvez récupérer les métadonnées en temps réel sur les modifications liées à la configuration BigQuery d'un projet en interrogeant la vue INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES.
Cette vue reflète les modifications liées à la configuration au niveau du projet apportées après le 31 janvier 2024.
Autorisations requises
Pour obtenir la configuration, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.config.update au niveau du projet. Le rôle IAM prédéfini roles/bigquery.admin inclut les autorisations dont vous avez besoin pour créer une configuration.
Pour plus d'informations sur les autorisations BigQuery précises, consultez la section Rôles et autorisations.
Schéma
Lorsque vous interrogez la vue INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES, les résultats de la requête contiennent une ligne pour chaque modification de configuration d'un projet.
La vue INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES présente le schéma suivant :
Nom de la colonne
Type de données
Valeur
update_time
TIMESTAMP
Heure à laquelle la modification de la configuration s'est produite.
username
STRING
Pour les utilisateurs propriétaires, il s'agit de leur adresse e-mail. Pour les utilisateurs tiers, il s'agit du nom que les utilisateurs ont défini dans le fournisseur d'identité tiers.
updated_options
JSON
Objet JSON des options de configuration mises à jour par les utilisateurs au sein de la modification, contenant les valeurs précédentes et les nouvelles valeurs des champs mis à jour.
project_id
STRING
ID du projet. Ce champ est vide pour les modifications de configuration au niveau de l'organisation.
project_number
INTEGER
Numéro du projet. Ce champ est vide pour les modifications de configuration au niveau de l'organisation.
Conservation des données
Cette vue contient les sessions en cours d'exécution et l'historique des sessions terminées au cours des 180 derniers jours.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/16 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/16 (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"]]
