Esta página foi traduzida pela API Cloud Translation.

Visualização da RESERVATIONS_TIMELINE

A visualização INFORMATION_SCHEMA.RESERVATIONS_TIMELINE mostra frações de tempo quase em tempo real dos metadados de reserva para cada projeto de administração de reserva a cada minuto.

Atenção: para comparar o uso de slots com a capacidade de slots, é possível combinar as informações de reserva com o cronograma de jobs usando a visualização do cronograma de reservas. No entanto, os resultados do uso desse método podem ser imprecisos. A visualização INFORMATION_SCHEMA.RESERVATIONS_TIMELINE mostra metadados de reserva com granularidade por minuto. Se a reserva mudar mais de uma vez em um minuto, a visualização vai mostrar apenas o valor mais alto desse minuto. Por exemplo, se a reserva de escalonamento automático for escalonada primeiro de 0 a 100 slots e depois de 100 a 200 slots no mesmo minuto, o valor de autoscale.current_slots será 200 para esse minuto. Usando esse método, o valor de slot_capacity pode ser consideravelmente maior que o valor real. Para informações sobre o monitoramento mais granular de slots, consulte Como monitorar o escalonamento automático com o esquema de informações.

Esquema

Quando você consulta as visualizações INFORMATION_SCHEMA.RESERVATIONS_TIMELINE_BY_*, os resultados da consulta contêm uma linha para cada minuto de cada reserva do BigQuery nos últimos 180 dias e uma linha para cada minuto com mudanças de reserva para ocorrências com mais de 180 dias. Cada período começa no intervalo de um minuto cheio e dura exatamente um minuto.

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

Nome da coluna	Tipo de dados	Valor
`autoscale`	`STRUCT`	Informações sobre a capacidade de escalonamento automático da reserva. Os campos incluem: `current_slots`: o número de slots adicionados à reserva pelo escalonamento automático. Observação:depois que os usuários reduzem a `max_slots`, pode levar algum tempo para que ela seja propagada. Por isso, a `current_slots` pode permanecer no valor original e ser maior que a `max_slots` por um breve período (menos de um minuto). `max_slots`: o número máximo de slots que podem ser adicionados à reserva pelo escalonamento automático.
`edition`	`STRING`	A edição associada a esta reserva. Para mais informações sobre edições, consulte Introdução às edições do BigQuery.
`ignore_idle_slots`	`BOOL`	Falso se o compartilhamento de slots estiver ativado. Caso contrário, será verdadeiro.
`labels`	`RECORD`	Matriz de rótulos associados à reserva.
`period_start`	`TIMESTAMP`	Horário de início deste período de um minuto.
`project_id`	`STRING`	ID do projeto de administrador da reserva.
`project_number`	`INTEGER`	Número do projeto.
`reservation_id`	`STRING`	Para mesclar com a tabela jobs_timeline. Ele está no formato project_id:location.reservation_name.
`reservation_name`	`STRING`	O nome da reserva.
`slots_assigned`	`INTEGER`	O número de slots atribuídos a esta reserva.
`slots_max_assigned`	`INTEGER`	A capacidade máxima de slots dessa reserva, incluindo o compartilhamento de slots. Se `ignore_idle_slots` for verdadeiro, é o mesmo que `slots_assigned`. Caso contrário, será o número total de slots em todos os compromissos de capacidade no projeto administrativo.

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 a região e o escopo de recursos dessa visualização:

Nome da visualização	Escopo do recurso	Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE[_BY_PROJECT]	Nível do projeto	`REGION`

Substitua:

Opcional: PROJECT_ID: o ID do seu projeto do Google 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`.

Observação:é necessário usar um qualificador de região para consultar visualizações INFORMATION_SCHEMA. O local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

Exemplos

Exemplo: ver o uso total de slots por minuto.

Para executar a consulta em um projeto diferente do projeto padrão, adicione o ID do projeto no seguinte formato:

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION

. Exemplo, `myproject`.`region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION.

O exemplo a seguir mostra o uso de slots a cada minuto por projetos atribuídos a YOUR_RESERVATION_ID em todos os jobs.

SELECT
  res.period_start,
  SUM(jobs.period_slot_ms) / 1000 / 60 AS period_slot_minutes,
  ANY_VALUE(res.slots_assigned) AS rough_slots_assigned,
  ANY_VALUE(res.slots_max_assigned) AS rough_slots_max_assigned
FROM
  `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION jobs
JOIN
  `region-us`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE res
  ON
    TIMESTAMP_TRUNC(jobs.period_start, MINUTE) = res.period_start
    AND jobs.reservation_id = res.reservation_id
WHERE
  jobs.job_creation_time
    BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
    AND CURRENT_TIMESTAMP()
  AND res.reservation_id = 'YOUR_RESERVATION_ID'
  AND (jobs.statement_type != "SCRIPT" OR jobs.statement_type IS NULL)  -- Avoid duplicate byte counting in parent and children jobs.
GROUP BY
  period_start
ORDER BY
  period_start DESC;

O resultado será semelhante ao seguinte:

+-----------------------+---------------------+---------------------+-------------------------+
|     period_start      | period_slot_minutes | rough_slots_assigned| rough_slots_max_assigned|
+-----------------------+---------------------+---------------------+-------------------------+
|2021-06-08 21:33:00 UTC|       100.000       |         100         |           100           |
|2021-06-08 21:32:00 UTC|        96.753       |         100         |           100           |
|2021-06-08 21:31:00 UTC|        41.668       |         100         |           100           |
+-----------------------+---------------------+---------------------+-------------------------+

Exemplo: uso de slots por reserva.

O exemplo a seguir mostra o uso de slots a cada minuto por cada reserva no último dia.

Atenção: para comparar o uso de slots com a capacidade de slots, é possível combinar as informações de reserva com o cronograma de jobs usando a visualização do cronograma de reservas. No entanto, os resultados desse método podem ser imprecisos. A visualização INFORMATION_SCHEMA.RESERVATIONS_TIMELINE mostra metadados de reserva com granularidade por minuto. Se a reserva mudar mais de uma vez em um minuto, a visualização vai mostrar apenas o valor mais alto desse minuto. Por exemplo, se a reserva de escalonamento automático for escalonada primeiro de 0 a 100 slots e depois de 100 a 200 slots no mesmo minuto, o valor de autoscale.current_slots será 200 para esse minuto. Usando esse método, o valor de slot_capacity pode ser consideravelmente maior que o valor real. Para informações sobre o monitoramento mais granular de slots, consulte Como monitorar o escalonamento automático com o esquema de informações.

SELECT
  res.period_start,
  res.reservation_id,
  SUM(jobs.period_slot_ms) / 1000 / 60 AS period_slot_minutes,
  ANY_VALUE(res.slots_assigned) AS rough_slots_assigned,
  ANY_VALUE(res.slots_max_assigned) AS rough_slots_max_assigned,
FROM
  `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION jobs
JOIN
  `region-us`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE res
  ON TIMESTAMP_TRUNC(jobs.period_start, MINUTE) = res.period_start
     AND jobs.reservation_id = res.reservation_id
WHERE
  jobs.job_creation_time
  BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
  AND CURRENT_TIMESTAMP()
  AND (jobs.statement_type != "SCRIPT" OR jobs.statement_type IS NULL)  -- Avoid duplicate byte counting in parent and children jobs.
GROUP BY
  period_start,
  reservation_id
ORDER BY
  period_start DESC,
  reservation_id;

O resultado será semelhante ao seguinte:

+-----------------------+----------------+---------------------+----------------------+--------------------------+
|     period_start      | reservation_id | period_slot_minutes | rough_slots_assigned | rough_slots_max_assigned |
+-----------------------+----------------+---------------------+----------------------+--------------------------+
|2021-06-08 21:33:00 UTC|     prod01     |       100.000       |             100      |              100         |
|2021-06-08 21:33:00 UTC|     prod02     |       177.201       |             200      |              500         |
|2021-06-08 21:32:00 UTC|     prod01     |        96.753       |             100      |              100         |
|2021-06-08 21:32:00 UTC|     prod02     |       182.329       |             200      |              500         |
+-----------------------+----------------+---------------------+----------------------+--------------------------+