Créer des index ou reconfigurer les paramètres des jointures

Cette page explique comment gérer le nombre de jointures sans index dans le tampon de jointure de votre instance. Cet recommender est appelé Créer des index ou reconfigurer les paramètres de jointure.

Chaque jour, cet outil de recommandation surveille le nombre de jointures sans index dans le tampon de jointure. Le tampon de jointure est un tampon de mémoire par connexion utilisé pour stocker des données lors d'opérations de jointure qui ne peuvent pas utiliser d'index. Si le nombre total de jointures sans index est supérieur à 500 par heure, il est recommandé de créer un index ou d'augmenter la valeur de join_buffer_size.

Pour savoir comment augmenter la valeur de join_buffer_size, consultez la section Autre consommation de mémoire.

Tarifs

L'outil de recommandation Créer des index ou reconfigurer les paramètres de jointure est soumis au Niveau de tarification de l'outil de recommandation Standard.

Avant de commencer

Activez l'API Recommender.

Rôles et autorisations requis

Pour obtenir les autorisations permettant d'afficher et d'utiliser les insights et les recommandations, assurez-vous de disposer des rôles IAM (Identity and Access Management) requis.

Tâche Rôle
Afficher les recommandations recommender.cloudsqlViewer ou cloudsql.admin
Appliquer les recommandations cloudsql.editor ou cloudsql.admin
Pour en savoir plus sur les rôles IAM, consultez la page Documentation de référence sur les rôles de base et prédéfinis pour IAM et la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Répertorier les recommandations

Pour répertorier les recommandations, procédez comme suit :

Console

Procédez comme suit pour lister les recommandations relatives aux performances des instances :

  1. Accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL

  1. Dans la bannière Améliorez l'état de l'instance en analysant les problèmes et en agissant sur la base des recommandations, cliquez sur Développer les détails.

Vous pouvez également procéder comme suit :

  1. Accédez au centre de recommandations. Consultez également la section Rechercher et appliquer des recommandations avec Recommandations.

    Accéder au hub de recommandations

  2. Dans la fiche Toutes les recommandations, cliquez sur Performances.

gcloud

Exécutez la commande gcloud recommender recommendations list comme suit :

gcloud recommender recommendations list \
--project=PROJECT_ID \
--location=LOCATION \
--recommender=google.cloudsql.instance.PerformanceRecommender \
--filter=recommenderSubtype=MYSQL_CREATE_INDEX_OR_RECONFIG_JOIN_BUFFER

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • LOCATION : région où se trouvent vos instances, par exemple us-central1.

API

Appelez la méthode recommendations.list comme suit :

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • LOCATION : région où se trouvent vos instances, par exemple us-central1.

Afficher les insights et les recommandations détaillées

Pour afficher les insights et les recommandations détaillées, procédez comme suit :

Console

Effectuez l'une des opérations suivantes :

  • Sur la page Recommandations de performances, cliquez sur la fiche Recommandations de performances, puis sur Créer des index ou reconfigurer les paramètres des jointures. Le panneau de recommandations s'affiche. Il contient des insights et des recommandations détaillées pour l'instance.

  • Sur la page Instances, cliquez sur Créer des index ou reconfigurer les paramètres des jointures. La liste des instances n'affiche que les instances pour lesquelles la recommandation s'applique.

gcloud

Exécutez la commande gcloud recommender insights list comme suit :


gcloud recommender insights list \
--project=PROJECT_ID \
--location=LOCATION \
--insight-type=google.cloudsql.instance.PerformanceInsight \
--filter=insightSubtype=MYSQL_HIGH_JOINS_WITHOUT_INDEXES

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • LOCATION : région où se trouvent vos instances, par exemple us-central1.

API

Appelez la méthode insights.list comme suit :


GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.cloudsql.instance.PerformanceInsight/insights

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • LOCATION : région où se trouvent vos instances, par exemple us-central1.

Appliquer la recommandation

Procédez comme suit pour mettre en œuvre cette recommandation :

  • Créez des index appropriés dans votre instance pour éviter un grand nombre de jointures sans index.

  • Si vous ne parvenez pas à créer des index pour les jointures, augmentez la valeur de join_buffer_size jusqu'à ce que la recommandation disparaisse. Le tampon de jointure peut être augmenté par session ou de manière globale. Nous vous recommandons d'augmenter le tampon de jointure dans la session contenant un grand nombre de jointures.

    Pour savoir comment augmenter la valeur de join_buffer_size, consultez la section Autre consommation de mémoire.

Étapes suivantes