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:

REGION: qualquer nome da região do conjunto de dados. Por exemplo, US ou us-west2.

Examples

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}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+