{"id":15148,"date":"2023-08-07T01:28:06","date_gmt":"2023-08-07T08:28:06","guid":{"rendered":"https:\/\/tdengine.com\/?p=15148"},"modified":"2025-03-30T23:26:50","modified_gmt":"2025-03-31T06:26:50","slug":"tdengine-3-1-0-0-release-notes","status":"publish","type":"post","link":"https:\/\/tdengine.com\/tdengine-3-1-0-0-release-notes\/","title":{"rendered":"TDengine 3.1.0.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=\"\">GEOMETRY<\/code> data type:<\/strong> You can now write and query <code class=\"\" data-line=\"\">GEOMETRY<\/code> data as a point, linestring, or polygon. For more information, see <a href=\"https:\/\/docs.tdengine.com\/tdengine-reference\/sql-manual\/data-types\/\">Data Types<\/a> and <a href=\"https:\/\/docs.tdengine.com\/tdengine-reference\/sql-manual\/functions\/#geometry-functions\">Geometry Functions<\/a>.<\/li>\n\n\n\n<li><strong>Improved query performance:<\/strong> The performance of queries that include an <code class=\"\" data-line=\"\">ORDER BY<\/code> clause has been significantly improved. In addition, performance is improved for queries that include a <code class=\"\" data-line=\"\">PARTITION BY tbname<\/code> clause with an <code class=\"\" data-line=\"\">SLIMIT<\/code> clause.<\/li>\n\n\n\n<li><strong>Improved disk failover support:<\/strong> If an I\/O error is detected in a TDengine cluster, the leader node will now automatically fail over to a follower node to ensure that the cluster remains operational.<\/li>\n\n\n\n<li><strong>(TDengine Enterprise only) Load balancing on tier 0 storage:<\/strong> In previous versions, the root directory of a vnode could be located only on the first disk in tier 0. This limitation has been removed and load is now distributed among all tier 0 storage.<\/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.0.0 on mainstream Linux distributions, macOS, and Windows.<\/li>\n\n\n\n<li>You can deploy TDengine OSS Server 3.1.0.0 on mainstream Linux distributions and macOS.<\/li>\n\n\n\n<li>You can deploy TDengine OSS Client 3.1.0.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.0.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.0.0 before connecting to a TDengine 3.1.0.0 server.<\/p>\n\n\n\n<h2 class=\"gb-headline gb-headline-d46ee0ec gb-headline-text\">Upgrading to TDengine 3.1.0.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.0.0 from version 3.0.1.5 or later.<\/p>\n\n\n\n<p><strong>IMPORTANT: Once you upgrade to TDengine 3.1.0.0, you cannot roll back to any previous version of TDengine. Upgrading to 3.1.0.0 will alter your data such that it cannot be read by previous versions.<\/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.0.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 all streams have been removed, install TDengine 3.1.0.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.0.0. Rolling upgrades are not supported in TDengine 3.1.0.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.0.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.0.0\" rel=\"noopener\">our GitHub repository<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This document contains the release notes for TDengine 3.1.0.0.<\/p>\n","protected":false},"author":102,"featured_media":15172,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"content-type":"","footnotes":""},"categories":[22],"tags":[],"ppma_author":[181],"class_list":["post-15148","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\/15148","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=15148"}],"version-history":[{"count":18,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/15148\/revisions"}],"predecessor-version":[{"id":24692,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/15148\/revisions\/24692"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/media\/15172"}],"wp:attachment":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/media?parent=15148"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/categories?post=15148"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/tags?post=15148"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/ppma_author?post=15148"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}