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
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB 3 Enterprise and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support. Customers using a trial license can email trial@influxdata.com for assistance.