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

You can also query the information_schema.tables view:

SELECT * FROM information_schema.tables

Example SHOW TABLES output

Measurements are those that use the iox table schema.

table_catalog table_schema table_name table_type
public iox home BASE TABLE
public system queries BASE TABLE
public information_schema tables VIEW
public information_schema views VIEW
public information_schema columns VIEW
public information_schema df_settings VIEW

SHOW COLUMNS

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

SHOW COLUMNS FROM example_table

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'

Example SHOW COLUMNS output

table_catalog table_schema table_name column_name data_type is_nullable
public iox home co Int64 YES
public iox home hum Float64 YES
public iox home room Dictionary(Int32, Utf8) YES
public iox home temp Float64 YES
public iox home time Timestamp(Nanosecond, None) NO

SHOW ALL

Returns the configuration options of the current session.

SHOW ALL

You can also query the information_schema.df_settings view:

SELECT * FROM information_schema.df_settings

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 v3 enhancements and InfluxDB Clustered is now generally available

New capabilities, including faster query performance and management tooling advance the InfluxDB v3 product line. InfluxDB Clustered is now generally available.

InfluxDB v3 performance and features

The InfluxDB v3 product line has seen significant enhancements in query performance and has made new management tooling available. These enhancements include an operational dashboard to monitor the health of your InfluxDB cluster, single sign-on (SSO) support in InfluxDB Cloud Dedicated, and new management APIs for tokens and databases.

Learn about the new v3 enhancements


InfluxDB Clustered general availability

InfluxDB Clustered is now generally available and gives you the power of InfluxDB v3 in your self-managed stack.

Talk to us about InfluxDB Clustered