Visualizzazione INFORMATION_SCHEMA.BI_CAPACITY_CHANGES

La visualizzazione INFORMATION_SCHEMA.BI_CAPACITY_CHANGES contiene la cronologia delle modifiche alla capacità di BI Engine. Se vuoi visualizzare lo stato attuale della prenotazione del motore BI, consulta la visualizzazione INFORMATION_SCHEMA.BI_CAPACITIES.

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.bireservations.get per le prenotazioni BI Engine.

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

Schema

Quando esegui una query sulla visualizzazione INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, i risultati della query contengono una riga per ogni aggiornamento della capacità di BI Engine, incluso lo stato attuale.

La vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES ha lo schema seguente:

Nome colonna	Tipo di dati	Valore
change_timestamp	TIMESTAMP	Timestamp dell'ultimo aggiornamento della capacità di BI Engine.
project_id	STRING	L'ID progetto del progetto che contiene la capacità di BI Engine.
project_number	INTEGER	Il numero di progetto del progetto che contiene la capacità di BI Engine.
bi_capacity_name	STRING	Il nome dell'oggetto. Può esserci una sola capacità per progetto, quindi il nome è sempre default.
size	INTEGER	RAM di BI Engine in byte.
user_email	STRING	Indirizzo email dell'utente o 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.
preferred_tables	REPEATED STRING	Il set di tabelle preferite per cui deve essere utilizzata questa capacità di BI Engine. Se impostato su null, la capacità di BI Engine viene utilizzata per tutte le query nel progetto corrente.

Sintassi

Le query su questa visualizzazione devono includere un qualificatore di regione. L'ID progetto è facoltativo. Se non viene specificato alcun ID progetto, viene utilizzato il progetto in cui viene eseguita la query.

Nome vista	Ambito risorsa	Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES	Livello progetto	REGION

Sostituisci quanto segue:

• (Facoltativo) PROJECT_ID: l'ID del tuo Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
• REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.
  Nota:devi utilizzare un qualificatore di regione per eseguire query sulle visualizzazioni INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della vista INFORMATION_SCHEMA.

-- Returns the history of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES;

Esempi

L'esempio seguente recupera le modifiche alla capacità di BI Engine dalla visualizzazione INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Per eseguire la query su un progetto diverso da quello in cui viene eseguita, aggiungi l'ID progetto alla regione nel seguente formato: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Il seguente esempio recupera tutte le modifiche apportate alla capacità di BI Engine da un utente con l'indirizzo email [e-mail]:

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "[e-mail]"

Il risultato è simile al seguente:

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  change_timestamp   |  project_id   | project_number | bi_capacity_name |     size     |     user_email      |                                               preferred_tables                         |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  | 2022-06-14 02:22:18 | my-project-id |   123456789000 | default          | 268435456000 | [e-mail] | ["my-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  | 2022-06-08 20:25:51 | my-project-id |   123456789000 | default          | 268435456000 | [e-mail] | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | [e-mail] | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  

L'esempio seguente recupera le modifiche alla capacità di BI Engine degli ultimi sette giorni:

SELECT
  change_timestamp,
  size,
  user_email,
  preferred_tables
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE change_timestamp > TIMESTAMP_SUB(CURRENT_DATE(), INTERVAL 7 DAY)

Il risultato è simile al seguente:

  +---------------------+--------------+----------------------+-------------------+
  |  change_timestamp   |     size     |     user_email       |  preferred_tables |                                                                                    |
  +---------------------+--------------+----------------------+-------------------+
  | 2023-07-08 18:25:09 | 268435456000 | [e-mail] | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | [e-mail] | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+