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
ouus-west2
.
Exemplos
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}} | +----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+