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.
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:
|
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 |
- 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
.
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;