Vista PROJECT_OPTIONS_CHANGES

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

Autorizações necessárias

Para obter a configuração, precisa da autorização de bigquery.config.update gestão de identidade e de acesso (IAM) ao nível do projeto. A função de IAM predefinida roles/bigquery.admin inclui as autorizações necessárias para criar uma configuração.

Para mais informações acerca das autorizações detalhadas do BigQuery, consulte as funções e autorizações.

Esquema

Quando consulta a vista INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES, os resultados da consulta contêm uma linha para cada alteração de configuração num projeto.

A vista 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 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.PROJECT_OPTIONS_CHANGES Alterações de configuração no projeto especificado. REGION

Substitua o seguinte:

Exemplos

O exemplo seguinte obtém todas as colunas da vista INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES.

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

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