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.