Vista RESERVATION_CHANGES

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

Autorização necessária

Para consultar a vista INFORMATION_SCHEMA.RESERVATION_CHANGES, precisa da autorização de gestão de identidade e de acesso (IAM) no projeto.bigquery.reservations.list Cada uma das seguintes funções de IAM predefinidas inclui a autorização necessária:

• Administrador de recursos do BigQuery (roles/bigquery.resourceAdmin)
• Editor de recursos do BigQuery (roles/bigquery.resourceEditor)
• Visualizador de recursos do BigQuery (roles/bigquery.resourceViewer)
• Utilizador do BigQuery (roles/bigquery.user)
• Administrador do BigQuery (roles/bigquery.admin)

Para mais informações acerca das autorizações do BigQuery, consulte o artigo Funções e autorizações do IAM do BigQuery.

Esquema

A vista INFORMATION_SCHEMA.RESERVATION_CHANGES tem o seguinte esquema:

Nome da coluna	Tipo de dados	Valor
change_timestamp	TIMESTAMP	Hora 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 da reserva facultado pelo utilizador.
ignore_idle_slots	BOOL	Se for falso, qualquer consulta que use esta reserva pode usar espaços ociosos não usados de outros compromissos de capacidade.
action	STRING	Tipo de evento que ocorreu com a reserva. Pode ser CREATE, UPDATE ou DELETE.
slot_capacity	INTEGER	Base da reserva.
user_email	STRING	O endereço de email do utilizador ou o assunto da federação de identidades da força de trabalho que fez a alteração. google para alterações efetuadas pela Google. NULL se o endereço de email for desconhecido.
target_job_concurrency	INTEGER	O número de consultas de destino que podem ser executadas em simultâneo, que é limitado pelos recursos disponíveis. Se for zero, este valor é calculado automaticamente com base nos recursos disponíveis.
autoscale	STRUCT	Informações sobre a capacidade de ajuste automático da reserva. Os campos incluem o seguinte: current_slots: o número de espaços adicionados à reserva pelo ajuste automático. Nota: depois de os utilizadores reduzirem max_slots, pode demorar algum tempo até que o valor seja propagado. Por isso, current_slots pode manter o valor original e ser superior a max_slots durante esse breve período (menos de um minuto). max_slots: o número máximo de espaços que podem ser adicionados à reserva através do ajuste automático da escala.
edition	STRING	A edição associada a esta reserva. Para mais informações sobre as edições, consulte o artigo Introdução às edições do BigQuery.
primary_location	STRING	A localização atual da réplica principal da reserva. Este campo só é definido para reservas que usam a funcionalidade de recuperação de desastres gerida.
secondary_location	STRING	A localização atual da réplica secundária da reserva. Este campo só é definido para reservas que usam a funcionalidade de recuperação de desastres gerida.
original_primary_location	STRING	A localização onde a reserva foi criada originalmente.
labels	RECORD	Matriz de etiquetas associadas à reserva.
max_slots	INTEGER	O número máximo de espaços que esta reserva pode usar, que inclui espaços de base (slot_capacity), espaços inativos (se ignore_idle_slots for falso) e espaços de dimensionamento automático. Este campo é especificado pelos utilizadores para usar a funcionalidade de previsibilidade de reservas.
scaling_mode	STRING	O modo de dimensionamento da reserva, que determina como a reserva é dimensionada a partir da base até max_slots. Este campo é especificado pelos utilizadores para usar a funcionalidade de previsibilidade de reservas.

Retenção de dados

Esta vista contém reservas atuais e reservas eliminadas que são mantidas durante um máximo de 41 dias, após o qual são removidas da vista.

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos de todas as regiões. A tabela seguinte explica o âmbito da região para esta vista:

Nome da visualização de propriedade	Âmbito do recurso	Âmbito da região
[PROJECT_ID].`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT]	Nível do projeto	REGION

Substitua o seguinte:

• Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
• REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.
  Nota: tem de usar um qualificador de região para consultar as visualizações INFORMATION_SCHEMA. A localização da execução da consulta tem de corresponder à região da vista INFORMATION_SCHEMA.

Exemplo

O exemplo seguinte obtém o histórico de alterações de uma determinada reserva. Use estas informações para ver a lista de alterações feitas a uma reserva específica, como a criação ou a eliminação da reserva.

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