Vista CAPACITY_COMMITMENT_CHANGES

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES contiene una lista casi en tiempo real de todos los cambios de compromisos de capacidad dentro del proyecto de administración. Cada fila representa un solo cambio que se realizó en un compromiso de capacidad único. Para obtener más información sobre la reserva, consulta Compromisos.

Permiso necesario

Para consultar la vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, 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 IAM de BigQuery, consulta Control de acceso con IAM.

Schema

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
change_timestamp TIMESTAMP Hora en la que se produjo el cambio.
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.
action STRING Tipo de evento que ocurrió con el compromiso de capacidad. Puede ser CREATE, UPDATE o DELETE.
user_email STRING Dirección de correo electrónico del usuario o persona de la federación de Workforce Identity que realizó el cambio. google para los cambios que realizó Google. NULL si se desconoce la dirección de correo electrónico.
commitment_start_time TIMESTAMP El comienzo del período de compromiso actual. Solo se aplica a los compromisos de capacidad ACTIVE; de lo contrario, esto será NULL.
commitment_end_time TIMESTAMP El final del período de compromiso actual. Solo se aplica a los compromisos de capacidad ACTIVE; de lo contrario, esto será NULL.
failure_status RECORD Para un plan de compromiso de FAILED, proporciona el motivo de la falla; de lo contrario, esto será NULL. RECORD consta de code y message.
renewal_plan STRING El plan al que se convierte este compromiso de capacidad luego de que pase el commitment_end_time. Una vez que se cambia el plan, el período de compromiso se extiende según el plan de compromiso. Solo se aplica a los compromisos ANNUAL y TRIAL; de lo contrario, esto será NULL.
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.

Retención de datos

En esta vista, se muestran los compromisos de capacidad actuales y los compromisos de capacidad borrados que se conservan durante un máximo de 41 días tras los cuales se quitan de la vista.

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_COMMITMENT_CHANGES[_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. Por ejemplo, region-us.

Ejemplo

En la siguiente consulta, se muestra el usuario que realizó la actualización del compromiso de capacidad más reciente en el proyecto actual dentro de la fecha especificada.

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

El resultado es similar al siguiente:

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+