Vista CAPACITY_COMMITMENT_CHANGES

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES contiene una lista casi en tiempo real de todos los cambios realizados en los compromisos de capacidad del proyecto de administración. Cada fila representa un único cambio en un único compromiso de capacidad. Para obtener más información, consulta el artículo Compromisos de espacio publicitario.

Permiso obligatorio

Para consultar la vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, 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 Control de acceso con gestión de identidades y accesos.

Esquema

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 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.
action STRING Tipo de evento que se ha producido con el compromiso de capacidad. Puede ser CREATE, UPDATE o DELETE.
user_email STRING Dirección de correo del usuario o asunto de la federación de identidades de la plantilla que ha realizado el cambio. google para ver los cambios que ha hecho Google. NULL si la dirección de correo no se conoce.
commitment_start_time TIMESTAMP El inicio del periodo de compromiso actual. Solo se aplica a los compromisos de capacidad de ACTIVE. De lo contrario, es NULL.
commitment_end_time TIMESTAMP El final del periodo de compromiso actual. Solo se aplica a los compromisos de capacidad de ACTIVE. De lo contrario, es NULL.
failure_status RECORD En el caso de un plan de compromiso de FAILED, proporciona el motivo del fallo; de lo contrario, es NULL. RECORD se compone de code y message.
renewal_plan STRING El plan al que se convierte este compromiso de capacidad después de que transcurran commitment_end_time. Una vez que se haya cambiado el plan, el periodo de compromiso se ampliará según el plan de compromiso. Solo se aplica a los compromisos ANNUAL y TRIAL. De lo contrario, es NULL.
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.

Conservación de datos

Esta vista contiene los compromisos de capacidad actuales y los compromisos de capacidad eliminados que se conservan durante un máximo de 41 días, tras los cuales se quitan de la vista.

Á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_COMMITMENT_CHANGES[_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

La siguiente consulta muestra el usuario que ha hecho la última actualización del compromiso de capacidad del proyecto actual en 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 |
+--------------------------------+-------------------------+