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 corrente della prenotazione di BI Engine, consulta la visualizzazione INFORMATION_SCHEMA.BI_CAPACITIES.

Autorizzazione obbligatoria

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

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 corrente.

La vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES ha lo schema seguente:

Nome colonna	Tipo di dati	Valore
change_timestamp	TIMESTAMP	Timestamp dell'aggiornamento corrente della capacità di BI Engine.
project_id	STRING	L'ID del progetto contenente la capacità di BI Engine.
project_number	INTEGER	Il numero del progetto contenente la capacità di BI Engine.
bi_capacity_name	STRING	Il nome dell'oggetto. Al momento può essere presente una sola capacità per progetto, pertanto il nome è sempre default.
size	INTEGER	RAM di BI Engine in byte.
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.
preferred_tables	REPEATED STRING	L'insieme di tabelle preferite per le quali 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 regione. Un 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 progetto Google Cloud. Se non specificato, viene utilizzato il progetto predefinito.

REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Nota: per eseguire query sulle visualizzazioni INFORMATION_SCHEMA, devi utilizzare un qualificatore di regione. La posizione dell'esecuzione della query deve corrispondere alla regione della visualizzazione 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à attuale di BI Engine dalla visualizzazione INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Per eseguire la query in 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.

Nell'esempio seguente vengono visualizzate tutte le modifiche apportate alla capacità del motore BI da un utente con 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 della capacità di BI Engine negli 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"] |
  +---------------------+--------------+----------------------+-------------------+