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 determinato compito 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  |
    +--------------------------------+-----------------------+--------------------+-----------------+