Vista ORGANIZATION_OPTIONS_CHANGES

Pode consultar a vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES para obter metadados em tempo real sobre as alterações de configuração do BigQuery numa organização. Esta vista reflete as alterações de configuração ao nível da organização e do projeto feitas após 31 de janeiro de 2024.

Autorizações necessárias

Para receber a autorização de que precisa para receber as alterações de configuração, peça ao seu administrador para lhe conceder a função de administrador do BigQuery (roles/bigquery.admin) do IAM na sua organização. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém a autorização bigquery.config.update , que é necessária para obter as alterações de configuração.

Também pode obter esta autorização com funções personalizadas ou outras funções predefinidas.

Esquema

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

A vista 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 da configuração ocorreu.
username STRING Para utilizadores originais, é o email do utilizador. Para utilizadores de terceiros, é o nome que os utilizadores definem no Fornecedor de identidade de terceiros.
updated_options JSON Um objeto JSON das opções de configuração que os utilizadores atualizaram na alteração, que contém os valores anteriores e os novos valores dos campos atualizados.
project_id STRING O ID do projeto. Este campo está vazio para alterações de configuração ao nível da organização.
project_number INTEGER O número do projeto. Este campo está vazio para as alterações de configuração ao nível da organização.

Retenção de dados

Esta vista contém sessões em execução e o histórico de sessões concluídas nos últimos 180 dias.

Âmbito e sintaxe

As consultas nesta vista têm de ter um qualificador de região.

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES Alterações de configuração na organização especificada. REGION

Substitua o seguinte:

Exemplos

O exemplo seguinte obtém 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 é 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}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+