跳到主要内容

边界限制

一般限制

  • 数据库名最大长度为 32。
  • 表名最大长度为 192,不包括数据库名前缀和分隔符
  • 每行数据最大长度 48KB (注意:数据行内每个 BINARY/NCHAR 类型的列还会额外占用 2 个字节的存储位置)。
  • 列名最大长度为 64,最多允许 4096 列,最少需要 2 列,第一列必须是时间戳。注:从 2.1.7.0 版本(不含)以前最多允许 4096 列
  • 标签名最大长度为 64,最多允许 128 个,至少要有 1 个标签,一个表中标签值的总长度不超过 16KB 。
  • SQL 语句最大长度 1048576 个字符,也可通过客户端配置参数 maxSQLLength 修改,取值范围 65480 ~ 1048576。
  • SELECT 语句的查询结果,最多允许返回 4096 列(语句中的函数调用可能也会占用一些列空间),超限时需要显式指定较少的返回数据列,以避免语句执行报错。注: 2.1.7.0 版本(不含)之前为最多允许 1024 列
  • 库的数目,超级表的数目、表的数目,系统不做限制,仅受系统资源限制。

GROUP BY 的限制

TAOS SQL 支持对标签、TBNAME 进行 GROUP BY 操作,也支持普通列进行 GROUP BY,前提是:仅限一列且该列的唯一值小于 10 万个。注意:group by 不支持 float,double 类型。

IS NOT NULL 的限制

IS NOT NULL 与不为空的表达式适用范围。

IS NOT NULL 支持所有类型的列。不为空的表达式为 <>"",仅对非数值类型的列适用。

ORDER BY 的限制

  • 非超级表只能有一个 order by.
  • 超级表最多两个 order by, 并且第二个必须为 ts.
  • order by tag,必须和 group by tag 一起,并且是同一个 tag。 tbname 和 tag 一样逻辑。 只适用于超级表
  • order by 普通列,必须和 group by 一起或者和 top/bottom 一起,并且是同一个普通列。 适用于超级表和普通表。如果同时存在 group by 和 top/bottom 一起,order by 优先必须和 group by 同一列。
  • order by ts. 适用于超级表和普通表。
  • order by ts 同时含有 group by 时 针对 group 内部用 ts 排序

表(列)名合法性说明

TDengine 中的表(列)名命名规则如下:

只能由字母、数字、下划线构成,数字不能在首位,长度不能超过 192 字节,不区分大小写。这里表名称不包括数据库名的前缀和分隔符。

转义后表(列)名规则:

为了兼容支持更多形式的表(列)名,TDengine 引入新的转义符 "`",可以避免表名与关键词的冲突,同时不受限于上述表名合法性约束检查,转义符不计入表名的长度。 转义后的表(列)名同样受到长度限制要求,且长度计算的时候不计算转义符。使用转义字符以后,不再对转义字符中的内容进行大小写统一。

例如: `aBc` 和 `abc` 是不同的表(列)名,但是 abc 和 aBc 是相同的表(列)名。

备注

转义字符中的内容必须是可打印字符。

支持版本

支持转义符的功能从 2.3.0.1 版本开始。