TDengine Release Notes

TDengine Team
Share on LinkedIn

About TDengine

TDengine is a next generation data historian purpose-built for Industry 4.0 and Industrial IoT. It enables real-time data ingestion, storage, analysis, and distribution of petabytes per day, generated by billions of sensors and data collectors. With TDengine making big data affordable and accessible, digital transformation has never been easier.

What’s New

  • Support for VARBINARY data type: You can now store variable-length binary data with the VARBINARY data type.

    Note: For historical reasons, the BINARY type can also contain variable-length data. Starting with version, using BINARY to store variable-length data is deprecated. However, existing BINARY columns that contain variable-length data will continue to function as in previous versions.
  • Improved query performance: The performance of aggregate queries that include a PARTITION BY clause with an SLIMIT clause has been significantly improved. In addition, performance is improved for JOIN operations on supertables.
  • Stream processing with multiple replicas: You can now create and run streams in a multi-replica database.
  • (TDengine Enterprise only) supportVnodes modification on the fly: You can now modify the value of the supportVnodes parameter on the fly to specify a maximum number of vnodes without restarting. Note that decreasing the value of supportVnodes will not delete existing vnodes.


  • You can deploy TDengine Enterprise on mainstream Linux distributions, macOS, and Windows.
  • You can deploy TDengine OSS Server on mainstream Linux distributions and macOS.
  • You can deploy TDengine OSS Client on mainstream Linux distributions, macOS, and Windows.

You can also run TDengine in Kubernetes or in Docker containers. See Supported Platforms for details about the compatibility of TDengine with various architectures and operating systems.

Note: You must upgrade existing clients to TDengine before connecting to a TDengine server.

Upgrading to TDengine

Upgrading TDengine Cloud

TDengine Cloud instances will be upgraded automatically, and an account representative will notify you of the next scheduled maintenance window during which your instances will be upgraded. Note that if you manually shut down your instances prior to the maintenance window, those instances will be automatically upgraded to the latest version.

Any TDengine Cloud instances on the legacy Free Plan are automatically upgraded the next time they are shut down. You can manually shut down an instance by opening the Instances tab and clicking the Active slider.

You can check your current version of TDengine at any time by running the SELECT SERVER_VERSION(); command.

Upgrading TDengine OSS and TDengine Enterprise

You can upgrade TDengine OSS and TDengine Enterprise to version from version or later.

IMPORTANT: If you upgrade to TDengine from any version prior to TDengine, you cannot roll back to the previous version. Upgrading to will alter your data such that it cannot be read by versions prior to

To upgrade TDengine OSS or TDengine Enterprise, first back up your deployment by making a copy of the TDengine directory. Next, remove all streams from your deployment. You can re-create your streams after the upgrade process is complete.

IMPORTANT: You must remove all streams before upgrading to TDengine If you upgrade a deployment that contains streams, the upgrade will fail and your deployment will become nonoperational.

After verifying that your deployment has been backed up and that streams have been removed, install TDengine as described in the official documentation. It is not necessary to uninstall TDengine before upgrading.

Note: If you have deployed TDengine as a cluster, you must shut down and upgrade all nodes in the cluster to TDengine Rolling upgrades are not supported in TDengine

If you are running TDengine 2.6 or earlier, contact the TDengine Team for assistance in migrating your deployment to TDengine TDengine Enterprise customers can contact their account representative for support, and all users can join the TDengine Discord server and request help from the team.

Resolved Issues

For a full list of issues resolved in this release, see our GitHub repository.