Vista JOBS_BY_FOLDER

La vista INFORMATION_SCHEMA.JOBS_BY_FOLDER contiene los metadatos en tiempo real sobre todos los trabajos enviados en la carpeta superior del proyecto actual, incluidos los trabajos en las subcarpetas que contiene.

Permisos necesarios

A fin de consultar la vista INFORMATION_SCHEMA.JOBS_BY_FOLDER, necesitas el permiso bigquery.jobs.listAll de Identity and Access Management (IAM) para la carpeta superior. Cada uno de los siguientes roles predefinidos de IAM incluye el permiso requerido:

Administrador de carpetas
Administrador de recursos de BigQuery

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

Schema

La columna creation_time particiona los datos subyacentes y project_id y user_email los agrupan.

La vista INFORMATION_SCHEMA.JOBS_BY_FOLDER tiene el siguiente esquema:

Nombre de la columna	Tipo de datos	Valor
`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.
`project_id`	`STRING`	Es el ID del proyecto (columna de agrupamiento en clústeres).
`project_number`	`INTEGER`	Es el número del proyecto.
`folder_numbers`	`REPEATED INTEGER`	Son los ID de las Cuentas de Google y la Administración de ID (GAIA) de las carpetas en el principal de un proyecto para comenzar con la carpeta de hoja más cercana al proyecto. Esta columna solo se propaga en `JOBS_BY_FOLDER`.
`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`	El tipo de declaración de consulta, si es válido. Por ejemplo, `SELECT`, `INSERT`, `UPDATE`, `DELETE` o `SCRIPT`. Consulta QueryStatementType para obtener una lista de valores válidos.
`priority`	`STRING`	La prioridad de este trabajo. Los valores válidos incluyen `INTERACTIVE` y `BATCH`.
`start_time`	`TIMESTAMP`	Es la hora de inicio de este trabajo.
`end_time`	`TIMESTAMP`	Es la hora de finalización de este trabajo.
`query`	`STRING`	Texto de consulta de SQL. Nota: Solo la vista `JOBS_BY_PROJECT` tiene la columna `query`.
`state`	`STRING`	Estado de ejecución del trabajo. Los estados válidos incluyen `PENDING`, `RUNNING` y `DONE`.
`reservation_id`	`STRING`	Nombre de la reserva principal asignada a este trabajo, si corresponde. Si tu trabajo se ejecutó en un proyecto asignado a una reserva, tendrá este formato: `RESERVATION_ADMIN_PROJECT:RESERVATION_LOCATION.RESERVATION_NAME`. En este resultado, se ilustra lo siguiente: `RESERVATION_ADMIN_PROJECT`: Es el nombre del proyecto de Google Cloud que administra la reserva. `RESERVATION_LOCATION`: Es la ubicación de la reserva. `RESERVATION_NAME`: El nombre de la reserva
`total_bytes_processed`	`INTEGER`	Es el total de bytes procesados por el trabajo.
`total_slot_ms`	`INTEGER`	Son los milisegundos de ranura para el trabajo durante toda su duración.
`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é.
`destination_table`	`RECORD`	Es la tabla de destino para los resultados (si hay alguno).
`referenced_tables`	`RECORD`	Es el arreglo de tablas a las que hace referencia el trabajo. Solo se propaga para los trabajos de consulta.
`labels`	`RECORD`	Es el arreglo de etiquetas aplicadas al trabajo como strings `key`, `value`.
`timeline`	`RECORD`	Cronograma de consultas del trabajo. Contiene instantáneas de la ejecución de consultas.
`job_stages`	`RECORD`	Etapas de consulta del trabajo.
`total_bytes_billed`	`INTEGER`	Si el proyecto está configurado para usar precios según demanda, este campo contiene el total de bytes facturados por el trabajo. Si el proyecto está configurado para usar precios de tasa fija, no se te facturará por los bytes y este campo solo es informativo.
`parent_job_id`	`STRING`	ID del trabajo superior, si hay alguno.
`transaction_id`	`STRING`	ID de la transacción en la que se ejecutó este trabajo, si corresponde. (Vista previa)
`session_info`	`RECORD`	Detalles sobre la sesión en la que se ejecutó este trabajo, si corresponde. (Vista previa)
`bi_engine_statistics`	`RECORD`	Si el proyecto está configurado para usar la interfaz de SQL de BI Engine, este campo contiene BiEngineStatistics. En caso contrario `NULL`.
`total_modified_partitions`	`INTEGER`	Cantidad total de particiones que modificó el trabajo. Este campo se propaga para los trabajos `LOAD` y `QUERY`.

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 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.JOBS_BY_FOLDER	Carpeta que contiene el proyecto especificado	`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.

Cuando consultes INFORMATION_SCHEMA.JOBS_BY_FOLDER para encontrar un costo de resumen de los trabajos de consulta, excluye el tipo de declaración SCRIPT; de lo contrario, algunos valores podrían contarse dos veces. En la fila SCRIPT, se incluyen valores de resumen para todos los trabajos secundarios que se ejecutaron como parte de este trabajo.