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 : nom de la région de l'ensemble de données. 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 email@mycompanymail.com :

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "email@mycompanymail.com"

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 | email@mycompany.com | ["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 | email@mycompany.com | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | email@mycompany.com | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+

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 | sundar@mycompany.com | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | pichai@mycompany.com | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+