Todos os produtos
Search
Central de documentação

PolarDB:SHOW COLUMNAR OFFSET

Última atualização: Jun 28, 2026

Consulta o checkpoint de sincronização de dados orientados a colunas de uma instância PolarDB-X.

Observações de uso

Requer a versão 5.4.19-16989811 ou posterior do PolarDB-X.

Sintaxe

SHOW COLUMNAR OFFSET

Exemplo

SHOW COLUMNAR OFFSET;

Saída:

+--------------------+---------------+-----------+---------------------+-------------------------+-------------+
| 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      |
+--------------------+---------------+-----------+---------------------+-------------------------+-------------+

Valores de retorno

Cada linha da saída corresponde a um dos seguintes valores de TYPE: CDC, COLUMNAR_LATENCY, CN_MIN_LATENCY, CN_MAX_LATENCY e CN_PURGE_WATERMARK.

Colunas

Coluna

Descrição

TYPE

Tipo de dados da linha.

BinlogFile

Arquivo de log binário mais recente.

Position

Posição do checkpoint no arquivo de log binário.

TSO

Valor do Timestamp Oracle (TSO). Cada transação no log binário possui um TSO para identificação exclusiva.

TIME

Horário real correspondente ao TSO.

LATENCY(ms)

Latência em milissegundos. O significado varia conforme o tipo de linha — consulte os detalhes abaixo.

Semântica dos tipos de linha

  • **CDC**: Os valores de BinlogFile e Position indicam o checkpoint mais recente da instância primária. O TSO representa o timestamp do checkpoint de log binário para dados sincronizados dos nós Change Data Capture (CDC) para os nós de dados. O campo TIME mostra o horário real desse TSO. A LATENCY corresponde ao tempo que os nós CDC levam para coletar dados de vários nós de dados e gerar um log binário globalmente consistente.

  • **COLUMNAR_LATENCY**: Os valores de BinlogFile e Position apontam o checkpoint de log binário até onde os nós de armazenamento colunar estão sincronizados. O TSO é o timestamp desse checkpoint de sincronização. O campo TIME indica quando o TSO entrou em vigor. A LATENCY resulta da subtração do horário do TSO pelo valor de TIME da linha CDC.

  • **CN_MIN_LATENCY**: Registra a menor latência entre todos os nós de computação.

  • **CN_MAX_LATENCY**: Indica a maior latência observada nos nós de computação.

  • **CN_PURGE_WATERMARK**: Mostra o watermark purgado pelos nós de computação.

Verificação de consistência

Se os valores de BinlogFile e Position da linha CDC estiverem próximos aos da linha COLUMNAR_LATENCY, os dados orientados a colunas apresentam consistência com a instância primária.

Perguntas frequentes

**Por que nenhuma linha COLUMNAR_LATENCY é retornada?**

Isso ocorre quando não há nós de armazenamento colunar disponíveis ou quando esses nós não estão sincronizando dados.

**Por que o checkpoint de log binário da linha CDC difere ligeiramente da linha COLUMNAR_LATENCY?**

Em cenários ociosos, sem atualizações DML, os nós CDC geram três eventos de heartbeat TSO a cada 30 segundos para avançar o checkpoint do log binário. Os nós de armazenamento colunar escutam esses eventos e fazem commit do primeiro evento TSO em intervalos regulares. Esse processamento em lotes periódicos causa uma pequena diferença de checkpoint entre as duas linhas.

**O valor de LATENCY na linha COLUMNAR_LATENCY reflete o atraso real de replicação?**

Utilize esse valor apenas como referência. A LATENCY mede o intervalo entre o TSO mais recente do CDC e o TSO do último commit de log binário pelos nós de armazenamento colunar. Em condições ociosas, os eventos de log binário ocorrem apenas a cada 30 segundos. Consequentemente, a LATENCY pode chegar a 30 segundos mesmo sem atraso real de dados, pois nenhum dado é gravado no log binário durante esse período e os nós de armazenamento colunar realizam commits em lote, o que infla o intervalo de heartbeat.

Como visualizar os arquivos e eventos de log binário da instância primária?

Execute SHOW BINARY LOGS para listar os arquivos de log binário e use SHOW BINLOG EVENTS para inspecionar eventos específicos dentro de um arquivo.