Documentation

influxdb3 show system table

The influxdb3 show system table command queries data from a system table.

Usage

influxdb3 show system --database <DATABASE_NAME> table [OPTIONS] <SYSTEM_TABLE>

Arguments

  • SYSTEM_TABLE: the system table to query

Options

OptionDescription
-l--limitMaximum number of tables entries to display (default is 10, 0 indicates no limit)
-o--order-byOrder by the specified columns
-s--selectSelect specific columns from the system table
--formatOutput format (pretty (default), json, jsonl, csv, or parquet)
--tls-caPath to a custom TLS certificate authority (for testing or self-signed certificates)
--tls-no-verifyDisable TLS certificate verification. (Not recommended in production, useful for self-signed certificates)
-h--helpPrint help information
--help-allPrint detailed help information

Examples

In the examples below, replace DATABASE_NAME with the name of the database to operate on.

Query a system table

# Query the parquet_files system table
influxdb3 show system --database 
DATABASE_NAME
table parquet_files

Query specific columns from a system table

# Select specific columns from the parquet_files system table
influxdb3 show system \
  --database 
DATABASE_NAME
\
table \ --select table_name,size_bytes,row_count \ parquet_files

Query a system table and order by a specific column

influxdb3 show system \
  --database 
DATABASE_NAME
\
table \ --order-by size_bytes,row_count \ parquet_files

Query a system table and return JSON-formatted output

influxdb3 show system \
  --database 
DATABASE_NAME
\
table \ --format json \ parquet_files

Was this page helpful?

Thank you for your feedback!


Telegraf Enterprise now in public beta

Get early access to the Telegraf Controller and provide feedback to help shape the future of Telegraf Enterprise.

See the Blog Post

The upcoming Telegraf Enterprise offering is for organizations running Telegraf at scale and is comprised of two key components:

  • Telegraf Controller: A control plane (UI + API) that centralizes Telegraf configuration management and agent health visibility.
  • Telegraf Enterprise Support: Official support for Telegraf Controller and Telegraf plugins.

Join the Telegraf Enterprise beta to get early access to the Telegraf Controller and provide feedback to help shape the future of Telegraf Enterprise.

For more information:

InfluxDB Docker latest tag changing to InfluxDB 3 Core

On May 27, 2026, the latest tag for InfluxDB Docker images will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments.

If using Docker to install and run InfluxDB, the latest tag will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments. For example, if using Docker to run InfluxDB v2, replace the latest version tag with a specific version tag in your Docker pull command–for example:

docker pull influxdb:2