Vista CAPACITY_COMMITMENTS

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS contiene una lista 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.

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 es el ID de tu proyecto de Cloud. Si no se especifica, se usa el proyecto predeterminado.
  • REGION: cualquier nombre de región del conjunto de datos. Por ejemplo, region-us.