Visualização da RESERVATION_CHANGES

A visualização INFORMATION_SCHEMA.RESERVATION_CHANGES contém uma lista quase em tempo real de todas as alterações nas reservas do projeto de administração. Cada linha representa uma mudança em uma única reserva. Para mais informações, consulte Introdução às reservas.

Permissão necessária

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

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Esquema

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

Nome da coluna Tipo de dados Valor
change_timestamp TIMESTAMP Horário em que a alteração ocorreu.
project_id STRING ID do projeto de administração.
project_number INTEGER Número do projeto de administração.
reservation_name STRING Nome de reserva fornecido pelo usuário.
ignore_idle_slots BOOL Se for falso, qualquer consulta que usa essa reserva poderá usar slots ociosos de outros compromissos de capacidade.
action STRING Tipo de evento que ocorreu com a reserva. Pode ser CREATE, UPDATE ou DELETE.
slot_capacity INTEGER Valor de referência da reserva.
user_email STRING Endereço de e-mail do usuário ou usuário da federação de identidade da força de trabalho que fez a alteração. google para alterações feitas pelo Google. NULL se o endereço de e-mail for desconhecido.
target_job_concurrency INTEGER O número desejado de consultas que podem ser executadas simultaneamente, limitado pelos recursos disponíveis. Se for zero, esse valor será calculado automaticamente com base nos recursos disponíveis.
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.
  • 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.
primaryLocation STRING O local atual da réplica principal da reserva. Esse campo é definido apenas para reservas que usam o recurso de recuperação de desastres gerenciada.
secondaryLocation STRING O local atual da réplica secundária da reserva. Esse campo é definido apenas para reservas que usam o recurso de recuperação de desastres gerenciada.
originalPrimaryLocation STRING O local em que a reserva foi criada originalmente.
labels RECORD Matriz de rótulos associados à reserva.
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 a reserva é dimensionada do valor de referência para max_slots. Esse campo é especificado pelos usuários para usar o recurso de previsibilidade de reserva.

Retenção de dados

Essa visualização contém reservas atuais e excluídas que são mantidas por no máximo 41 dias após as quais são removidas da visualização.

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:

Nome da visualização Escopo do recurso Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT] Nível do projeto REGION
Substitua:
  • Opcional: PROJECT_ID: o ID do seu projeto 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`.

Exemplo

O exemplo a seguir obtém o histórico de alterações de uma determinada reserva. Use estas informações para ver a lista de alterações feitas em uma reserva específica, como criar ou excluir a reserva.

SELECT
  *
FROM
  `reservation-admin-project.region-us`.
  INFORMATION_SCHEMA.RESERVATION_CHANGES
WHERE
  reservation_name = "my-reservation"
ORDER BY
  change_timestamp DESC;