Vue INFORMATION_SCHEMA.BI_CAPACITIES

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

Autorisation requise

Pour interroger la vue INFORMATION_SCHEMA.BI_CAPACITIES, 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_CAPACITIES, les résultats de la requête contiennent une ligne avec l'état actuel de la capacité BI Engine.

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

Nom de la colonne Type de données Value
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 défini sur default.
size INTEGER Mémoire RAM de BI Engine en octets.
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.

Champ d'application et 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_CAPACITIES 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. Exemple :region-us

Exemple

-- Returns current state of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITIES;

Examples

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

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

L'exemple suivant montre l'état actuel de BI Engine dans le projet avec l'ID "my-project-id" :

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

Le résultat doit ressembler à ce qui suit.

  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  |  project_id   | project_number | bi_capacity_name |     size     |                                               preferred_tables                                |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  | my-project-id |   123456789000 | default          | 268435456000 | "my-company-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+

L'exemple suivant renvoie la taille de la capacité BI Engine en gigaoctets pour le projet de requête :

SELECT
  project_id,
  size/1024.0/1024.0/1024.0 AS size_gb
FROM `region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

Le résultat doit ressembler à ce qui suit.

  +---------------+---------+
  |  project_id   | size_gb |
  +---------------+---------+
  | my-project-id |  250.0  |
  +---------------+---------+