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.
`labels`	`RECORD`	Matriz de etiquetas aplicadas à tarefa como pares de chave-valor.
`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 esta tarefa 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. O valor é `0.0` se a tarefa tiver sido executada com uma reserva que usa o dimensionamento automático e tiver zero espaços de base.
`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.

Para garantir a estabilidade, recomendamos que liste explicitamente as colunas nas suas consultas de esquema de informações em vez de usar um caráter universal (SELECT *). A listagem explícita de colunas impede que as consultas sejam interrompidas se o esquema subjacente for alterado.

Retenção de dados

Esta vista apresenta as tarefas em execução, juntamente com o histórico de tarefas dos últimos 180 dias. Se um projeto for migrado para uma organização (quer não tenha organização ou seja migrado de uma organização diferente), as informações de tarefas anteriores à data de migração não são acessíveis através da vista INFORMATION_SCHEMA.JOBS_TIMELINE_BY_USER, uma vez que a vista só retém dados a partir da data de migração.

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