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.