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.