Vista CAPACITY_COMMITMENTS

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS contiene una lista casi en tiempo real de todos los compromisos de capacidad actuales dentro del proyecto de administración. Cada fila representa un compromiso de capacidad único y actual. Un compromiso de capacidad actual está pendiente o activo y no se borró. Para obtener más información sobre la reserva, consulta Compromisos.

Permiso necesario

Para consultar la vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, necesitas el permiso bigquery.capacityCommitments.list de Identity and Access Management (IAM) para el proyecto. Cada uno de los siguientes roles predefinidos de IAM incluye el permiso requerido:

  • 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 Control de acceso con IAM.

Esquema

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
ddl STRING La declaración DDL que se usa 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 el compromiso de capacidad de forma única.
commitment_plan STRING Plan de compromiso del compromiso de capacidad.
state STRING Indica el compromiso de capacidad correspondiente. Puede ser PENDING o ACTIVE.
slot_count INTEGER Recuento de ranuras asociado con el compromiso de capacidad.
edition STRING Es 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 Indica si el compromiso está asociado con el modelo heredado de capacidad de tarifa plana o con una edición. Si es FALSE, el compromiso actual está asociado con una edición. Si es TRUE, el compromiso es el modelo de capacidad de tarifa plana heredado.
renewal_plan STRING Plan de compromiso nuevo después del final del plan de compromiso actual. Puedes cambiar el plan de renovación de un compromiso en cualquier momento hasta que venza.

Permiso y sintaxis

Las consultas realizadas a esta vista deben incluir un calificador de región. Si no especificas un calificador regional, los metadatos se recuperan de todas las regiones. En la siguiente tabla, se explica el permiso de la región para esta vista:

Nombre de la vista Permiso del recurso Permiso de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT] Nivel de proyecto REGION
Reemplaza lo siguiente:

  • Opcional: PROJECT_ID: el ID del proyecto de Google Cloud. Si no se especifica, se usa el proyecto predeterminado.
+ REGION: Cualquier nombre de región del conjunto de datos. Un ejemplo es region-us.

Ejemplo

En el siguiente ejemplo, se muestra una lista de compromisos de capacidad activos para el 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    |
+------------------------+------------+