Tous les produits
Search
Centre de documentation

PolarDB:SHOW COLUMNAR OFFSET

Dernière mise à jour :Aug 11, 2026

Interroge le point de contrôle de synchronisation des données orientées colonne d'une instance PolarDB-X.

Remarques sur l'utilisation

Nécessite PolarDB-X 5.4.19-16989811 ou version ultérieure.

Syntaxe

SHOW COLUMNAR OFFSET

Exemple

SHOW COLUMNAR OFFSET;

Résultat :

+--------------------+---------------+-----------+---------------------+-------------------------+-------------+
| TYPE               | BinlogFile    | Position  | TSO                 | TIME                    | LATENCY(ms) |
+--------------------+---------------+-----------+---------------------+-------------------------+-------------+
| CDC                | binlog.000010 | 223718750 | 7185913700627251264 | 2024-04-16 16:15:34.050 | 218         |
| COLUMNAR_LATENCY   | binlog.000010 | 223718418 | 7185913684139442240 | 2024-04-16 16:15:30.119 | 3931        |
| CN_MIN_LATENCY     | binlog.000010 | 223718418 | 7185913684139442240 | 2024-04-16 16:15:30.119 | 3931        |
| CN_MAX_LATENCY     | binlog.000010 | 223714434 | 7185912425433006144 | 2024-04-16 16:10:30.020 | 304030      |
| CN_PURGE_WATERMARK | binlog.000010 | 223713604 | 7185912174181613632 | 2024-04-16 16:09:30.117 | 363933      |
+--------------------+---------------+-----------+---------------------+-------------------------+-------------+

Valeurs retournées

Chaque ligne du résultat correspond à l'une des valeurs TYPE suivantes : CDC, COLUMNAR_LATENCY, CN_MIN_LATENCY, CN_MAX_LATENCY et CN_PURGE_WATERMARK.

Colonnes

Colonne Description
TYPE Type de données de la ligne.
BinlogFile Fichier journal binaire le plus récent.
Position Position du point de contrôle dans le fichier journal binaire.
TSO Valeur Timestamp Oracle (TSO). Chaque transaction du journal binaire possède un TSO qui l'identifie de manière unique.
TIME Heure réelle correspondant au TSO.
LATENCY(ms) Latence en millisecondes. Sa signification varie selon le type de ligne (voir ci-dessous).

Sémantique des types de lignes

  • **CDC** : Les valeurs BinlogFile et Position indiquent le dernier point de contrôle de l'instance principale. Le TSO correspond à l'horodatage du point de contrôle du journal binaire pour les données synchronisées depuis les nœuds Change Data Capture (CDC) vers les nœuds de données. La valeur TIME représente l'heure réelle de ce TSO. La LATENCY mesure le temps nécessaire aux nœuds CDC pour collecter les données de plusieurs nœuds et produire un journal binaire globalement cohérent.

  • **COLUMNAR_LATENCY** : Les valeurs BinlogFile et Position désignent le point de contrôle du journal binaire jusqu'auquel les nœuds de stockage en colonnes sont synchronisés. Le TSO est l'horodatage de ce point de synchronisation, tandis que TIME indique son moment d'entrée en vigueur. La LATENCY s'obtient en soustrayant l'heure du TSO de la valeur TIME de la ligne CDC.

  • **CN_MIN_LATENCY** : Indique la latence minimale observée sur l'ensemble des nœuds de calcul.

  • **CN_MAX_LATENCY** : Correspond à la latence maximale relevée parmi les nœuds de calcul.

  • **CN_PURGE_WATERMARK** : Indique le watermark purgé par les nœuds de calcul.

Vérification de la cohérence

Si les valeurs BinlogFile et Position de la ligne CDC sont proches de celles de la ligne COLUMNAR_LATENCY, les données orientées colonne sont cohérentes avec l'instance principale.

FAQ

**Pourquoi aucune ligne COLUMNAR_LATENCY n'est-elle retournée ?**

Aucun nœud de stockage en colonnes n'est disponible ou ces nœuds ne synchronisent pas les données.

**Pourquoi le point de contrôle du journal binaire de la ligne CDC diffère-t-il légèrement de celui de la ligne COLUMNAR_LATENCY ?**

En période d'inactivité sans mises à jour DML, les nœuds CDC génèrent trois événements de battement de cœur TSO toutes les 30 secondes afin de faire avancer le point de contrôle du journal binaire. Les nœuds de stockage en colonnes écoutent ces événements et valident le premier événement TSO à intervalles réguliers. Ce traitement par lots périodique entraîne un léger décalage de point de contrôle entre les deux lignes.

**La valeur LATENCY de la ligne COLUMNAR_LATENCY reflète-t-elle fidèlement le retard de réplication ?**

Considérez cette valeur uniquement à titre indicatif. La LATENCY correspond à l'intervalle entre le TSO CDC le plus récent et le TSO du dernier commit de journal binaire effectué par les nœuds de stockage en colonnes. En l'absence d'activité, les événements de journal binaire surviennent seulement toutes les 30 secondes. Par conséquent, la LATENCY peut atteindre 30 secondes même sans retard réel de données, car aucune donnée n'est écrite dans le journal durant cet intervalle et les nœuds de stockage en colonnes valident les événements par lots, ce qui allonge artificiellement l'intervalle de battement de cœur.

Comment consulter les fichiers et événements du journal binaire de l'instance principale ?

Exécutez SHOW BINARY LOGS pour lister les fichiers de journal binaire, puis SHOW BINLOG EVENTS pour examiner les événements spécifiques d'un fichier donné.