Visualização da RESERVATION_CHANGES

A visualização INFORMATION_SCHEMA.RESERVATION_CHANGES contém uma lista de todas as mudanças em reservas no 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.

Schema

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.

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 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 especificar o local para consultar as visualizações INFORMATION_SCHEMA, e o local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

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;