Visualização da RESERVATIONS_TIMELINE

A visualização INFORMATION_SCHEMA.RESERVATIONS_TIMELINE mostra frações de tempo dos metadados de reserva para cada projeto de administração de reserva a cada minuto em tempo real. Além disso, a matriz per_second_details mostra detalhes do escalonamento automático a cada segundo.

Permissão necessária

Para consultar a visualização INFORMATION_SCHEMA.RESERVATION_TIMELINE, você precisa da permissão bigquery.reservations.list do Identity and Access Management (IAM) no projeto. Cada um dos seguintes papéis predefinidos do IAM inclui a permissão necessária:

  • Administrador de recursos do BigQuery (roles/bigquery.resourceAdmin)
  • Editor de recursos do BigQuery (roles/bigquery.resourceEditor)
  • Leitor de recursos do BigQuery (roles/bigquery.resourceViewer)
  • Usuário do BigQuery (roles/bigquery.user)
  • Administrador do BigQuery (roles/bigquery.admin)

Para mais informações sobre as permissões do BigQuery, consulte Papéis e permissões do BigQuery IAM.

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

Contém 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.
  • 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.
per_second_details STRUCT

Contém informações sobre a capacidade e o uso da reserva a cada segundo. Os campos incluem:

  • start_time: o carimbo de data/hora exato do segundo.
  • autoscale_current_slots: o número de slots adicionados à reserva pelo escalonamento automático neste segundo.
  • autoscale_max_slots: o número máximo de slots que podem ser adicionados à reserva pelo escalonamento automático neste segundo.
  • slots_assigned: o número de slots atribuídos a esta reserva neste segundo. Ela é igual à capacidade de slots de referência de uma reserva.
  • slots_max_assigned: a capacidade máxima de slots dessa reserva, incluindo o compartilhamento de slots neste segundo. Se ignore_idle_slots for verdadeiro, este campo será igual a slots_assigned. Caso contrário, o campo slots_max_assigned será o número total de slots em todos os compromissos de capacidade no projeto de administração.

Se houver mudanças de escalonamento automático ou de reserva durante esse minuto, a matriz será preenchida com 60 linhas. No entanto, para reservas sem escalonamento automático que permanecem inalteradas durante esse minuto, a matriz fica vazia porque, caso contrário, repetiria o mesmo número 60 vezes.
project_id STRING ID do projeto de administração de reservas.
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, será o mesmo que slots_assigned. Caso contrário, será o número total de slots em todos os compromissos de capacidade no projeto de administração.
max_slots INTEGER O número máximo de slots que essa reserva pode usar, incluindo slots de valor de referência (slot_capacity), slots inativos (se ignore_idle_slots for falso) e slots de escalonamento automático. Esse campo é especificado pelos usuários para usar o recurso de previsibilidade de reserva.
scaling_mode STRING O modo de escalonamento da reserva, que determina como ela é escalonada do valor de referência para max_slots. Esse campo é especificado pelos usuários para usar o recurso de previsibilidade de reserva.

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`.

Exemplos

Exemplo: ver o uso total de slots por segundo

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 por segundo de projetos atribuídos a YOUR_RESERVATION_ID em todos os jobs:

SELECT
  s.start_time AS period_start,
  SUM(jobs.period_slot_ms) / 1000 AS period_slot_seconds,
  ANY_VALUE(s.slots_assigned) AS estimated_slots_assigned,
  ANY_VALUE(s.slots_max_assigned) AS estimated_slots_max_assigned
FROM `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION jobs
JOIN `region-us`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE res
    ON jobs.reservation_id = res.reservation_id
 JOIN res.per_second_details s
    ON jobs.period_start = s.start_time
WHERE
  jobs.job_creation_time
    BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
        AND CURRENT_TIMESTAMP()
  AND res.period_start
    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_seconds | estimated_slots_assigned | estimated_slots_max_assigned |
+-----------------------+---------------------+--------------------------+------------------------------+
|2021-06-08 21:33:59 UTC|       100.000       |         100              |           100                |
|2021-06-08 21:33:58 UTC|        96.753       |         100              |           100                |
|2021-06-08 21:33:57 UTC|        41.668       |         100              |           100                |
+-----------------------+---------------------+--------------------------+------------------------------+

Exemplo: uso de slots por reserva.

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

SELECT
  s.start_time AS period_start,
  res.reservation_id,
  SUM(jobs.period_slot_ms) / 1000 AS period_slot_seconds,
  ANY_VALUE(res.slots_assigned) AS estimated_slots_assigned,
  ANY_VALUE(res.slots_max_assigned) AS estimated_slots_max_assigned,
FROM `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION jobs
JOIN `region-us`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE res
  ON jobs.reservation_id = res.reservation_id
JOIN res.per_second_details s
  ON jobs.period_start = s.start_time
WHERE
  jobs.job_creation_time
      BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
          AND CURRENT_TIMESTAMP()
  AND res.period_start
      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_seconds | estimated_slots_assigned | estimated_slots_max_assigned |
+-----------------------+----------------+---------------------+--------------------------+------------------------------+
|2021-06-08 21:33:59 UTC|     prod01     |       100.000       |             100          |              100             |
|2021-06-08 21:33:58 UTC|     prod02     |       177.201       |             200          |              500             |
|2021-06-08 21:32:57 UTC|     prod01     |        96.753       |             100          |              100             |
|2021-06-08 21:32:56 UTC|     prod02     |       182.329       |             200          |              500             |
+-----------------------+----------------+---------------------+--------------------------+------------------------------+