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 database.
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 database.
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 and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.