Hologres:Get query insights

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Être connecté à une instance Hologres. Pour plus de détails, consultez la rubrique Connexion à une instance

• Les autorisations nécessaires pour interroger les journaux de requêtes lentes. Pour plus de détails, consultez la rubrique Consultation et analyse des journaux de requêtes lentes

Seuils de collecte des données

Query Insight s'appuie sur deux sources de données, chacune soumise à ses propres règles de collecte. Consultez ces seuils avant d'interroger les données afin de savoir quand elles seront disponibles.

Accéder à Query Insight

Métadonnées de requête

Les métadonnées de requête proviennent des journaux de requêtes lentes de Hologres. Dans l'onglet Query Metadata, sélectionnez le Instance Name et l'ID de requête, puis cliquez sur Search.

L'onglet affiche les sections suivantes :

Informations de base

Affiche l'ID de l'instance, la base de données et la version Milvus associées à la requête.

Informations sur la requête

Indique l'utilisateur, le statut d'exécution et le moteur d'exécution utilisé pour la requête, tels qu'ils ont été collectés dans les journaux de requêtes lentes.

Consommation de ressources

Présente l'utilisation des ressources lors de l'exécution de la requête, issue des journaux de requêtes lentes, y compris les fonctions de scan et la consommation CPU.

Autres informations

Affiche des métadonnées supplémentaires issues des journaux de requêtes lentes, telles que l'adresse IP du client.

SQL

Affiche l'instruction SQL complète. Utilisez l'option de formatage pour une meilleure lisibilité, ou copiez directement l'instruction.

Détails de la requête

Si la requête a été exécutée avec des paramètres, cette section affiche les valeurs spécifiques de ces paramètres. Fusionnez les paramètres dans l'instruction SQL si nécessaire.

Plan d'exécution

Affiche le plan d'exécution extrait du champ Plan des journaux de requêtes lentes.

Les plans d'exécution ne sont collectés que pour les requêtes dont la durée d'exécution dépasse 10 s.

Utilisez la fonctionnalité de visualisation du plan pour afficher une représentation graphique de celui-ci. Pour obtenir des informations sur la lecture des plans d'exécution, consultez la rubrique EXPLAIN et EXPLAIN ANALYZE.

Statistiques

Affiche les données de consommation au niveau des opérateurs, issues du champ Statistics des journaux de requêtes lentes, notamment le nombre de lignes analysées et la durée d'exécution de chaque opérateur. Utilisez ces données pour identifier les opérateurs consommant le plus de ressources.

Informations sur les tables en lecture/écriture

Répertorie les tables lues ou écrites par la requête. Cliquez sur l'un des liens pour accéder à une analyse complémentaire :

• Table Metadata : Ouvre la page des métadonnées de table pour la table sélectionnée. Les métadonnées de table proviennent de la table hg_table_info et sont mises à jour en J+1 : les tables créées aujourd'hui ne seront interrogables que demain.

• Table Lock Analysis : Ouvre la page d'analyse des verrous de table pour vérifier si la requête détient des verrous liés au langage de manipulation de données (DML). Cette fonction est utile lorsqu'une requête avec un plan fixe ralentit en raison d'opérations DML concurrentes provenant du moteur d'exécution Hologres (HQE).

Analyse des conflits DDL

Indique si des opérations de langage de définition de données (DDL) ont été effectuées sur les tables impliquées dans la requête, dans la minute précédant ou suivant son exécution. Si la requête a échoué avec le message d'erreur Query is canceled, cette section vous aide à confirmer si un conflit DDL est à l'origine de l'échec.

Messages d'erreur

En cas d'échec de la requête, les détails de l'erreur s'affichent ici. Query Insight sur HoloWeb ajoute automatiquement les causes d'échec et les correctifs suggérés pour vous aider à résoudre les erreurs SQL. Pour une référence des échecs SQL courants, consultez la rubrique FAQ sur les instructions SQL Hologres.

Métadonnées de table

Les métadonnées de table proviennent de la table système hg_table_info, qui est mise à jour une fois chaque matin. Les données sont disponibles en J+1.

Accédez aux métadonnées de table en cliquant sur le lien Table Metadata dans la section Read/Write Table Information des métadonnées de requête, ou saisissez directement le nom de l'instance, la base de données, le schéma et l'heure de collecte des métadonnées.

L'onglet affiche les sections suivantes :

• Informations de base : Nom de la table, indication si la table est partitionnée et détails du partitionnement.

• Informations sur les métadonnées de table : Heure de création de la table, heure de collecte des métadonnées et capacité de stockage.

• Informations sur les propriétés de table : Index définis sur la table, y compris la clé primaire (PK) et la clé de distribution.

• Table Schema Information : Champs, types de champs, possibilité de valeur nulle et valeurs par défaut.

Visualisation du plan

La visualisation du plan affiche le champ Plan des journaux de requêtes lentes sous forme de plan d'exécution graphique.

Les données du plan ne sont collectées que pour les requêtes dont la durée d'exécution dépasse 10 s.

Point de départ : Commencez par vérifier la section Statistics dans les métadonnées de requête. Elle affiche le nombre de lignes et les durées d'exécution au niveau des opérateurs, ce qui vous permet d'identifier les opérateurs les plus gourmands en ressources avant d'explorer le graphe complet du plan.

Pour obtenir des références sur les concepts de plan d'exécution, consultez la rubrique EXPLAIN et EXPLAIN ANALYZE.

Analyse des verrous de table

L'analyse des verrous de table vérifie si la requête a généré des opérations DML (INSERT, UPDATE ou DELETE) dans le moteur d'exécution Hologres (HQE). Un verrou est présent lorsqu'une table fait simultanément l'objet de requêtes de lecture via SDK ou HQE et de requêtes DML via HQE.

L'analyse des verrous de table détecte uniquement les verrous liés aux opérations DML, pas ceux liés aux opérations DDL.

Si une contention de verrous est détectée, évitez d'exécuter simultanément des requêtes SDK et des opérations DML HQE sur la même table.

Dépannage

Étapes suivantes

• Consultation et analyse des journaux de requêtes lentes

• EXPLAIN et EXPLAIN ANALYZE

• FAQ sur les instructions SQL Hologres

• Optimisation des performances d'écriture et de mise à jour