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