Utiliser Insights sur les requêtes pour améliorer les performances des requêtes

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette page explique comment utiliser le tableau de bord d'Insights sur les requêtes pour détecter et analyser les problèmes de performances de vos requêtes.

Introduction

Insights sur les requêtes vous aide à détecter, à diagnostiquer et à empêcher les problèmes de performances des requêtes pour les bases de données Cloud SQL. Il offre un système de surveillance intuitif et fournit des informations de diagnostic qui vous aident à identifier la principale cause des problèmes de performances.

Insights sur les requêtes vous aide à améliorer les performances des requêtes Cloud SQL en suivant les étapes ci-dessous :

• Afficher la charge de la base de données pour les requêtes populaires
• Identifier une requête potentiellement problématique

Insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus

Si vous utilisez l'édition Cloud SQL Enterprise Plus, vous pouvez accéder à des fonctionnalités supplémentaires dans les insights sur les requêtes pour effectuer des diagnostics avancés sur les performances des requêtes. En plus des fonctionnalités standards du tableau de bord "Insights sur les requêtes", les insights sur les requêtes de l'édition Cloud SQL Enterprise Plus vous permettent de:

• Capturez un texte de requête plus long, jusqu'à 20 Ko.
• Capturez les plans de requête pour toutes les requêtes exécutées.
• Vous pouvez échantillonner jusqu'à 200 plans de requêtes par minute.
• Conservez les métriques pendant 30 jours.
• Obtenez des recommandations d'index auprès du conseiller d'index.
• Mettre fin à une session ou à une transaction de longue durée dans les requêtes actives.
• Accédez au dépannage assisté par IA (aperçu).

Le tableau suivant compare les exigences fonctionnelles et les fonctionnalités de Query Insights pour l'édition Cloud SQL Enterprise à celles de Query Insights pour l'édition Cloud SQL Enterprise Plus.

Activer les insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus

Pour activer les insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus, sélectionnez Activer les fonctionnalités Enterprise Plus lorsque vous activez les insights sur les requêtes sur votre instance Cloud SQL Enterprise Plus.

Tarifs

Les insights sur les requêtes ne sont pas facturés en plus sur les instances Cloud SQL Enterprise ou Cloud SQL Enterprise Plus.

Exigences de stockage

Les insights sur les requêtes stockent des données de métriques sur l'instance et nécessitent que vous laissiez le paramètre d'augmentation automatique de l'espace de stockage activé. Des frais de stockage applicables s'appliquent.

Avant de commencer

Avant d'utiliser les insights sur les requêtes, procédez comme suit :

1. Ajoutez les rôles et les autorisations requis.
2. Activez l'API Cloud Trace.
3. Si vous utilisez les insights sur les requêtes pour l'édition Cloud SQL Enterprise ou l'édition Cloud SQL Enterprise Plus, assurez-vous que l'option Activer l'augmentation automatique de l'espace de stockage est activée pour l'instance.

Rôles et autorisations requis

Pour utiliser les insights sur les requêtes, vous devez accorder un rôle prédéfini, créer un rôle personnalisé ou fournir un compte utilisateur avec les autorisations Identity and Access Management requises.

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Pour obtenir les autorisations nécessaires pour accéder à l'historique des données d'exécution des requêtes dans le tableau de bord "Insights sur les requêtes", demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet qui héberge l'instance Cloud SQL:

• Lecteur Monitoring Database Insights (roles/databaseinsights.monitoringViewer)
• Lecteur Cloud SQL (roles/cloudsql.viewer)

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour accéder à l'historique des données d'exécution des requêtes dans le tableau de bord "Insights sur les requêtes". Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

• Éditeur Cloud SQL (roles/cloudsql.editor)
• Administrateur Cloud SQL (roles/cloudsql.admin)

Activer l'API Trace

Pour afficher les plans de requête et leurs vues de bout en bout, l'API Trace doit être activée pour votre Google Cloud projet. Ce paramètre permet à votre projetGoogle Cloud de recevoir des données de trace provenant de sources authentifiées, sans frais supplémentaires. Ces données peuvent vous aider à détecter et à diagnostiquer les problèmes de performances sur votre instance.

Pour vérifier que l'API Trace est activée, procédez comme suit :

1. Dans la console Google Cloud , accédez à API et services:

   Accéder aux API et aux services

2. Cliquez sur Activer les API et les services.
3. Dans la barre de recherche, saisissez Trace API.
4. Si l'option API activée est affichée, cette API est activée et vous n'avez rien à faire. Sinon, cliquez sur Activer.

Activer l'augmentation automatique de l'espace de stockage

Si vous utilisez les insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus, assurez-vous que le paramètre d'instance permettant d'activer l'augmentation automatique de l'espace de stockage reste activé. Par défaut, cette option est activée pour les instances Cloud SQL.

Si vous avez précédemment désactivé ce paramètre d'instance et que vous souhaitez activer les insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus, réactivez d'abord les augmentations automatiques de l'espace de stockage. Vous ne pouvez pas désactiver l'augmentation automatique de l'espace de stockage et activer les insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus.

Activer les insights sur les requêtes

Lorsque vous activez Insights sur les requêtes, toutes les autres opérations sont momentanément suspendues. Ces opérations incluent les vérifications de l'état, la journalisation, la surveillance et d'autres opérations sur les instances.

    gcloud sql instances patch INSTANCE_ID \
    --insights-config-query-insights-enabled
  

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled \
--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH \
--query_plans_per_minute=QUERY_PLANS_PER_MINUTE \
--tier=API_TIER_STRING \
--region=REGION
  

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

{
  "settings" : {
     "insightsConfig" : {
       "queryInsightsEnabled" : true,
       "recordClientAddress" : true,
       "queryStringLength" : 1024,
       "queryPlansPerMinute" : 20,
   }
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2025-03-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Les métriques sont généralement disponibles dans Insights sur les requêtes quelques minutes après la fin de la requête.

Afficher le tableau de bord d'Insights sur les requêtes

Le tableau de bord d'Insights sur les requêtes affiche la charge de la requête en fonction des facteurs que vous sélectionnez. La charge de la requête correspond au calcul du travail total pour toutes les requêtes de l'instance au cours de la période sélectionnée. Le tableau de bord fournit une série de filtres qui vous aident à afficher la charge des requêtes.

Pour ouvrir le tableau de bord Insights sur les requêtes, procédez comme suit:

1. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
2. Dans le menu de navigation Cloud SQL, cliquez sur Insights sur les requêtes ou sur Consulter la page "Insights sur les requêtes" pour obtenir des informations plus détaillées sur les requêtes et les performances sur la page Vue d'ensemble de l'instance.

Le tableau de bord Insights sur les requêtes s'ouvre. Selon que vous utilisez les insights sur les requêtes pour l'édition Cloud SQL Enterprise ou l'édition Cloud SQL Enterprise Plus, le tableau de bord "Insights sur les requêtes" affiche les informations suivantes sur votre instance:

• Bases de données: permet de filtrer la charge des requêtes sur une base de données spécifique ou sur toutes les bases de données.
• Période: permet de filtrer la charge des requêtes par période, telle que l'heure, les six heures, le jour, les sept jours, les 30 jours ou une plage personnalisée.
• Graphique de la charge de la base de données: affiche le graphique de la charge des requêtes en fonction des données filtrées.
• Requêtes et Bases de données: permet de filtrer la charge des requêtes en fonction d'une requête ou d'une base de données sélectionnées. Consultez la section Filtrer la charge de la base de données.

Afficher la charge de la base de données pour toutes les requêtes

La charge de la requête de la base de données est une mesure du travail (en secondes du processeur) ayant exécuté les requêtes de la base de données sélectionnée au fil du temps. Chaque requête en cours d'exécution utilise ou attend des ressources du processeur, des ressources d'E/S ou des ressources de verrouillage. La charge des requêtes de la base de données correspond au ratio du temps pris par toutes les requêtes effectuées sur une période donnée par rapport à la durée d'exécution.

Le tableau de bord de premier niveau d'Insights sur les requêtes affiche le graphique Charge de la base de données par temps d'exécution. Les menus déroulants du tableau de bord vous permettent de filtrer le graphique pour toutes les bases de données ou une base de données spécifique.

Les lignes colorées du graphique indiquent la charge de la base de données par temps d'exécution. Examinez le graphique et utilisez les options de filtrage pour explorer les questions suivantes :

• La charge de la requête est-elle élevée ? Le graphique a-t-il connu un pic ou augmenté au fil du temps ? Si vous ne constatez pas de charge élevée, le problème ne concerne pas votre requête.
• Depuis combien de temps la charge est-elle élevée ? Est-elle élevée seulement actuellement ou a-t-elle été élevée depuis longtemps ? Utilisez le sélecteur de plage pour sélectionner différentes périodes afin de déterminer la durée du problème. Effectuez un zoom avant pour afficher une période pendant laquelle les pics de charge de requêtes sont observés. Effectuez un zoom arrière pour afficher jusqu'à une semaine de la chronologie.
• Quelle base de données subit la charge ? Sélectionnez différentes bases de données dans le menu déroulant "Bases de données" pour trouver celles avec les charges les plus élevées.

Filtrer la charge de la base de données

• Toutes les requêtes

• Bases de données

Pour personnaliser le graphique de charge de la base de données, sélectionnez une dimension dans le menu déroulant Charge de la base de données par temps d'exécution.

Afficher les principaux contributeurs à la charge de la base de données

Pour afficher les principaux contributeurs à la charge de la base de données, vous pouvez utiliser le tableau Dimensions principales par charge de la base de données. Le tableau Dimensions principales par charge de la base de données affiche les principaux contributeurs pour la période et la dimension que vous sélectionnez dans le menu déroulant du graphique Charge de la base de données par temps d'exécution. Vous pouvez modifier la période ou la dimension pour afficher les principaux contributeurs pour une autre période ou dimension.

Dans le tableau Dimensions principales par charge de données, vous pouvez sélectionner les onglets suivants.

Filtrer par requêtes

Le tableau Principales requêtes fournit un aperçu des requêtes qui provoquent les charges de requête les plus élevées. Le tableau affiche toutes les requêtes normalisées pour la période et les options sélectionnées dans le tableau de bord d'Insights sur les requêtes. Il trie les requêtes par durée d'exécution totale au cours de la période sélectionnée.

Pour trier le tableau, sélectionnez un en-tête de colonne.

Le tableau affiche les propriétés suivantes :

• Requête: chaîne de requête normalisée. Par défaut, Insights sur les requêtes n'affiche que 1 024 caractères dans la chaîne de requête.
• Base de données: base de données sur laquelle la requête a été exécutée.
• Recommandations: suggestions de recommandations, telles que Créer des index, pour améliorer les performances des requêtes.
• Temps d'exécution moyen (ms): temps moyen d'exécution de la requête.
• Temps d'exécution total (ms): temps total d'exécution de la requête.
• Heures d'appel: nombre de fois que l'application a appelé la requête.
• Lignes renvoyées en moyenne: nombre moyen de lignes renvoyées pour la requête.

Insights sur les requêtes stocke et affiche uniquement les requêtes normalisées.

Examiner les opérations dans un plan de requête échantillonné

Un plan de requête prend un échantillon de votre requête et le divise en opérations individuelles. Il décrit et analyse chaque opération dans la requête.

Le graphique des exemples de plan de requête affiche tous les plans de requête en cours d'exécution à des heures particulières et la durée d'exécution de chaque plan. Vous pouvez modifier la fréquence à laquelle les échantillons de plans de requêtes sont capturés par minute. Consultez la page Activer les insights sur les requêtes.

Par défaut, le panneau de droite affiche les détails de l'exemple de plan de requête le plus long, comme indiqué dans le graphique Exemples de plan de requête. Pour afficher les détails d'un autre exemple de plan de requête, cliquez sur le cercle approprié sur le graphique. Les détails développés montrent un modèle de toutes les opérations du plan de requête.

Chaque opération affiche les lignes renvoyées et, le cas échéant, le coût de l'opération. Utilisez la vue plein écran ou l'onglet De bout en bout pour afficher les statistiques d'exécution estimées pour chaque nœud (opération), ainsi que les statistiques d'exécution d'exécution associées au nœud racine.

Essayez de préciser le problème en examinant les questions suivantes :

1. Quelles sont les ressources utilisées ?
2. Quel est le rapport avec les autres requêtes ?
3. La consommation évolue-t-elle au fil du temps ?

Fonctionnalité "Détails de la requête"

Les détails de la requête peuvent fournir des informations supplémentaires sur une requête spécifique, y compris le temps d'exécution moyen, le nombre d'appels et le nombre moyen de lignes renvoyées. Il peut également vous proposer des recommandations, telles que des index, pour vous aider à améliorer les performances des requêtes.

Les détails de la requête fournissent également les métriques suivantes:

• Exemples de plan de requête: ces exemples aident à expliquer et à analyser votre requête en fournissant une répartition des différentes opérations dans un échantillon de la requête.

  

• Nombre d'exécutions de requêtes au fil du temps: indique le nombre de fois où la requête a été exécutée au cours d'une période donnée. Ce graphique vous aide à mieux comprendre quand une requête est généralement exécutée et peut vous aider à estimer son impact sur les performances de l'instance.

  

• Nombre moyen de lignes renvoyées au fil du temps: indique le nombre moyen de lignes renvoyées par la requête au fil du temps. Ces données peuvent vous aider à établir une corrélation entre les requêtes plus lentes que d'habitude et la quantité accrue de données renvoyées par ces requêtes.

  

• Statistiques d'E/S: affiche les statistiques d'entrée et de sortie de la requête, y compris les filtres suivants :
  • Nombre moyen de lectures logiques
  • Nombre moyen de lectures physiques
  • Nombre moyen de d'écritures logiques

  Vous pouvez utiliser des métriques d'E/S pour vous aider à établir une corrélation entre les requêtes plus lentes que d'habitude et une utilisation plus intensive des E/S ou des modifications des modèles d'E/S.

  Par exemple, si le nombre de lectures logiques a augmenté, cela peut indiquer que la requête a commencé à lire plus de données que d'habitude. Si le nombre de lectures physiques a augmenté, cela peut indiquer que Cloud SQL a commencé à lire plus de données à partir du disque plutôt que du cache de mémoire tampon. Par exemple, il n'y avait peut-être pas assez de mémoire pour mettre en cache toutes les données ou l'instance a commencé à lire trop de données. Si le nombre d'écritures logiques a augmenté, cela peut indiquer que la requête a commencé à écrire plus de données sur le disque de données.

  Voici un exemple de la façon dont cette métrique peut aider à mesurer l'impact de la requête sur les E/S de l'instance.

  

• Statistiques sur la mémoire: affiche les statistiques sur l'utilisation de la mémoire pour la requête, y compris les filtres suivants :
  • Mémoire idéale moyenne
  • Mémoire réservée moyenne
  • Mémoire utilisée moyenne

  Cette métrique peut vous aider à détecter les changements de consommation de mémoire liés à la requête, y compris les exemples suivants:

  • Utilisez cette métrique pour détecter quand Cloud SQL a mal prédit la quantité de mémoire requise pour exécuter la requête et qu'il a peut-être réservé plus de mémoire que celle utilisée par la requête.
  • Utilisez cette métrique pour détecter quand Cloud SQL n'a pas pu allouer suffisamment de mémoire et a réservé une allocation de mémoire plus petite. Dans ce cas, Cloud SQL utilise la base de données tempdb, qui est plus lente que l'utilisation de la mémoire.
  • Utilisez cette métrique avec le nombre d'exécutions de requêtes pour mesurer l'impact de la requête sur la consommation de mémoire de l'instance.
  • Utilisez cette métrique lorsque vous constatez une utilisation ou une pression de la mémoire élevées.

  

• Statistiques sur le temps CPU et le temps d'exécution: affiche une vue combinée des statistiques sur le temps CPU et le temps d'exécution pour la requête. Vous pouvez utiliser la métrique "Temps CPU" pour examiner une utilisation élevée du processeur sur l'instance, y compris les exemples suivants :
  • Vous pouvez utiliser une combinaison de métriques de temps CPU et de nombre d'exécutions pour mesurer l'impact de la requête sur la consommation totale de processeur dans l'instance.
  • Vous pouvez utiliser une combinaison de métriques de temps CPU, de temps d'exécution et de parallélisme pour mesurer le pourcentage de temps pendant lequel la requête attendait des ressources.
  • Vous pouvez utiliser la métrique "Temps d'exécution" pour détecter quand l'exécution d'une requête a pris plus de temps que d'habitude.

  

• Statistiques supplémentaires sur la requête: affiche des statistiques supplémentaires liées à la requête, y compris les filtres suivants :
  • Statistiques de l'environnement d'exécution du langage commun (CLR)
  • Statistiques du columnstore
  • Memory spills
  • Statistiques de parallélisme

  

Désactiver les insights sur les requêtes

gcloud sql instances patch INSTANCE_ID \
  --no-insights-config-query-insights-enabled

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : false } }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Désactiver les insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus

Pour désactiver Insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus, procédez comme suit:

1. Dans la Google Cloud console, accédez à la page Instances Cloud SQL.

   Accéder à la page Instances Cloud SQL

2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
3. Cliquez sur Modifier.
4. Dans la section Personnaliser votre instance, développez Insights sur les requêtes.
5. Décochez la case Activer les fonctionnalités Enterprise Plus.
6. Cliquez sur Enregistrer.

Étape suivante

• Blog sur le lancement: Résoudre plus rapidement les goulots d'étranglement de la base de données grâce aux derniers insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus
• Blog : Boostez vos compétences en dépannage des performances à l'aide de Cloud SQL Insights
• Vidéo : Présentation de Cloud SQL Insights
• Podcast : Cloud SQL Insights
• Atelier de programmation Insights
• Optimisez les cas d'utilisation élevée du processeur.
• Optimisez les cas d'utilisation élevée de la mémoire.