Vista CAPACITY_COMMITMENTS

A vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS contém uma lista praticamente em tempo real de todos os compromissos de capacidade atuais no projeto de administração. Cada linha representa um compromisso de capacidade único e atual. Um compromisso de capacidade atual está pendente ou ativo e não foi eliminado. Para mais informações sobre a reserva, consulte o artigo Compromissos de horários.

Autorização necessária

Para consultar a vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, 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 o IAM

Esquema

A vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
ddl STRING A declaração DDL usada para criar este compromisso de capacidade.
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.
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.
renewal_plan STRING Novo plano de compromisso após o fim do plano de compromisso atual. Pode alterar o plano de renovação de um compromisso em qualquer altura até este expirar.

Â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_COMMITMENTS[_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

O exemplo seguinte devolve uma lista de compromissos de capacidade ativos para o projeto atual:

SELECT
  capacity_commitment_id,
  slot_count
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
WHERE
  state = 'ACTIVE';

O resultado é semelhante ao seguinte:

+------------------------+------------+
| capacity_commitment_id | slot_count |
+------------------------+------------+
|    my_commitment_05    |    1000    |
|    my_commitment_06    |    1000    |
|    my_commitment_07    |    1500    |
|    my_commitment_08    |    2000    |
+------------------------+------------+