Vista CAPACITY_COMMITMENTS

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS contiene una lista casi en tiempo real de todos los compromisos de capacidad actuales del proyecto de administración. Cada fila representa un compromiso de capacidad actual. Hay un compromiso de capacidad actual pendiente o activo que no se ha eliminado. Para obtener más información sobre las reservas, consulta Compromisos de espacio.

Permiso obligatorio

Para consultar la vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, debe tener el permiso de bigquery.capacityCommitments.list Gestión de Identidades y Accesos (IAM) para el proyecto. Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye el permiso necesario:

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

Para obtener más información sobre los permisos de BigQuery, consulta el artículo Control de acceso con gestión de identidades y accesos.

Esquema

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
ddl STRING La instrucción DDL usada para crear este compromiso de capacidad.
project_id STRING ID del proyecto de administración.
project_number INTEGER Número del proyecto de administración.
capacity_commitment_id STRING ID que identifica de forma exclusiva el compromiso de capacidad.
commitment_plan STRING Plan de compromiso de la confirmación de capacidad.
state STRING Indica el estado de la confirmación de capacidad. Puede ser PENDING o ACTIVE.
slot_count INTEGER Número de ranuras asociadas al compromiso de capacidad.
edition STRING La edición asociada a esta reserva. Para obtener más información sobre las ediciones, consulta Introducción a las ediciones de BigQuery.
is_flat_rate BOOL Si el compromiso está asociado al modelo de capacidad de tarifa plana antiguo o a una edición. Si FALSE, el compromiso actual está asociado a una edición. Si TRUE, el compromiso es el modelo de capacidad de tarifa plana antiguo.
renewal_plan STRING Nuevo plan de compromiso tras la finalización del plan de compromiso actual. Puedes cambiar el plan de renovación de un compromiso en cualquier momento hasta que caduque.

Ámbito y sintaxis

Las consultas en esta vista deben incluir un calificador de región. Si no especifica un calificador regional, los metadatos se recuperan de todas las regiones. En la siguiente tabla se explica el ámbito de la región de esta vista:

Nombre de la vista Ámbito de los recursos Ámbito de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT] Nivel de proyecto REGION
Sustituye lo siguiente:
  • Opcional: PROJECT_ID: el ID de tu Google Cloud proyecto. Si no se especifica, se usa el proyecto predeterminado.
  • REGION: cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Ejemplo

En el siguiente ejemplo se devuelve una lista de compromisos de capacidad activos del proyecto actual:

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

El resultado es similar al siguiente:

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