Tous les produits
Search
Centre de documentation

PolarDB:SHOW COLUMNAR STATUS

Dernière mise à jour :Aug 11, 2026

Cette commande retourne l'état de stockage des index columnaires en mémoire (IMCI) de la base de données actuelle, notamment le nombre de lignes, la répartition des fichiers par type et la taille totale des objets.

Prérequis

Avant de commencer, assurez-vous de disposer :

  • D'un cluster PolarDB exécutant la version 5.4.19-16989811 ou ultérieure.

Syntaxe

SHOW COLUMNAR STATUS

Exemple

SHOW COLUMNAR STATUS;
+---------------------+-------------+------------+--------------------+------+-------+-----------+-----------+-----------+------------+
| TSO                 | SCHEMA_NAME | TABLE_NAME | INDEX_NAME         | ID   | ROWS  | CSV_FILES | ORC_FILES | DEL_FILES | FILES_SIZE |
+---------------------+-------------+------------+--------------------+------+-------+-----------+-----------+-----------+------------+
| 7127209598129274944 | xxx_db      | sbtest1    | s1_col_index_$b243 | 1447 | 10    | 4         | 0         | 0         | 580        |
| 7127209598129274944 | xxx_db      | sbtest2    | s2_col_index_$a378 | 1469 | 81910 | 1         | 1         | 1         | 3565100    |
+---------------------+-------------+------------+--------------------+------+-------+-----------+-----------+-----------+------------+

Le résultat contient une ligne par IMCI. Seuls les IMCI créés apparaissent dans la sortie.

Colonnes de sortie

Colonnes principales

Colonne Description
TSO Snapshot TSO correspondant à la collecte des statistiques. Toutes les lignes d'un même résultat partagent ce TSO, qui représente le point temporel le plus récent soumis aux IMCI. Chaque valeur TSO correspond à une version de snapshot numérotée par ordre croissant.
SCHEMA_NAME Nom de la base de données.
TABLE_NAME Nom de la table.
INDEX_NAME Nom de l'IMCI.
ROWS Nombre total de lignes enregistrées dans tous les fichiers IMCI. Pour vérifier la synchronisation complète entre l'IMCI et la table principale, exécutez SHOW COLUMNAR OFFSET.
FILES_SIZE Taille totale de tous les objets IMCI, en octets.

Colonnes liées aux types de fichiers

Les IMCI suivent un cycle de vie de stockage spécifique : les nouvelles lignes et les mises à jour sont d'abord écrites dans des objets d'ajout, puis le compactage les convertit en fichiers ORC triés. Les trois colonnes relatives aux types de fichiers indiquent la position des données dans ce cycle au moment de la requête.

Colonne Description
CSV_FILES Nombre d'objets d'ajout. Le compactage convertit ces objets en fichiers ORC dès que leur nombre atteint le seuil configuré. Tant que ce seuil n'est pas franchi, ou pendant l'exécution du compactage en arrière-plan, certains objets d'ajout subsistent dans chaque partition.
ORC_FILES Nombre de fichiers Optimized Row Columnar (ORC) contenant les données IMCI. Ces fichiers stockent les données triées selon la clé de tri. Le compactage effectue également un tri par plage entre les fichiers ORC existants, ce qui peut modifier ce compteur.
DEL_FILES Nombre de fichiers contenant les marqueurs de suppression de lignes.

Colonne interne

Colonne Description
ID Identifiant unique attribué à cet IMCI par le moteur de stockage columnaire. Globalement unique, cet ID permet au moteur de distinguer les IMCI portant le même nom. Par exemple, si vous supprimez puis recréez un IMCI sous un nom identique, le nom reste inchangé mais l'ID diffère. Réservée à un usage interne, cette colonne n'a aucune incidence sur les opérations courantes.

FAQ

Pourquoi le nombre de fichiers varie-t-il au fil du temps ?

Un processus de compactage s'exécute en arrière-plan pour maintenir le tri des données IMCI selon la clé de tri. Il convertit les objets d'ajout (CSV_FILES) en fichiers ORC et effectue un tri par plage entre les fichiers ORC existants. Ces deux opérations modifient les compteurs de fichiers affichés.

Pourquoi des objets d'ajout persistent-ils en l'absence de mises à jour récentes ?

Le compactage ne transforme les objets d'ajout en fichiers de stockage columnaire qu'une fois le seuil configuré atteint. Avant d'atteindre ce seuil, ou durant l'exécution du compactage en arrière-plan, des objets d'ajout subsistent. Un petit nombre d'entre eux peut également persister dans chaque partition indépendamment de toute activité.

Le nombre de lignes de l'IMCI ne correspond pas à celui de la table principale. Que faire ?

Exécutez SHOW COLUMNAR OFFSET pour vérifier si l'IMCI est synchronisé avec la dernière position du journal binaire. Si la synchronisation est confirmée mais que l'écart persiste, contactez le support technique.