Visualização ORGANIZATION_OPTIONS_CHANGES

Consulte a visualização INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES para recuperar metadados em tempo real sobre alterações de configuração do BigQuery em uma organização. Essa visualização reflete as alterações de configuração no nível da organização e para envolvidos no projeto feitas após 31 de janeiro de 2024.

Permissões necessárias

Para ter a permissão necessária para fazer as alterações de configuração, peça ao administrador que conceda a você o papel do IAM de Administrador do BigQuery (roles/bigquery.admin) na organização. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esse papel predefinido contém a permissão bigquery.config.update, que é necessária para acessar as alterações de configuração.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Esquema

Quando você consulta a visualização INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES, os resultados da consulta contêm uma linha para cada alteração de configuração em uma organização.

A visualização INFORMATION_SCHEMA.ORGANIZATION_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.ORGANIZATION_OPTIONS_CHANGES	Alterações de configuração na organização especificada.	`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 alterações da opção default_query_job_timeout_ms option:

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES
WHERE
  updated_options.default_query_job_timeout_ms is not null;

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_query_job_timeout_ms":{"new":1860369,"old":1860008}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+