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.

Escopo e sintaxe

As consultas nesta visualização precisam ter um qualificador de região.

Nome da visualização Escopo do recurso Escopo da região
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES Alterações de configuração no projeto especificado. REGION

Substitua:

Exemplos

O exemplo a seguir recupera todas as colunas da visualização INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES.

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES;

O resultado será semelhante ao seguinte:

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 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":""}} |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 5027725474     | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {"default_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+