Visualização 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 atual único. 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 a 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.

Para garantir a estabilidade, recomendamos que liste explicitamente as colunas nas suas consultas de esquema de informações em vez de usar um caráter universal (SELECT *). A listagem explícita de colunas impede que as consultas sejam interrompidas se o esquema subjacente for alterado.

Â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    |
+------------------------+------------+