/table-stats

Row count and size stats for a table.

Syntax

/table-stats <table>

Description

## Overview `/table-stats` returns summary statistics for a table: row count, on-disk size, file count, and the timestamp of the most recent commit. Values come from the catalog's cached stats, which are refreshed on write and on demand. ## Behavior - Catalog-backed; requires control-plane auth. - Does not run `SELECT COUNT(*)` against the table. The numbers are read from the Delta log summary, so the call is cheap even on large tables. - For the full detail card (columns, history, lineage, stats together) use `/describe`. - For the transaction log itself, use `/table-history`.

Examples

/table-stats sales.orders

/table-stats bronze.clicks

Pitfalls

• Stats reflect the most recent committed snapshot visible to the catalog. An in-flight pipeline may make the numbers appear stale until its commit lands.

See Also

• CLI_SLASH_TABLE_HISTORY
• CLI_SLASH_DESCRIBE
• CLI_SLASH_COLUMNS
• CLI_SLASH_HELP
• CLI_SHELL_SLASH_MENU