{"id":30263,"date":"2026-01-06T19:46:17","date_gmt":"2026-01-07T03:46:17","guid":{"rendered":"https:\/\/tdengine.com\/?p=30263"},"modified":"2026-01-28T04:56:18","modified_gmt":"2026-01-28T12:56:18","slug":"tdengine-tsdb-3-4-release-notes","status":"publish","type":"post","link":"https:\/\/tdengine.com\/tdengine-tsdb-3-4-release-notes\/","title":{"rendered":"TDengine TSDB 3.4 Release Notes"},"content":{"rendered":"\n<h2 class=\"gb-text\">About TDengine TSDB<\/h2>\n\n\n\n<p><a href=\"https:\/\/tdengine.com\/tsdb\/\">TDengine TSDB<\/a> securely ingests, stores, analyzes, and distributes petabytes of data per day, generated by billions of sensors and devices. With a built-in AI agent for time-series forecasting and anomaly detection, TDengine TSDB delivers real-time business insights.<\/p>\n\n\n\n<p>Visit our <a href=\"https:\/\/tdengine.com\/downloads\/?product=TDengine+TSDB-Enterprise&amp;version=3.3.7.0\">Download Center<\/a> to obtain TDengine TSDB installation packages and Docker images.<\/p>\n\n\n\n<h2 class=\"gb-text\">What&#8217;s New<\/h2>\n\n\n\n<ul>\n<li>\n<p><strong>(Enterprise only) Security updates:<\/strong> TDengine TSDB now has improved identity authentication, access controls, storage and transmission security, security functions, auditing, and end-to-end encryption. This includes:<\/p>\n\n\n\n<ul>\n<li>\n<p>SASL for data transmission<\/p>\n<\/li>\n\n\n\n<li>\n<p>Full transparent encryption for data storage<\/p>\n<\/li>\n\n\n\n<li>\n<p>Multi-factor authentication (MFA) and login security policies<\/p>\n<\/li>\n\n\n\n<li>\n<p>Role-based access controls (RBAC)<\/p>\n<\/li>\n\n\n\n<li>\n<p>AES and SHA functions<\/p>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>\n<p><strong>(Enterprise only) TDengine taosX HA:<\/strong> You can now implement high availability (HA) for taosX by deploying multiple xnodes. For more information, see <a href=\"https:\/\/docs.tdengine.com\/reference\/taos-sql\/datain\/#xnode-node-management\">XNode Node Management<\/a>.<\/p>\n<\/li>\n\n\n\n<li>\n<p><strong>Virtual tables:<\/strong> Performance is improved for projection queries, aggregation functions, selection functions, and windowed queries involving virtual tables.<\/p>\n<\/li>\n\n\n\n<li>\n<p><strong>Stream processing:<\/strong> Compute latency and resource usage are significantly reduced for streams using event windows.<\/p>\n<\/li>\n\n\n\n<li>\n<p><strong>TDengine TSDB-Explorer SSO:<\/strong> TDengine TSDB-Explorer now supports single sign-on (SSO) using OAuth 2.0 and OpenID Connect (OIDC) 1.0.<\/p>\n<\/li>\n<\/ul>\n\n\n\n<h2 class=\"gb-text\">Compatibility<\/h2>\n\n\n\n<ul>\n<li>\n<p>You can deploy TDengine TSDB-Enterprise 3.4 Server on mainstream Linux distributions and Windows.<\/p>\n<\/li>\n\n\n\n<li>\n<p>You can deploy TDengine TSDB-Enterprise 3.4 Client on mainstream Linux distributions, macOS, and Windows.<\/p>\n<\/li>\n\n\n\n<li>\n<p>You can deploy TDengine TSDB-OSS 3.4 Server on mainstream Linux distributions and macOS.<\/p>\n<\/li>\n\n\n\n<li>\n<p>You can deploy TDengine TSDB-OSS 3.4 Client on mainstream Linux distributions, macOS, and Windows.<\/p>\n<\/li>\n<\/ul>\n\n\n\n<p>You can also run TDengine TSDB in Docker or in Kubernetes. See <a href=\"https:\/\/docs.tdengine.com\/tdengine-reference\/supported-platforms\/\">Supported Platforms<\/a> for details about the compatibility of TDengine TSDB 3.4 with various architectures and operating systems.<\/p>\n\n\n\n<p><strong>Notes:<\/strong><\/p>\n\n\n\n<ul>\n<li>\n<p>You must upgrade existing clients to TDengine TSDB 3.4 before connecting to a TDengine TSDB 3.4 server.<\/p>\n<\/li>\n\n\n\n<li>\n<p>You can no longer connect a TDengine TSDB-OSS Client to a TDengine TSDB-Enterprise Server. If you are running TDengine TSDB-Enterprise Server, you must use TDengine TSDB-Enterprise Clients only.<\/p>\n<\/li>\n<\/ul>\n\n\n\n<h2 class=\"gb-text\">Upgrading to TDengine TSDB 3.4<\/h2>\n\n\n\n<h3 class=\"gb-text\">Upgrading TDengine TSDB-OSS<\/h3>\n\n\n\n<p>You can upgrade TDengine TSDB-OSS to version 3.4 from version 3.0.1.5 or later.<\/p>\n\n\n\n<p>To upgrade TDengine TSDB-OSS, first back up your deployment by making a copy of the TDengine directory. After verifying that your deployment has been backed up, install TDengine TSDB-OSS 3.4 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 TSDB as a cluster, you must shut down and upgrade all nodes in the cluster to TDengine TSDB 3.4. Rolling upgrades are not supported in TDengine TSDB 3.4.<\/p>\n\n\n\n<h3 class=\"gb-text\">Upgrading TDengine TSDB-Enterprise and TDengine Cloud<\/h3>\n\n\n\n<p>Contact your account representative for assistance in upgrading TDengine TSDB-Enterprise or TDengine Cloud.<\/p>\n\n\n\n<p>You can check your current version of TDengine TSDB at any time by running the <code class=\"\" data-line=\"\">SELECT SERVER_VERSION();<\/code> command.<\/p>\n\n\n\n<p><strong>Important:<\/strong><\/p>\n\n\n\n<ul>\n<li>\n<p>If you are using TDengine taosX features other than data sources, <strong>do not upgrade to TDengine TSDB 3.4.<\/strong> Support will be restored in a future version.<\/p>\n<\/li>\n\n\n\n<li>\n<p>If you are using TDengine taosX-Agent, <strong>do not upgrade to TDengine TSDB 3.4.<\/strong> Support will be restored in a future version.<\/p>\n<\/li>\n\n\n\n<li>\n<p>If you are using data sources, you must <strong>delete and re-create all data ingestion tasks<\/strong> after upgrading to TDengine TSDB 3.4. Contact your account representative for a tool to automate this process.<\/p>\n<\/li>\n<\/ul>\n\n\n\n<h2 class=\"gb-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.4.0.0\" data-type=\"link\" data-id=\"https:\/\/github.com\/taosdata\/TDengine\/releases\/tag\/ver-3.3.5.0\" rel=\"noopener\">our GitHub repository<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This document contains the release notes for TDengine TSDB 3.4.<\/p>\n","protected":false},"author":102,"featured_media":30272,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"content-type":"","footnotes":""},"categories":[22],"tags":[],"ppma_author":[181],"class_list":["post-30263","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\/30263","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=30263"}],"version-history":[{"count":6,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/30263\/revisions"}],"predecessor-version":[{"id":30271,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/posts\/30263\/revisions\/30271"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/media\/30272"}],"wp:attachment":[{"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/media?parent=30263"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/categories?post=30263"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/tags?post=30263"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/tdengine.com\/wp-json\/wp\/v2\/ppma_author?post=30263"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}