Vista CAPACITY_COMMITMENT_CHANGES

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

Autorização necessária

Para consultar a vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, precisa da autorização de gestão de identidade e de acesso (IAM) bigquery.capacityCommitments.list para o projeto. Cada uma das seguintes funções de IAM predefinidas inclui a autorização necessária:

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

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

A vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
change_timestamp TIMESTAMP Hora 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 ID que identifica de forma exclusiva o compromisso de capacidade.
commitment_plan STRING Plano de compromisso do compromisso de capacidade.
state STRING Indique a consolidação de capacidade em que se encontra. Pode ser PENDING ou ACTIVE.
slot_count INTEGER Contagem de espaços 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 O endereço de email do utilizador ou o assunto da federação de identidades da força de trabalho que fez a alteração. google para alterações efetuadas pela Google. NULL se o endereço de email for desconhecido.
commitment_start_time TIMESTAMP O início do período de compromisso atual. Aplicável apenas a compromissos de capacidade de ACTIVE, caso contrário, é NULL.
commitment_end_time TIMESTAMP O fim do período de fidelização atual. Aplicável apenas a compromissos de capacidade de ACTIVE, caso contrário, é NULL.
failure_status RECORD Para um plano de compromisso FAILED, indica o motivo da falha. Caso contrário, é NULL. RECORD consiste em code e message.
renewal_plan STRING O plano para o qual este compromisso de capacidade é convertido após commitment_end_time. Após a alteração do plano, o período de compromisso é prolongado de acordo com o plano de compromisso. Apenas aplicável a compromissos de ANNUAL e TRIAL . Caso contrário, é NULL.
edition STRING A edição associada a esta reserva. Para mais informações sobre as edições, consulte o artigo Introdução às edições do BigQuery.
is_flat_rate BOOL Se o compromisso está associado ao modelo de capacidade de taxa fixa antigo ou a uma edição. Se FALSE, o compromisso atual está associado a uma edição. Se TRUE, o compromisso é o modelo de capacidade de taxa fixa antigo.

Retenção de dados

Esta vista contém compromissos de capacidade atuais e os compromissos de capacidade eliminados que são mantidos durante um máximo de 41 dias, após os quais são removidos da vista.

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos de todas as regiões. A tabela seguinte explica o âmbito da região para esta vista:

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES[_BY_PROJECT] Nível do projeto REGION
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Exemplo

A seguinte consulta apresenta o utilizador que fez a atualização do compromisso de capacidade mais recente para o 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 é semelhante ao seguinte:

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