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.
Schema
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 |
- 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. Por ejemplo,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 | +------------------------+------------+