{"id":17702,"date":"2023-09-04T02:43:48","date_gmt":"2023-09-04T09:43:48","guid":{"rendered":"https:\/\/tdengine.com\/?p=17702"},"modified":"2025-03-30T23:26:35","modified_gmt":"2025-03-31T06:26:35","slug":"tdengine-3-1-1-0-release-notes","status":"publish","type":"post","link":"https:\/\/tdengine.com\/tdengine-3-1-1-0-release-notes\/","title":{"rendered":"TDengine 3.1.1.0 Release Notes"},"content":{"rendered":"\n<h2 class=\"gb-headline gb-headline-681b4e77 gb-headline-text\">About TDengine<\/h2>\n\n\n\n<p>TDengine is a <a href=\"https:\/\/tdengine.com\/what-is-a-time-series-database\/\">time-series database<\/a> purpose-built for Industry 4.0 and Industrial IoT. It enables real-time ingestion, storage, analysis, and distribution of petabytes of data per day, generated by billions of sensors and data collectors. With TDengine making big data accessible, valuable, and affordable, digital transformation has never been easier.<\/p>\n\n\n\n<h2 class=\"gb-headline gb-headline-b6ecb6c3 gb-headline-text\">What&#8217;s New<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Support for <code class=\"\" data-line=\"\">VARBINARY<\/code> data type:<\/strong> You can now store variable-length binary data with the <code class=\"\" data-line=\"\">VARBINARY<\/code> data type.<br><br>Note: For historical reasons, the <code class=\"\" data-line=\"\">BINARY<\/code> type can also contain variable-length data. Starting with version 3.1.1.0, using <code class=\"\" data-line=\"\">BINARY<\/code> to store variable-length data is deprecated. However, existing <code class=\"\" data-line=\"\">BINARY<\/code> columns that contain variable-length data will continue to function as in previous versions.<\/li>\n\n\n\n<li><strong>Improved query performance:<\/strong> The performance of aggregate queries that include a <code class=\"\" data-line=\"\">PARTITION BY<\/code> clause with an <code class=\"\" data-line=\"\">SLIMIT<\/code> clause has been significantly improved. In addition, performance is improved for <code class=\"\" data-line=\"\">JOIN<\/code> operations on supertables.<\/li>\n\n\n\n<li><strong>Stream processing with multiple replicas:<\/strong> You can now create and run streams in a multi-replica database.<\/li>\n\n\n\n<li><strong>(TDengine Enterprise only) supportVnodes modification on the fly:<\/strong> You can now modify the value of the <strong>supportVnodes<\/strong> parameter on the fly to specify a maximum number of vnodes without restarting. Note that decreasing the value of <strong>supportVnodes<\/strong> will not delete existing vnodes.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"gb-headline gb-headline-e48f4d8f gb-headline-text\">Compatibility<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You can deploy TDengine Enterprise 3.1.1.0 on mainstream Linux distributions, macOS, and Windows.<\/li>\n\n\n\n<li>You can deploy TDengine OSS Server 3.1.1.0 on mainstream Linux distributions and macOS.<\/li>\n\n\n\n<li>You can deploy TDengine OSS Client 3.1.1.0 on mainstream Linux distributions, macOS, and Windows. <\/li>\n<\/ul>\n\n\n\n<p>You can also run TDengine in Kubernetes or in Docker containers. See <a href=\"https:\/\/docs.tdengine.com\/tdengine-reference\/supported-platforms\/\">Supported Platforms<\/a> for details about the compatibility of TDengine 3.1.1.0 with various architectures and operating systems.<\/p>\n\n\n\n<p><strong>Note:<\/strong> You must upgrade existing clients to TDengine 3.1.1.0 before connecting to a TDengine 3.1.1.0 server.<\/p>\n\n\n\n<h2 class=\"gb-headline gb-headline-d46ee0ec gb-headline-text\">Upgrading to TDengine 3.1.1.0<\/h2>\n\n\n\n<h3 class=\"gb-headline gb-headline-59bc1217 gb-headline-text\">Upgrading TDengine Cloud<\/h3>\n\n\n\n<p>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.<\/p>\n\n\n\n<p>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 <strong>Instances<\/strong> tab and clicking the <strong>Active<\/strong> slider.<\/p>\n\n\n\n<p>You can check your current version of TDengine at any time by running the <code class=\"\" data-line=\"\">SELECT SERVER_VERSION();<\/code> command.<\/p>\n\n\n\n<h3 class=\"gb-headline gb-headline-a8c557d0 gb-headline-text\">Upgrading TDengine OSS and TDengine Enterprise<\/h3>\n\n\n\n<p>You can upgrade TDengine OSS and TDengine Enterprise to version 3.1.1.0 from version 3.0.1.5 or later.<\/p>\n\n\n\n<p><strong>IMPORTANT: If you upgrade to TDengine 3.1.1.0 from any version prior to TDengine 3.1.0.0, you cannot roll back to the previous version. Upgrading to 3.1.1.0 will alter your data such that it cannot be read by versions prior to 3.1.0.0.<\/strong><\/p>\n\n\n\n<p>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.<\/p>\n\n\n\n<p><strong>IMPORTANT: You must remove all streams before upgrading to TDengine 3.1.1.0. If you upgrade a deployment that contains streams, the upgrade will fail and your deployment will become nonoperational.<\/strong><\/p>\n\n\n\n<p>After verifying that your deployment has been backed up and that streams have been removed, install TDengine 3.1.1.0 as described in the <a href=\"https:\/\/docs.tdengine.com\/get-started\/\">official documentation<\/a>. It is not necessary to uninstall TDengine before upgrading.<\/p>\n\n\n\n<p><strong>Note:<\/strong> If you have deployed TDengine as a cluster, you must shut down and upgrade all nodes in the cluster to TDengine 3.1.1.0. Rolling upgrades are not supported in TDengine 3.1.1.0.<\/p>\n\n\n\n<p>If you are running TDengine 2.6 or earlier, contact the TDengine Team for assistance in migrating your deployment to TDengine 3.1.1.0. TDengine Enterprise customers can contact their account representative for support, and all users can join the <a href=\"https:\/\/discord.com\/invite\/VZdSuUg4pS\" rel=\"noopener\">TDengine Discord<\/a> server and request help from the team.<\/p>\n\n\n\n<h2 class=\"gb-headline gb-headline-3c4c8a0e gb-headline-text\">Resolved Issues<\/h2>\n\n\n\n<p>For a full list of issues resolved in this release, see <a href=\"https:\/\/github.com\/taosdata\/TDengine\/releases\/tag\/ver-3.1.1.0\" rel=\"noopener\">our GitHub repository<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This article contains the release notes for TDengine 3.1.1.0.<\/p>\n","protected":false},"author":102,"featured_media":17737,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"content-type":"","footnotes":""},"categories":[22],"tags":[],"ppma_author":[181],"class_list":["post-17702","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-news"],"authors":[{"term_id":181,"user_id":102,"is_guest":0,"slug":"tdengine-team","display_name":"TDengine Team","avatar_url":{"url":"https:\/\/tdengine.com\/wp-content\/uploads\/29.03-01-tdengine.png","url2x":"https:\/\/tdengine.com\/wp-content\/uploads\/29.03-01-tdengine.png"},"1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":""}],"_links":{"self":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/17702","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/users\/102"}],"replies":[{"embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/comments?post=17702"}],"version-history":[{"count":17,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/17702\/revisions"}],"predecessor-version":[{"id":24696,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/17702\/revisions\/24696"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/media\/17737"}],"wp:attachment":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/media?parent=17702"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/categories?post=17702"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/tags?post=17702"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/ppma_author?post=17702"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}