Vue INFORMATION_SCHEMA.BI_CAPACITY_CHANGES

La vue INFORMATION_SCHEMA.BI_CAPACITY_CHANGES contient l'historique des modifications apportées à la capacité BI Engine. Si vous souhaitez afficher l'état actuel de la réservation BI Engine, consultez la vue INFORMATION_SCHEMA.BI_CAPACITIES.

Autorisation requise

Pour interroger la vue INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.bireservations.get pour les réservations BI Engine.

Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

Schéma

Lorsque vous interrogez la vue INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, les résultats de la requête contiennent une ligne pour chaque mise à jour de la capacité BI Engine, y compris l'état actuel.

La vue INFORMATION_SCHEMA.BI_CAPACITY_CHANGES présente le schéma suivant :

Nom de la colonne	Type de données	Valeur
change_timestamp	TIMESTAMP	Horodatage de la mise à jour actuelle de la capacité BI Engine.
project_id	STRING	ID du projet qui contient la capacité BI Engine.
project_number	INTEGER	Numéro du projet qui contient la capacité BI Engine.
bi_capacity_name	STRING	Nom de l'objet. Actuellement, il ne peut y avoir qu'une seule capacité par projet, de sorte que le nom est toujours default.
size	INTEGER	Mémoire RAM de BI Engine en octets.
user_email	STRING	Adresse e-mail de l'utilisateur ou sujet de la fédération d'identité de personnel ayant effectué la modification. google pour les modifications apportées par Google. NULL si l'adresse e-mail est inconnue.
preferred_tables	REPEATED STRING	Ensemble de tables préférées pour lesquelles cette capacité BI Engine doit être utilisée. Si la valeur est null, la capacité BI Engine est utilisée pour toutes les requêtes du projet en cours.

Syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. L'ID de projet est facultatif. Si aucun ID de projet n'est spécifié, le projet dans lequel la requête est exécutée est utilisé.

Nom de la vue	Champ d'application de la ressource	Champ d'application de la région
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES	Niveau Projet	REGION

Remplacez les éléments suivants :

Facultatif : PROJECT_ID : ID de votre projet Google Cloud. Si non spécifié, le projet par défaut est utilisé.

REGION : tout nom de région d'ensemble de données. Par exemple, `region-us`.

Remarque : Vous devez utiliser un qualificatif de région pour interroger les vues INFORMATION_SCHEMA. L'emplacement d'exécution de la requête doit correspondre à la région de la vue INFORMATION_SCHEMA.

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

Exemples

L'exemple suivant récupère les modifications de capacité BI Engine actuelles à partir de la vue INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Pour exécuter la requête sur un projet autre que celui dans lequel la requête est en cours d'exécution, ajoutez l'ID du projet à la région, en respectant le format suivant : `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

L'exemple suivant récupère toutes les modifications apportées à la capacité BI Engine par un utilisateur avec l'adresse e-mail [e-mail] :

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

Le résultat doit ressembler à ce qui suit.

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  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'exemple suivant permet d'obtenir des modifications de capacité BI Engine pour les sept derniers jours :

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)

Le résultat doit ressembler à ce qui suit.

  +---------------------+--------------+----------------------+-------------------+
  |  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"] |
  +---------------------+--------------+----------------------+-------------------+