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.

Observação: é necessário usar um qualificador de região para consultar visualizações INFORMATION_SCHEMA. O local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

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