Vista de JOBS_TIMELINE_BY_USER

La vista INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER contiene metadatos de BigQuery casi en tiempo real por fragmento de tiempo de los trabajos que envía el usuario actual en el proyecto actual. Esta vista contiene trabajos completados y en ejecución.

Permisos necesarios

Para consultar la vista INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER, necesitas el permiso bigquery.jobs.list de Identity and Access Management (IAM) para el proyecto. Cada uno de los siguientes roles predefinidos de IAM incluye el permiso requerido:

Lector del proyecto
Usuario de BigQuery

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Schema

Cuando consultas las vistas INFORMATION_SCHEMA.JOBS_TIMELINE_BY_*, los resultados de la consulta contienen una fila por cada segundo de ejecución de cada trabajo de BigQuery. Cada período comienza en un intervalo de un segundo y dura un segundo exacto.

La vista INFORMATION_SCHEMA.JOBS_TIMELINE_BY_* tiene el siguiente esquema:

Nombre de la columna	Tipo de datos	Valor
`period_start`	`TIMESTAMP`	Es la hora de inicio de este período.
`period_slot_ms`	`INTEGER`	Son los milisegundos de ranura consumidos en este período.
`period_shuffle_ram_usage_ratio`	`FLOAT`	Proporción de uso aleatorio en el período seleccionado.
`project_id`	`STRING`	(Columna de agrupamiento en clústeres) ID del proyecto.
`project_number`	`INTEGER`	Es el número del proyecto.
`folder_numbers`	`REPEATED INTEGER`	Numere los IDs de las carpetas que contienen el proyecto, comenzando con la carpeta que contiene inmediatamente el proyecto, seguida de la carpeta que contiene la carpeta secundaria, y así sucesivamente. Por ejemplo, si “folder_numbers” es “[1, 2, 3]”, la carpeta “1” contiene inmediatamente el proyecto, la carpeta “2” contiene “1” y la carpeta “3” contiene “2”.
`user_email`	`STRING`	Es la dirección de correo electrónico o la cuenta de servicio del usuario que ejecutó el trabajo (columna de agrupamiento en clústeres).
`job_id`	`STRING`	Es el ID del trabajo. Por ejemplo, `bquxjob_1234`.
`job_type`	`STRING`	Es el tipo de trabajo. Puede ser `QUERY`, `LOAD`, `EXTRACT`, `COPY` o `null`. El tipo de trabajo `null` indica un trabajo interno, como la evaluación de la declaración del trabajo de secuencia de comandos o la actualización de la vista materializada.
`statement_type`	`STRING`	Es el tipo de declaración de consulta, si es válido. Por ejemplo, `SELECT`, `INSERT`, `UPDATE` o `DELETE`.
`job_creation_time`	`TIMESTAMP`	Es la hora de creación de este trabajo (columna de partición). La partición se basa en la hora UTC de esta marca de tiempo.
`job_start_time`	`TIMESTAMP`	Es la hora de inicio de este trabajo.
`job_end_time`	`TIMESTAMP`	Es la hora de finalización de este trabajo.
`state`	`STRING`	Es estado de ejecución del trabajo al final de este período. Los estados válidos incluyen `PENDING`, `RUNNING` y `DONE`.
`reservation_id`	`STRING`	Es el nombre de la reserva principal asignada a este trabajo al final de este período, si corresponde.
`total_bytes_processed`	`INTEGER`	Es el total de bytes procesados por el trabajo.
`error_result`	`RECORD`	Son los detalles del error (si hay alguno), como `ErrorProto.`.
`cache_hit`	`BOOLEAN`	Indica si los resultados de la consulta de este trabajo provienen de una caché.
`period_estimated_runnable_units`	`INTEGER`	Unidades de trabajo que se pueden programar de inmediato en este período. Las ranuras adicionales para estas unidades de trabajo aceleran tu consulta, siempre que ninguna otra consulta en la reserva necesite ranuras adicionales.

Retención de datos

Esta vista contiene los trabajos que se están ejecutando y el historial de trabajos de los últimos 180 días.

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 alcance de la región y los recursos para esta vista:

Nombre de la vista	Permiso del recurso	Permiso de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER	Trabajos que envía el usuario actual en el proyecto especificado	`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.

Nota: Debes especificar la ubicación para consultar las vistas de INFORMATION_SCHEMA y la ubicación de la ejecución de la consulta debe coincidir con la región de la vista de INFORMATION_SCHEMA.

Ejemplo

En la siguiente consulta, se muestra el total de milisegundos de ranura que consumen por segundo los trabajos que envió el usuario actual en el proyecto designado:

SELECT
  period_start,
  SUM(period_slot_ms) AS total_period_slot_ms
FROM
  `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER
GROUP BY
  period_start
ORDER BY
  period_start DESC;

El resultado es similar al siguiente:

+---------------------------+---------------------------------+
|  period_start             |  total_period_slot_ms           |
+---------------------------+---------------------------------+
|  2019-10-10 00:00:04 UTC  |  118639                         |
|  2019-10-10 00:00:03 UTC  |  251353                         |
|  2019-10-10 00:00:02 UTC  |  1074064                        |
|  2019-10-10 00:00:01 UTC  |  1124868                        |
|  2019-10-10 00:00:00 UTC  |  1113961                        |
+---------------------------+---------------------------------+