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.

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