Documentation

Information schema

The underlying query engine for the InfluxDB SQL implementation, DataFusion, provides commands that return metadata related to your data schema. To access this information, use the SHOW TABLES, SHOW COLUMNS, and SHOW ALL commands or query views in the ISO SQL information_schema schema.

In the context of InfluxDB, a measurement is represented as a table. Time, tags, and fields are each represented by columns in a table.

SHOW TABLES

Returns information about tables (measurements) in an InfluxDB bucket.

SHOW TABLES
  • Copy
  • Fill window

You can also query the information_schema.tables view:

SELECT * FROM information_schema.tables
  • Copy
  • Fill window

Example SHOW TABLES output

Measurements are those that use the iox table schema.

table_catalogtable_schematable_nametable_type
publicioxhomeBASE TABLE
publicsystemqueriesBASE TABLE
publicinformation_schematablesVIEW
publicinformation_schemaviewsVIEW
publicinformation_schemacolumnsVIEW
publicinformation_schemadf_settingsVIEW

SHOW COLUMNS

Returns information about the schema of a table (measurement) in an InfluxDB bucket.

SHOW COLUMNS FROM example_table
  • Copy
  • Fill window

You can also query the information_schema.columns view:

SELECT
  table_catalog,
  table_schema,
  table_name,
  column_name,
  data_type,
  is_nullable
FROM information_schema.columns
WHERE table_name = 'example_table'
  • Copy
  • Fill window

Example SHOW COLUMNS output

table_catalogtable_schematable_namecolumn_namedata_typeis_nullable
publicioxhomecoInt64YES
publicioxhomehumFloat64YES
publicioxhomeroomDictionary(Int32, Utf8)YES
publicioxhometempFloat64YES
publicioxhometimeTimestamp(Nanosecond, None)NO

SHOW ALL

Returns the configuration options of the current session.

SHOW ALL
  • Copy
  • Fill window

You can also query the information_schema.df_settings view:

SELECT * FROM information_schema.df_settings
  • Copy
  • Fill window

View SHOW ALL example output


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB 3 Core and Enterprise are now in Beta

InfluxDB 3 Core and Enterprise are now available for beta testing, available under MIT or Apache 2 license.

InfluxDB 3 Core is a high-speed, recent-data engine that collects and processes data in real-time, while persisting it to local disk or object storage. InfluxDB 3 Enterprise is a commercial product that builds on Core’s foundation, adding high availability, read replicas, enhanced security, and data compaction for faster queries. A free tier of InfluxDB 3 Enterprise will also be available for at-home, non-commercial use for hobbyists to get the full historical time series database set of capabilities.

For more information, check out:

InfluxDB Cloud Serverless