TDengine 参数限制与保留关键字
- 名称命名规则
- 密码合法字符集
- 保留关键字
  - A
  - B
  - C
  - D
  - E
  - F
  - G
  - H
  - I
  - J
  - K
  - L
  - M
  - N
  - O
  - P
  - Q
  - R
  - S
  - T
  - U
  - V
  - W
  - _
- 特殊说明

TDengine 参数限制与保留关键字

名称命名规则

合法字符：英文字符、数字和下划线
允许英文字符或下划线开头，不允许以数字开头
不区分大小写
转义后表（列）名规则：为了兼容支持更多形式的表（列）名，TDengine 引入新的转义符 “`“。可用让表名与关键词不冲突，同时不受限于上述表名称合法性约束检查。转义后的表（列）名同样受到长度限制要求，且长度计算的时候不计算转义符。使用转义字符以后，不再对转义字符中的内容进行大小写统一。

例如：`aBc` 和 `abc` 是不同的表（列）名，但是 abc 和 aBc 是相同的表（列）名。需要注意的是转义字符中的内容必须是可打印字符。支持转义符的功能从 2.3.0.1 版本开始。

密码合法字符集

[a-zA-Z0-9!?$%^&*()_–+={[}]:;@~#|<,>.?/]

去掉了 ‘“`\ (单双引号、撇号、反斜杠、空格)

数据库名：不能包含“.”以及特殊字符，不能超过 32 个字符
表名：不能包含“.”以及特殊字符，与所属数据库名一起，不能超过 192 个字节，每行数据最大长度 48KB
表的列名：不能包含特殊字符，不能超过 64 个字节
数据库名、表名、列名，都不能以数字开头，合法的可用字符集是“英文字符、数字和下划线”
表的列数：不能超过 1024 列，最少需要 2 列，第一列必须是时间戳（从 2.1.7.0 版本开始，改为最多支持 4096 列）
记录的最大长度：包括时间戳 8 字节，不能超过 48KB（每个 BINARY/NCHAR 类型的列还会额外占用 2 个字节的存储位置）
单条 SQL 语句默认最大字符串长度：1048576 字节，但可通过系统配置参数 maxSQLLength 修改，取值范围 65480 ~ 1048576 字节
数据库副本数：不能超过 3
用户名：不能超过 23 个字节
用户密码：不能超过 15 个字节
标签(Tags)数量：不能超过 128 个，可以 0 个
标签的总长度：不能超过 16KB
记录条数：仅受存储空间限制
表的个数：仅受节点个数限制
库的个数：仅受节点个数限制
单个库上虚拟节点个数：不能超过 64 个
库的数目，超级表的数目、表的数目，系统不做限制，仅受系统资源限制
SELECT 语句的查询结果，最多允许返回 1024 列（语句中的函数调用可能也会占用一些列空间），超限时需要显式指定较少的返回数据列，以避免语句执行报错。（从 2.1.7.0 版本开始，改为最多允许 4096 列）

保留关键字

目前 TDengine 有将近 200 个内部保留关键字，这些关键字无论大小写均不可以用作库名、表名、STable 名、数据列名及标签列名等。这些关键字列表如下：

A

ABORT
ACCOUNT
ACCOUNTS
ADD
AFTER
ALL
ALTER
AND
AS
ASC
ATTACH

B

BEFORE
BEGIN
BETWEEN
BIGINT
BINARY
BITAND
BITNOT
BITOR
BLOCKS
BOOL
BY

C

CACHE
CACHELAST
CASCADE
CHANGE
CLUSTER
COLON
COLUMN
COMMA
COMP
COMPACT
CONCAT
CONFLICT
CONNECTION
CONNECTIONS
CONNS
COPY
CREATE
CTIME

D

DATABASE
DATABASES
DAYS
DBS
DEFERRED
DELIMITERS
DESC
DESCRIBE
DETACH
DISTINCT
DIVIDE
DNODE
DNODES
DOT
DOUBLE
DROP

E

END
EQ
EXISTS
EXPLAIN

F

FAIL
FILE
FILL
FLOAT
FOR
FROM
FSYNC

G

GE
GLOB
GRANTS
GROUP
GT

H

HAVING

I

ID
IF
IGNORE
IMMEDIA
IMPORT
IN
INITIAL
INSERT
INSTEAD
INT
INTEGER
INTERVA
INTO
IS
ISNULL

J

JOIN

K

KEEP
KEY
KILL

L

LE
LIKE
LIMIT
LINEAR
LOCAL
LP
LSHIFT
LT

M

MATCH
MAXROWS
MINROWS
MINUS
MNODES
MODIFY
MODULES

N

NE
NONE
NOT
NOTNULL
NOW
NULL

O

OF
OFFSET
OR
ORDER

P

PARTITION
PASS
PLUS
PPS
PRECISION
PREV
PRIVILEGE

Q

QTIME
QUERIE
QUERY
QUORUM

R

RAISE
REM
REPLACE
REPLICA
RESET
RESTRIC
ROW
RP
RSHIFT

S

SCORES
SELECT
SEMI
SESSION
SET
SHOW
SLASH
SLIDING
SLIMIT
SMALLIN
SOFFSET
STable
STableS
STAR
STATE
STATEMEN
STATE_WI
STORAGE
STREAM
STREAMS
STRING
SYNCDB

T

TABLE
TABLES
TAG
TAGS
TBNAME
TIMES
TIMESTAMP
TINYINT
TOPIC
TOPICS
TRIGGER
TSERIES

U

UMINUS
UNION
UNSIGNED
UPDATE
UPLUS
USE
USER
USERS
USING

V

VALUES
VARIABLE
VARIABLES
VGROUPS
VIEW
VNODES

W

WAL
WHERE

_

_C0
_QSTART
_QSTOP
_QDURATION
_WSTART
_WSTOP
_WDURATION

特殊说明

TBNAME

TBNAME 可以视为超级表中一个特殊的标签，代表子表的表名。

获取一个超级表所有的子表名及相关的标签信息：

SELECT TBNAME, location FROM meters;

统计超级表下辖子表数量：

SELECT COUNT(TBNAME) FROM meters;

以上两个查询均只支持在WHERE条件子句中添加针对标签（TAGS）的过滤条件。例如：

taos> SELECT TBNAME, location FROM meters;
             tbname             |            location            |
==================================================================
 d1004                          | California.SanFrancisco        |
 d1003                          | California.SanFrancisco        |
 d1002                          | California.LosAngeles          |
 d1001                          | California.LosAngeles          |
Query OK, 4 row(s) in set (0.000881s)
taos> SELECT COUNT(tbname) FROM meters WHERE groupId > 2;
     count(tbname)     |
========================
                     2 |
Query OK, 1 row(s) in set (0.001091s)

_QSTART/_QSTOP/_QDURATION

表示查询过滤窗口的起始，结束以及持续时间 (从2.6.0.0版本开始支持)

_WSTART/_WSTOP/_WDURATION

窗口切分聚合查询（例如 interval/session window/state window）中表示每个切分窗口的起始，结束以及持续时间（从 2.6.0.0 版本开始支持）

_c0

表示表或超级表的第一列