Todos os produtos
Search
Central de documentação

PolarDB:SHOW COLUMNAR STATUS

Última atualização: Jun 28, 2026

Retorna o estado de armazenamento dos In-Memory Column Indexes (IMCIs) no banco de dados atual, incluindo contagem de linhas, quantidade de arquivos por tipo e tamanho total dos objetos.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Um cluster PolarDB executando a versão 5.4.19-16989811 ou posterior

Sintaxe

SHOW COLUMNAR STATUS

Exemplo

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

A saída contém uma linha para cada IMCI. Apenas os IMCIs já criados aparecem nos resultados.

Colunas de saída

Colunas principais

Coluna

Descrição

TSO

Snapshot TSO no momento da coleta das estatísticas. Todas as linhas de um mesmo resultado compartilham o mesmo TSO, que representa o ponto mais recente enviado aos IMCIs. Cada valor de TSO corresponde a uma versão de snapshot, numerada em ordem crescente.

SCHEMA_NAME

Nome do banco de dados.

TABLE_NAME

Nome da tabela.

INDEX_NAME

Nome do IMCI.

ROWS

Quantidade de linhas registradas em todos os arquivos do IMCI. Para verificar se o IMCI está totalmente sincronizado com a tabela primária, execute SHOW COLUMNAR OFFSET.

FILES_SIZE

Tamanho total de todos os objetos do IMCI, em bytes.

Colunas de tipo de arquivo

Os IMCIs seguem um ciclo de vida de armazenamento: linhas novas e atualizadas são gravadas primeiro em objetos de anexação (append objects) e, em seguida, a compactação as converte em arquivos ORC ordenados. As três colunas de tipo de arquivo indicam em qual etapa desse ciclo os dados se encontram no momento da consulta.

Coluna

Descrição

CSV_FILES

Quantidade de objetos de anexação. A compactação converte esses objetos em arquivos ORC quando a contagem atinge o limiar configurado. Até que esse limiar seja atingido — ou enquanto o job de compactação em segundo plano ainda estiver em execução — alguns objetos de anexação permanecem em cada partição.

ORC_FILES

Número de arquivos Optimized Row Columnar (ORC) que armazenam dados do IMCI. Os dados nesses arquivos são organizados pela chave de ordenação. A compactação também realiza ordenação por intervalo entre os arquivos ORC existentes, o que pode alterar essa contagem.

DEL_FILES

Total de arquivos que armazenam dados relacionados a marcadores de linhas excluídas.

Coluna interna

Coluna

Descrição

ID

ID exclusivo atribuído a este IMCI pelo mecanismo de armazenamento colunar. Esse ID possui unicidade global e permite que o mecanismo distinga IMCIs com o mesmo nome. Por exemplo, quando um IMCI é excluído e recriado com o mesmo nome, o nome permanece igual, mas o ID muda. Esta coluna destina-se apenas a uso interno e não afeta as operações do dia a dia.

Perguntas frequentes

Por que as contagens de arquivos mudam ao longo do tempo?

A compactação executa em segundo plano para manter os dados do IMCI ordenados pela chave de ordenação. Ela converte objetos de anexação (CSV_FILES) em arquivos ORC e realiza ordenação por intervalo entre os arquivos ORC existentes. Ambas as operações alteram as contagens de arquivos na saída.

Por que ainda existem objetos de anexação mesmo sem atualizações recentes de dados?

A compactação converte objetos de anexação em arquivos de armazenamento colunar somente após a contagem desses objetos atingir um limiar configurado. Até que esse limiar seja alcançado — ou enquanto o job de compactação em segundo plano ainda estiver em execução — alguns objetos de anexação permanecem. Uma pequena quantidade pode persistir em cada partição independentemente disso.

A contagem de linhas do IMCI não corresponde à tabela primária. O que devo fazer?

Execute SHOW COLUMNAR OFFSET para verificar se o IMCI está sincronizado com a posição mais recente do log binário. Se ele estiver sincronizado, mas a contagem de linhas ainda não corresponder, entre em contato com o suporte técnico.