Visualização de CAPACITY_COMMITMENTS

A visualização INFORMATION_SCHEMA.CAPACITY_COMMITMENTS contém uma lista quase 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 excluído. Para mais informações sobre reserva, consulte Compromissos.

Permissão necessária

Para consultar a visualização INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, é 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_COMMITMENTS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
ddl STRING A instrução DDL usada para criar esse 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 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.
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.
renewal_plan STRING Novo plano de compromisso após o término do plano de compromisso atual. Você pode alterar o plano de renovação de um compromisso a qualquer momento até que ele expire.

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

O exemplo a seguir retorna 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 será semelhante ao seguinte:

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