The API Reference uses tags to categorize functions. The tags are Community, Experimental, Toolkit,
and Experimental (Toolkit). This section explains each tag.
This tag indicates that the function is available under , and are not available under the
Apache 2 Edition. For more information, visit our TimescaleDB License comparison sheet.
Early access (TimescaleDB Experimental Schema)
This tag indicates that the function is included in the experimental schema. Do not use experimental
functions in production. Experimental features could include bugs, and are likely to change in future versions. The
experimental schema is used by to develop new features more quickly. If experimental functions are
successful, they can move out of the experimental schema and go into production use.
When upgrading the extension, any database objects that depend on experimental features are dropped and
must be recreated after the upgrade. Experimental features can change between versions and have no guarantees that they
are backwards compatible.
For more information about the experimental schema, read the Timescale blog post.
This tag indicates that the function is included in the extension. Toolkit functions are available under
. For installation instructions, see the installation guide.
This tag is used with the Toolkit tag. It indicates a Toolkit function that is under active development. Do not use
experimental toolkit functions in production. Experimental toolkit functions could include bugs, and are likely to
change in future versions.
These functions might not correctly handle unusual use cases or errors, and they could have poor performance. Updates to
the TimescaleDB extension drop database objects that depend on experimental features like this function. If you use
experimental toolkit functions on Timescale, this function is automatically dropped when the Toolkit extension is
updated. For more information, see the TimescaleDB Toolkit docs.