Esta página se ha traducido con Cloud Translation API.

Vista ASIGNACIONES

La vista INFORMATION_SCHEMA.ASSIGNMENTS contiene una lista casi en tiempo real de todas las asignaciones actuales del proyecto de administración. Cada fila representa una asignación actual. Una tarea actual está pendiente o activa y no se ha eliminado. Para obtener más información sobre las reservas, consulta el artículo Introducción a las reservas.

Permiso obligatorio

Para consultar la vista INFORMATION_SCHEMA.ASSIGNMENTS, necesitas el permiso de gestión de identidades y accesos (IAM) bigquery.reservationAssignments.listdel 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.ASSIGNMENTS tiene el siguiente esquema:

Nombre de la columna	Tipo de datos	Valor
`ddl`	`STRING`	La instrucción DDL usada para crear esta asignación.
`project_id`	`STRING`	ID del proyecto de administración.
`project_number`	`INTEGER`	Número del proyecto de administración.
`assignment_id`	`STRING`	ID que identifica de forma única la tarea.
`reservation_name`	`STRING`	Nombre de la reserva que usa la asignación.
`job_type`	`STRING`	El tipo de trabajo que puede usar la reserva. Puede ser `PIPELINE`, `QUERY`, `CONTINUOUS`, `ML_EXTERNAL` o `BACKGROUND`.
`assignee_id`	`STRING`	ID que identifica de forma exclusiva el recurso asignado.
`assignee_number`	`INTEGER`	Número que identifica de forma exclusiva el recurso asignado.
`assignee_type`	`STRING`	Tipo de recurso asignado. Puede ser `organization`, `folder` o `project`.

Á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.ASSIGNMENTS[_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`.

Nota: Debes usar un calificador de región para consultar vistas de INFORMATION_SCHEMA. La ubicación de la ejecución de la consulta debe coincidir con la región de la vista INFORMATION_SCHEMA.

Ejemplo

Para ejecutar la consulta en un proyecto que no sea el predeterminado, añade el ID del proyecto con el siguiente formato:

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.ASSIGNMENTS

Haz los cambios siguientes:

PROJECT_ID: el ID del proyecto al que has asignado reservas.
REGION_NAME: el nombre de la región.

Por ejemplo, `myproject`.`region-us`.INFORMATION_SCHEMA.ASSIGNMENTS.

En el siguiente ejemplo se obtiene la reserva asignada actualmente a un proyecto y su capacidad de ranuras. Esta información es útil para depurar el rendimiento de los trabajos, ya que permite comparar el uso de ranuras del proyecto con la capacidad de ranuras de la reserva asignada a ese proyecto.

SELECT
  reservation.reservation_name,
  reservation.slot_capacity
FROM
  `RESERVATION_ADMIN_PROJECT.region-REGION_NAME`.
  INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT assignment
INNER JOIN
  `RESERVATION_ADMIN_PROJECT.region-REGION_NAME`.
  INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT AS reservation
ON
  (assignment.reservation_name = reservation.reservation_name)
WHERE
   assignment.assignee_id = "PROJECT_ID"
  AND job_type = "QUERY";