Visualização de CAPACITY_COMMITMENT_CHANGES

A visualização INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES contém uma lista quase em tempo real de todas as alterações nos compromissos de capacidade no projeto de administração. Cada linha representa uma única alteração em um único compromisso de capacidade. Para mais informações sobre reserva, consulte Compromissos.

Permissão necessária

Para consultar a visualização INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, é preciso ter a permissão bigquery.capacityCommitments.list Identity and Access Management (IAM) para o projeto. Cada um dos seguintes papéis predefinidos do IAM inclui a permissão necessária:

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Esquema

A visualização INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
change_timestamp TIMESTAMP Horário em que a alteração ocorreu.
project_id STRING ID do projeto de administração.
project_number INTEGER Número do projeto de administração.
capacity_commitment_id STRING Código que identifica exclusivamente o compromisso de capacidade.
commitment_plan STRING Plano de compromisso do compromisso de capacidade.
state STRING Indique o compromisso de capacidade. Pode ser PENDING ou ACTIVE.
slot_count INTEGER Contagem de slots associada ao compromisso de capacidade.
action STRING Tipo de evento que ocorreu com o compromisso de capacidade. Pode ser CREATE, UPDATE ou DELETE.
user_email STRING Endereço de e-mail do usuário ou usuário da federação de identidade da força de trabalho que fez a alteração. google para alterações feitas pelo Google. NULL se o endereço de e-mail for desconhecido.
commitment_start_time TIMESTAMP O início do período de compromisso atual. Aplicável apenas a compromissos de capacidade ACTIVE. Caso contrário, será NULL.
commitment_end_time TIMESTAMP O fim do período de compromisso atual. Aplicável apenas a compromissos de capacidade ACTIVE. Caso contrário, será NULL.
failure_status RECORD Para um plano de compromisso FAILED, fornece o motivo da falha. Caso contrário, será NULL. RECORD consiste em code e message.
renewal_plan STRING O plano no qual esse compromisso de capacidade é convertido após o commitment_end_time passar. Depois que o plano é alterado, o período do compromisso é estendido de acordo com o respectivo plano. Aplicável apenas a compromissos ANNUAL e TRIAL. Caso contrário, será NULL.
edition STRING A edição associada a esta reserva. Para mais informações sobre edições, consulte Introdução às edições do BigQuery.
is_flat_rate BOOL Se o compromisso está associado ao modelo de capacidade de taxa fixa legado ou a uma edição. Se for FALSE, o compromisso atual será associado a uma edição. Se for TRUE, o compromisso será o modelo de capacidade de taxa fixa legado.

Retenção de dados

Essa visualização contém os compromissos de capacidade atuais e os compromissos de capacidade excluídos que são mantidos por até 41 dias após o qual são removidos da visualização.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. Se você não especificar um qualificador regional, os metadados serão recuperados de todas as regiões. A tabela a seguir explica o escopo da região dessa visualização:

Nome da visualização Escopo do recurso Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES[_BY_PROJECT] Nível do projeto REGION
Substitua:

  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud. Se não for especificado, o projeto padrão será usado.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, region-us.

Exemplo

A consulta a seguir exibe o usuário que fez a atualização do compromisso de capacidade mais recente no projeto atual na data especificada.

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

O resultado será semelhante ao seguinte:

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+