Vue INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Pour demander des conseils ou obtenir de l'aide pour cette fonctionnalité, envoyez un e-mail à l'adresse [e-mail].

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 :

• Recommandations de partitionnement et de clustering
• Recommandations concernant les vues matérialisées
• Recommandations de rôles pour les ensembles de données BigQuery

Cette vue du schéma n'est disponible que pour les utilisateurs associés à des organisations Google Cloud 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 éléments suivants:

• Autorisations de l'outil de recommandation de partitionnement et de clusters
• Autorisations concernant les recommandations de vues matérialisées
• Autorisations concernant les recommandations de rôles pour les ensembles de données

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 indique l'heure à laquelle la recommandation a été créée pour la dernière fois.
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	Impact de cette recommandation 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 la section 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 la section 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. Vous pouvez l'utiliser pour 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 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. Par 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.

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;

Remarque : Les noms des vues INFORMATION_SCHEMA sont sensibles à la casse.

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