Vue INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Pour demander des conseils ou obtenir de l'aide pour cette fonctionnalité, envoyez un e-mail à l'adresse bq-recommendations+feedback@google.com.

La vue INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION contient des données sur toutes les recommandations BigQuery pour tous les projets de l'organisation actuelle.

La vue INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION accepte les recommandations suivantes :

Cette vue du schéma n'est disponible que pour les utilisateurs associés à des organisationsTrusted Cloud by S3NS définies.

Autorisations requises

Pour afficher les recommandations avec la vue INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION, vous devez disposer des autorisations requises pour l'outil de recommandation correspondant. La vue INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION ne renvoie que les recommandations que vous êtes autorisé à afficher. Lorsque vous disposez des autorisations nécessaires sur l'organisation, vous pouvez consulter les recommandations pour tous les projets de cette organisation, indépendamment de vos autorisations sur le projet lui-même.

Demandez à votre administrateur de vous accorder l'accès pour afficher les recommandations. Pour connaître les autorisations requises pour chaque outil de recommandation, consultez les pages suivantes :

Schéma

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

Nom de la colonne Type de données Valeur
recommendation_id STRING ID encodé en base64 contenant l'objet RecommendationID et l'outil de recommandation.
recommender STRING Type de recommandation. Par exemple, google.bigquery.table.PartitionClusterRecommender pour les recommandations de partitionnement et de clustering.
subtype STRING Sous-type de la recommandation.
project_id STRING ID du projet
project_number STRING Numéro du projet.
description STRING Description de la recommandation.
last_updated_time TIMESTAMP Ce champ représente la date et l'heure de la dernière création de la recommandation.
target_resources STRING Noms complets des ressources ciblées par cette recommandation.
state STRING État de la recommandation. Pour obtenir la liste des valeurs possibles, consultez État.
primary_impact RECORD L'impact que cette recommandation peut avoir lorsque vous essayez d'optimiser la catégorie principale. Contient les champs suivants :
  • category : catégorie que cette recommandation tente d'optimiser. Pour obtenir la liste des valeurs possibles, consultez Catégorie.
  • cost_projection : cette valeur peut être renseignée si la recommandation est capable de projeter les économies de coûts qu'elle génère. N'est présente que si la catégorie est COST.
  • security_projection : cette valeur peut être présente lorsque la catégorie est SECURITY.
priority STRING Priorité de la recommandation. Pour obtenir la liste des valeurs possibles, consultez Priorité.
associated_insight_ids STRING Nom complets des insights associés à la recommendation. Le nom de l'insight est la représentation encodée en base64 du nom du type d'insight et de l'ID de l'insight. Cela permet d'interroger la vue "Insights".
additional_details RECORD Informations supplémentaires sur la recommandation.
  • overview : aperçu de la recommandation au format JSON. Le contenu de ce champ peut varier en fonction de l'outil de recommandation.
  • state_metadata : métadonnées sur l'état de la recommandation dans des paires clé/valeur.
  • operations : liste des opérations que l'utilisateur peut effectuer sur les ressources cibles. Il contient les champs suivants :
    • action : type d'action que l'utilisateur doit effectuer. Il peut s'agir d'un texte libre défini par le système lors de la génération de la recommandation. Cette information est toujours fournie.
    • resource_type : type de ressource cloud.
    • resource : nom complet de la ressource.
    • path : chemin d'accès du champ cible lié à la ressource.
    • value : valeur du champ du chemin d'accès.

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.RECOMMENDATIONS[_BY_ORGANIZATION] Niveau Projet REGION
Remplacez l'élément suivant :
  • PROJECT_ID (facultatif) : ID de votre projet Trusted 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`.

Exemple

Pour exécuter la requête sur un projet autre que celui par défaut, ajoutez l'ID du projet en respectant le format suivant : 

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION
Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • REGION_NAME : région de votre projet

Par exemple, `myproject`.`region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION.

Afficher les recommandations de vues matérialisées dans l'organisation

L'exemple suivant renvoie des recommandations de vues matérialisées dans l'organisation :

SELECT
  project_id,
  LAX_INT64(additional_details.overview.bytesSavedMonthly) / POW(1024, 3) as est_gb_saved_monthly,
  LAX_INT64(additional_details.overview.slotMsSavedMonthly) / (1000 * 3600) as slot_hours_saved_monthly,
  last_updated_time
FROM
 `region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION
WHERE
  recommender = 'google.bigquery.materializedview.Recommender'
LIMIT 3;

Le résultat ressemble à ce qui suit :

+-------------------------------+----------------------------------------------------------------------+
|          project_id           | est_gb_saved_monthly| slot_hours_saved_monthly |  last_updated_time  |
+-------------------------------+----------------------------------------------------------------------+
| project1                      |   4689.071544663957 |       2682.1816833333337 | 2024-07-01 13:00:31 |
| project2                      |   137.5052567309467 |        9613.139166666666 | 2024-07-01 13:00:31 |
| project3                      |  146.83722260318973 |        7093.014316666667 | 2024-07-01 13:00:31 |
+-------------------------------+----------------------------------------------------------------------+