Visualizzazione ASSIGNMENT_CHANGES

La visualizzazione INFORMATION_SCHEMA.ASSIGNMENT_CHANGES contiene un elenco quasi in tempo reale di tutte le modifiche apportate ai compiti all'interno del progetto di amministrazione. Ogni riga rappresenta una singola modifica a un singolo compito. Per ulteriori informazioni sulla prenotazione, consulta Introduzione alle prenotazioni.

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.ASSIGNMENT_CHANGES, devi disporre dell'autorizzazione bigquery.reservationAssignments.list Identity and Access Management (IAM) per il progetto. Ciascuno dei seguenti ruoli IAM predefiniti include l'autorizzazione obbligatoria:

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

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

La vista INFORMATION_SCHEMA.ASSIGNMENT_CHANGES ha lo schema seguente:

Nome colonna Tipo di dati Valore
change_timestamp TIMESTAMP Ora in cui si è verificata la modifica.
project_id STRING ID del progetto di amministrazione.
project_number INTEGER Numero del progetto di amministrazione.
assignment_id STRING ID che identifica in modo univoco il compito.
reservation_name STRING Nome della prenotazione utilizzata dall'assegnazione.
job_type STRING Il tipo di job che può utilizzare la prenotazione. Può essere PIPELINE o QUERY.
assignee_id STRING ID che identifica in modo univoco la risorsa assegnataria.
assignee_number INTEGER Numero che identifica in modo univoco la risorsa assegnataria.
assignee_type STRING Tipo di risorsa assegnataria. Può essere organization, folder o project.
action STRING Tipo di evento che si è verificato con il compito. Può essere CREATE, UPDATE o DELETE.
user_email STRING Indirizzo email dell'utente o del soggetto della federazione delle identità della forza lavoro che ha apportato la modifica. google per le modifiche apportate da Google. NULL se l'indirizzo email è sconosciuto.
state STRING Stato del compito. Può essere PENDING o ACTIVE.

Conservazione dei dati

Questa visualizzazione contiene i compiti correnti e quelli eliminati che vengono conservati per un massimo di 41 giorni, dopodiché vengono rimossi dalla visualizzazione.

Ambito e sintassi

Le query su questa visualizzazione devono includere un qualificatore regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutte le regioni. La tabella seguente illustra l'ambito della regione per questa visualizzazione:

Nome vista Ambito risorsa Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ASSIGNMENT_CHANGES[_BY_PROJECT] Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo progetto Google Cloud. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Esempio

L'esempio seguente mostra l'utente che ha effettuato l'ultimo aggiornamento di un compito specifico entro una data specificata.

SELECT
  user_email,
  change_timestamp,
  reservation_name,
  assignment_id
FROM
  `region-us`.INFORMATION_SCHEMA.ASSIGNMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
  AND assignment_id = 'assignment_01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

Il risultato è simile al seguente:

+--------------------------------+-----------------------+--------------------+-----------------+
|           user_email           |    change_timestamp   |  reservation_name  |  assignment_id  |
+--------------------------------+-----------------------+--------------------+-----------------+
|  cloudysanfrancisco@gmail.com  |2021-09-30 09:30:00 UTC|   my_reservation   |  assignment_01  |
+--------------------------------+-----------------------+--------------------+-----------------+