Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Visualização PROJECT_OPTIONS_CHANGES
Consulte a visualização INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES para recuperar metadados em tempo real sobre alterações de configuração do BigQuery em um projeto.
Essa visualização reflete as alterações de configuração para envolvidos no projeto feitas após 31 de janeiro de 2024.
Permissões necessárias
Para acessar a configuração, você precisa da permissão bigquery.config.update do Identity and Access Management (IAM) para envolvidos no projeto. O papel predefinido roles/bigquery.admin do IAM inclui as permissões necessárias para criar uma configuração.
Para mais informações sobre permissões granulares do BigQuery, consulte
papéis e permissões.
Esquema
Quando você consulta a visualização INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES, os resultados da consulta contêm uma linha para cada alteração de configuração em um projeto.
A visualização INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES tem o seguinte esquema:
Nome da coluna
Tipo de dados
Valor
update_time
TIMESTAMP
A hora em que a alteração de configuração ocorreu.
username
STRING
Para usuários próprios, é o e-mail deles. Para usuários de terceiros, é o nome que os usuários definem no provedor de identidade de terceiros.
updated_options
JSON
Um objeto JSON das opções de configuração que os usuários atualizaram na alteração, contendo os valores anteriores e os novos dos campos atualizados.
project_id
STRING
O código do projeto. Esse campo fica vazio para alterações de configuração no nível da organização.
project_number
INTEGER
O número do projeto. Esse campo fica vazio para as alterações de configuração no nível da organização.
Retenção de dados
Essa visualização contém sessões em execução e o histórico de sessões concluídas nos últimos 180 dias.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-17 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"]]
