Esta página foi traduzida pela API Cloud Translation.

Vista JOBS_TIMELINE_BY_USER

A vista INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER contém metadados do BigQuery praticamente em tempo real por intervalo de tempo das tarefas enviadas pelo utilizador atual no projeto atual. Esta vista contém tarefas atualmente em execução e concluídas.

Autorizações necessárias

Para consultar a vista INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER, precisa da autorização de gestão de identidade e de acesso (IAM) bigquery.jobs.list para o projeto. Cada uma das seguintes funções de IAM predefinidas inclui a autorização necessária:

Visualizador de projetos
Utilizador do BigQuery

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

Quando consulta as visualizações INFORMATION_SCHEMA.JOBS_TIMELINE_BY_*, os resultados da consulta contêm uma linha para cada segundo de execução de cada tarefa do BigQuery. Cada período começa num intervalo de um segundo inteiro e dura exatamente um segundo.

A vista INFORMATION_SCHEMA.JOBS_TIMELINE_BY_* tem o seguinte esquema:

Nome da coluna	Tipo de dados	Valor
`period_start`	`TIMESTAMP`	Hora de início deste período.
`period_slot_ms`	`INTEGER`	Milissegundos de intervalo consumidos neste período.
`project_id`	`STRING`	ID do projeto (coluna de agrupamento).
`project_number`	`INTEGER`	Número do projeto.
`user_email`	`STRING`	(Coluna de agrupamento) Endereço de email ou conta de serviço do utilizador que executou a tarefa.
`job_id`	`STRING`	ID da tarefa. Por exemplo, `bquxjob_1234`.
`job_type`	`STRING`	O tipo de trabalho. Pode ser `QUERY`, `LOAD`, `EXTRACT`, `COPY` ou `NULL`. Um valor de `NULL` indica uma tarefa em segundo plano.
`statement_type`	`STRING`	O tipo de declaração de consulta, se for válida. Por exemplo, `SELECT`, `INSERT`, `UPDATE` ou `DELETE`.
`priority`	`STRING`	A prioridade desta tarefa. Os valores válidos incluem `INTERACTIVE` e `BATCH`.
`parent_job_id`	`STRING`	ID da tarefa principal, se existir.
`job_creation_time`	`TIMESTAMP`	(Coluna de partição) Hora da criação desta tarefa. A partição baseia-se na hora UTC desta data/hora.
`job_start_time`	`TIMESTAMP`	Hora de início desta tarefa.
`job_end_time`	`TIMESTAMP`	Hora de fim desta tarefa.
`state`	`STRING`	Estado de execução da tarefa no final deste período. Os estados válidos incluem `PENDING`, `RUNNING` e `DONE`.
`reservation_id`	`STRING`	Nome da reserva principal atribuída a este trabalho no final deste período, se aplicável.
`edition`	`STRING`	A edição associada à reserva atribuída a esta tarefa. Para mais informações sobre as edições, consulte o artigo Introdução às edições do BigQuery.
`total_bytes_billed`	`INTEGER`	Se o projeto estiver configurado para usar preços a pedido, este campo contém o total de bytes faturados para a tarefa. Se o projeto estiver configurado para usar preços de taxa fixa, não lhe é faturado o número de bytes, e este campo é apenas informativo. Este campo só é preenchido para tarefas concluídas e contém o número total de bytes faturados durante toda a duração da tarefa.
`total_bytes_processed`	`INTEGER`	Total de bytes processados pela tarefa. Este campo só é preenchido para tarefas concluídas e contém o número total de bytes processados durante toda a duração da tarefa.
`error_result`	`RECORD`	Detalhes do erro (se existir) como um `ErrorProto.`
`cache_hit`	`BOOLEAN`	Se os resultados da consulta deste trabalho foram provenientes de uma cache.
`period_shuffle_ram_usage_ratio`	`FLOAT`	Rácio de utilização da funcionalidade Shuffle no período selecionado.
`period_estimated_runnable_units`	`INTEGER`	Unidades de trabalho que podem ser agendadas imediatamente neste período. Os slots adicionais para estas unidades de trabalho aceleram a sua consulta, desde que nenhuma outra consulta na reserva precise de slots adicionais.
`transaction_id`	`STRING`	ID da transação em que esta tarefa foi executada, se existir. (Pré-visualizar)

Retenção de dados

Esta vista contém tarefas em execução e o histórico de tarefas dos últimos 180 dias.

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos de todas as regiões. A tabela seguinte explica o âmbito da região e dos recursos para esta vista:

Nome da visualização de propriedade	Âmbito do recurso	Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER	Tarefas enviadas pelo utilizador atual no projeto especificado.	`REGION`

Substitua o seguinte:

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

Nota: tem de usar um qualificador de região para consultar as visualizações INFORMATION_SCHEMA. A localização da execução da consulta tem de corresponder à região da vista INFORMATION_SCHEMA.

Exemplo

A seguinte consulta apresenta o total de milissegundos de slots consumidos por segundo por tarefas enviadas pelo utilizador atual no projeto 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;

O resultado é semelhante ao seguinte:

+---------------------------+---------------------------------+
|  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                        |
+---------------------------+---------------------------------+