Visualização JOBS_BY_FOLDER

A visualização INFORMATION_SCHEMA.JOBS_BY_FOLDER contém os metadados em tempo real sobre todos os jobs enviados na pasta pai do projeto atual, incluindo os jobs em subpastas abaixo dele.

Permissões necessárias

Para consultar a visualização INFORMATION_SCHEMA.JOBS_BY_FOLDER, você precisa da permissão bigquery.jobs.listAll Identity and Access Management (IAM) para a pasta pai. Cada um dos seguintes papéis predefinidos do IAM inclui a permissão necessária:

Administrador de pastas
Administrador de recursos do BigQuery

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Schema

Os dados subjacentes são particionados pela coluna creation_time e agrupados por project_id e user_email.

A visualização INFORMATION_SCHEMA.JOBS_BY_FOLDER tem o seguinte esquema:

Nome da coluna	Tipo de dados	Valor
`creation_time`	`TIMESTAMP`	(Coluna de particionamento) horário da criação do job. O particionamento é baseado no horário UTC desse carimbo de data/hora.
`project_id`	`STRING`	(Coluna de clustering) ID do projeto.
`project_number`	`INTEGER`	Número do projeto.
`folder_numbers`	`REPEATED INTEGER`	IDs de pastas da Administração de Códigos das Contas do Google (GAIA, na sigla em inglês) em um ancestral do projeto, a partir da pasta de folha mais próxima do projeto. Essa coluna é preenchida apenas em `JOBS_BY_FOLDER`.
`user_email`	`STRING`	(Coluna de clustering) endereço de e-mail ou conta de serviço do usuário que executou o job.
`job_id`	`STRING`	ID do job. Por exemplo, `bquxjob_1234`.
`job_type`	`STRING`	O tipo de job. Pode ser `QUERY`, `LOAD`, `EXTRACT`, `COPY`, ou `null`. O tipo de job `null` indica um job interno, como avaliação da instrução do job de script ou atualização da visualização materializada.
`statement_type`	`STRING`	O tipo de instrução de consulta, se for válido. Por exemplo, `SELECT`, `INSERT`, `UPDATE`, `DELETE`, ou `SCRIPT`. Consulte QueryStatementType para ver uma lista de valores válidos.
`priority`	`STRING`	A prioridade deste job. Os valores válidos incluem `INTERACTIVE` e `BATCH`.
`start_time`	`TIMESTAMP`	Horário de início deste job.
`end_time`	`TIMESTAMP`	Horário de término deste job.
`query`	`STRING`	Texto da consulta SQL. Observação: apenas a visualização `JOBS_BY_PROJECT` tem a coluna `query`.
`state`	`STRING`	Estado em execução do job. Os estados válidos incluem `PENDING`, `RUNNING`, e `DONE`.
`reservation_id`	`STRING`	Nome da principal reserva atribuída a este job, se aplicável. Se o job for executado em um projeto atribuído a uma reserva, ele terá o seguinte formato: `RESERVATION_ADMIN_PROJECT:RESERVATION_LOCATION.RESERVATION_NAME`. Nesta saída: `RESERVATION_ADMIN_PROJECT`: o nome do projeto do Google Cloud que administra a reserva `RESERVATION_LOCATION`: o local da reserva `RESERVATION_NAME`: o nome da reserva
`total_bytes_processed`	`INTEGER`	Total de bytes processados pelo job.
`total_slot_ms`	`INTEGER`	Milissegundos de slot do job ao longo de sua duração.
`error_result`	`RECORD`	Detalhes do erro (se houver), como um `ErrorProto`.
`cache_hit`	`BOOLEAN`	Se os resultados da consulta deste job eram de um cache.
`destination_table`	`RECORD`	Tabela de destino dos resultados (se houver).
`referenced_tables`	`RECORD`	Matriz de tabelas referenciadas pelo job. Preenchido apenas para jobs de consulta.
`labels`	`RECORD`	Matriz de rótulos aplicados ao job como strings `key` e `value`.
`timeline`	`RECORD`	Cronograma de consulta do job. Contém snapshots de execução de consulta.
`job_stages`	`RECORD`	Estágios de consulta do job.
`total_bytes_billed`	`INTEGER`	Se o projeto estiver configurado para usar preços sob demanda, então esse campo conterá o total de bytes cobrados pelo job. Se o projeto estiver configurado para usar preços fixos, então você não será cobrado por bytes, e esse campo será apenas informativo.
`parent_job_id`	`STRING`	ID do job pai (se houver).
`transaction_id`	`STRING`	ID da transação em que este job foi executado, se houver. (Visualização)
`session_info`	`RECORD`	Detalhes sobre a sessão em que este job foi executado, se houver. (Visualização)
`bi_engine_statistics`	`RECORD`	Se o projeto estiver configurado para usar a BI Engine SQL Interface, este campo conterá BiEngineStatistics . Se esse não for seu caso, `NULL`.
`total_modified_partitions`	`INTEGER`	Número total de partições do job modificado. Esse campo é preenchido para jobs `LOAD` e `QUERY`.

Retenção de dados

Essa visualização contém os jobs em execução e o histórico dos últimos 180 dias.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. Se você não especificar um qualificador regional, os metadados serão recuperados de todas as regiões. A tabela a seguir explica o escopo da região dessa visualização:

Ver nome	Escopo do recurso	Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.JOBS_BY_FOLDER	Pasta que contém o projeto especificado	`REGION`

Substitua:

Opcional: PROJECT_ID: o ID do seu projeto do Cloud. Se não for especificado, o projeto padrão será usado.
REGION: qualquer nome da região do conjunto de dados. Por exemplo, region-us.

Ao consultar INFORMATION_SCHEMA.JOBS_BY_FOLDER para encontrar um custo de resumo dos jobs de consulta, exclua o tipo de instrução SCRIPT. Caso contrário, alguns valores poderão ser contados duas vezes. A linha SCRIPT inclui valores de resumo para todos os jobs filhos que foram executados como parte desse job.