From b825035d75a584573013979238d0adf3f996d77b Mon Sep 17 00:00:00 2001 From: Elias Soong Date: Wed, 20 Jan 2021 15:18:28 +0800 Subject: [PATCH] [TD-2671] : Super Table will use keyword "STABLE" since now. --- .../webdocs/markdowndocs/TAOS SQL-ch.md | 31 ++++---- .../webdocs/markdowndocs/administrator-ch.md | 78 +++++++++---------- 2 files changed, 56 insertions(+), 53 deletions(-) diff --git a/documentation20/webdocs/markdowndocs/TAOS SQL-ch.md b/documentation20/webdocs/markdowndocs/TAOS SQL-ch.md index 4563b5b5fc..560ee87dcc 100644 --- a/documentation20/webdocs/markdowndocs/TAOS SQL-ch.md +++ b/documentation20/webdocs/markdowndocs/TAOS SQL-ch.md @@ -213,16 +213,19 @@ TDengine缺省的时间戳是毫秒精度，但通过修改配置参数enableMic 如果表是通过[超级表](../super-table/)创建，更改表结构的操作只能对超级表进行。同时针对超级表的结构更改对所有通过该结构创建的表生效。对于不是通过超级表创建的表，可以直接修改表结构 ## 超级表STable管理 + +注意：在 2.0.15 以前的版本中，并不支持 STABLE 保留字，而是写作 TABLE。也即，在本节后文的指令说明中，CREATE、DROP、ALTER 三个指令在老版本中保留字需写作 TABLE 而不是 STABLE。 + - **创建超级表** ```mysql - CREATE TABLE [IF NOT EXISTS] stb_name (timestamp_field_name TIMESTAMP, field1_name data_type1 [, field2_name data_type2 ...]) TAGS (tag1_name tag_type1, tag2_name tag_type2 [, tag3_name tag_type3]); + CREATE STABLE [IF NOT EXISTS] stb_name (timestamp_field_name TIMESTAMP, field1_name data_type1 [, field2_name data_type2 ...]) TAGS (tag1_name tag_type1, tag2_name tag_type2 [, tag3_name tag_type3]); ``` - 创建STable, 与创建表的SQL语法相似，但需指定TAGS字段的名称和类型 + 创建 STable，与创建表的 SQL 语法相似，但需指定 TAGS 字段的名称和类型 说明： - 1) TAGS 列的数据类型不能是timestamp类型； + 1) TAGS 列的数据类型不能是 timestamp 类型； 2) TAGS 列名不能与其他列名相同； @@ -233,16 +236,16 @@ TDengine缺省的时间戳是毫秒精度，但通过修改配置参数enableMic - **删除超级表** ```mysql - DROP TABLE [IF EXISTS] stb_name; + DROP STABLE [IF EXISTS] stb_name; ``` - 删除STable会自动删除通过STable创建的子表。 + 删除 STable 会自动删除通过 STable 创建的子表。 - **显示当前数据库下的所有超级表信息** ```mysql SHOW STABLES [LIKE tb_name_wildcar]; ``` - 查看数据库内全部STable，及其相关信息，包括STable的名称、创建时间、列数量、标签（TAG）数量、通过该STable建表的数量。 + 查看数据库内全部 STable，及其相关信息，包括 STable 的名称、创建时间、列数量、标签（TAG）数量、通过该 STable 建表的数量。 - **获取超级表的结构信息** @@ -253,43 +256,43 @@ TDengine缺省的时间戳是毫秒精度，但通过修改配置参数enableMic - **超级表增加列** ```mysql - ALTER TABLE stb_name ADD COLUMN field_name data_type; + ALTER STABLE stb_name ADD COLUMN field_name data_type; ``` - **超级表删除列** ```mysql - ALTER TABLE stb_name DROP COLUMN field_name; + ALTER STABLE stb_name DROP COLUMN field_name; ``` ## 超级表 STable 中 TAG 管理 - **添加标签** ```mysql - ALTER TABLE stb_name ADD TAG new_tag_name tag_type; + ALTER STABLE stb_name ADD TAG new_tag_name tag_type; ``` - 为STable增加一个新的标签，并指定新标签的类型。标签总数不能超过128个，总长度不超过16k个字符。 + 为 STable 增加一个新的标签，并指定新标签的类型。标签总数不能超过 128 个，总长度不超过 16k 个字符。 - **删除标签** ```mysql - ALTER TABLE stb_name DROP TAG tag_name; + ALTER STABLE stb_name DROP TAG tag_name; ``` 删除超级表的一个标签，从超级表删除某个标签后，该超级表下的所有子表也会自动删除该标签。 - **修改标签名** ```mysql - ALTER TABLE stb_name CHANGE TAG old_tag_name new_tag_name; + ALTER STABLE stb_name CHANGE TAG old_tag_name new_tag_name; ``` 修改超级表的标签名，从超级表修改某个标签名后，该超级表下的所有子表也会自动更新该标签名。 - **修改子表标签值** ```mysql - ALTER TABLE tb_name SET TAG tag_name=new_tag_value; + ALTER STABLE tb_name SET TAG tag_name=new_tag_value; ``` - 说明：除了更新标签的值的操作是针对子表进行，其他所有的标签操作（添加标签、删除标签等）均只能作用于STable，不能对单个子表操作。对STable添加标签以后，依托于该STable建立的所有表将自动增加了一个标签，所有新增标签的默认值都是NULL。 + 说明：除了更新标签的值的操作是针对子表进行，其他所有的标签操作（添加标签、删除标签等）均只能作用于 STable，不能对单个子表操作。对 STable 添加标签以后，依托于该 STable 建立的所有表将自动增加了一个标签，所有新增标签的默认值都是 NULL。 ## 数据写入 diff --git a/documentation20/webdocs/markdowndocs/administrator-ch.md b/documentation20/webdocs/markdowndocs/administrator-ch.md index 9eee5b2b69..7f477f6757 100644 --- a/documentation20/webdocs/markdowndocs/administrator-ch.md +++ b/documentation20/webdocs/markdowndocs/administrator-ch.md @@ -12,7 +12,7 @@ Memory Size = maxVgroupsPerDb * (blocks * cache + 10Mb) + numOfTables * (tagSizePerTable + 0.5Kb) ``` -示例：假设是4核机器，cache是缺省大小16M, blocks是缺省值6，假设有10万张表，标签总长度是256字节，则总的内存需求为：4\*(16\*6+10) + 100000*(0.25+0.5)/1000 = 499M。 +示例：假设是4核机器，cache是缺省大小16M, blocks是缺省值6，假设有10万张表，标签总长度是256字节，则总的内存需求为：4\*(16\*6+10) + 100000\*(0.25+0.5)/1000 = 499M。 实际运行的系统往往会根据数据特点的不同，将数据存放在不同的DB里。因此做规划时，也需要考虑。 @@ -35,7 +35,7 @@ TDengine相对于通用数据库，有超高的压缩比，在绝大多数场景 Raw DataSize = numOfTables * rowSizePerTable * rowsPerTable ``` -示例：1000万台智能电表，每台电表每15分钟采集一次数据，每次采集的数据128字节，那么一年的原始数据量是：10000000\*128\*24\*60/15*365 = 44.8512T。TDengine大概需要消耗44.851/5=8.97024T空间。 +示例：1000万台智能电表，每台电表每15分钟采集一次数据，每次采集的数据128字节，那么一年的原始数据量是：10000000\*128\*24\*60/15\*365 = 44.8512T。TDengine大概需要消耗44.851/5=8.97024T空间。 用户可以通过参数keep，设置数据在磁盘中的最大保存时长。为进一步减少存储成本，TDengine还提供多级存储，最冷的数据可以存放在最廉价的存储介质上，应用的访问不用做任何调整，只是读取速度降低了。 @@ -181,7 +181,7 @@ taos -C 或 taos --dump-config 客户端的输入的字符均采用操作系统当前默认的编码格式，在Linux系统上多为UTF-8，部分中文系统编码则可能是GB18030或GBK等。在docker环境中默认的编码是POSIX。在中文版Windows系统中，编码则是CP936。客户端需要确保正确设置自己所使用的字符集，即客户端运行的操作系统当前编码字符集，才能保证nchar中的数据正确转换为UCS4-LE编码格式。 - 在 Linux 中 locale 的命名规则为: <语言>_<地区>.<字符集编码> 如：zh_CN.UTF-8，zh代表中文，CN代表大陆地区，UTF-8表示字符集。字符集编码为客户端正确解析本地字符串提供编码转换的说明。Linux系统与 Mac OSX 系统可以通过设置locale来确定系统的字符编码，由于Windows使用的locale中不是POSIX标准的locale格式，因此在Windows下需要采用另一个配置参数charset来指定字符编码。在Linux 系统中也可以使用charset来指定字符编码。 + 在 Linux 中 locale 的命名规则为: <语言>\_<地区>.<字符集编码> 如：zh_CN.UTF-8，zh代表中文，CN代表大陆地区，UTF-8表示字符集。字符集编码为客户端正确解析本地字符串提供编码转换的说明。Linux系统与 Mac OSX 系统可以通过设置locale来确定系统的字符编码，由于Windows使用的locale中不是POSIX标准的locale格式，因此在Windows下需要采用另一个配置参数charset来指定字符编码。在Linux 系统中也可以使用charset来指定字符编码。 - charset @@ -452,39 +452,39 @@ TDengine的所有可执行文件默认存放在 _/usr/local/taos/bin_ 目录下 | 关键字列表 | | | | | | ---------- | ----------- | ------------ | ---------- | --------- | -| ABLOCKS | CONNECTION | GT | MINUS | SHOW | -| ABORT | CONNECTIONS | ID | MNODES | SLASH | -| ACCOUNT | COPY | IF | MODULES | SLIDING | -| ACCOUNTS | COUNT | IGNORE | NCHAR | SMALLINT | -| ADD | CREATE | IMMEDIATE | NE | SPREAD | -| AFTER | CTIME | IMPORT | NONE | STAR | -| ALL | DATABASE | IN | NOT | STATEMENT | -| ALTER | DATABASES | INITIALLY | NOTNULL | STDDEV | -| AND | DAYS | INSERT | NOW | STREAM | -| AS | DEFERRED | INSTEAD | OF | STREAMS | -| ASC | DELIMITERS | INTEGER | OFFSET | STRING | -| ATTACH | DESC | INTERVAL | OR | SUM | -| AVG | DESCRIBE | INTO | ORDER | TABLE | -| BEFORE | DETACH | IP | PASS | TABLES | -| BEGIN | DIFF | IS | PERCENTILE | TAG | -| BETWEEN | DIVIDE | ISNULL | PLUS | TAGS | -| BIGINT | DNODE | JOIN | PRAGMA | TBLOCKS | -| BINARY | DNODES | KEEP | PREV | TBNAME | -| BITAND | DOT | KEY | PRIVILEGE | TIMES | -| BITNOT | DOUBLE | KILL | QUERIES | TIMESTAMP | -| BITOR | DROP | LAST | QUERY | TINYINT | -| BOOL | EACH | LE | RAISE | TOP | -| BOTTOM | END | LEASTSQUARES | REM | TRIGGER | -| BY | EQ | LIKE | REPLACE | UMINUS | -| CACHE | EXISTS | LIMIT | REPLICA | UPLUS | -| CASCADE | EXPLAIN | LINEAR | RESET | USE | -| CHANGE | FAIL | LOCAL | RESTRICT | USER | -| CLOG | FILL | LP | ROW | USERS | -| CLUSTER | FIRST | LSHIFT | ROWS | USING | -| COLON | FLOAT | LT | RP | VALUES | -| COLUMN | FOR | MATCH | RSHIFT | VARIABLE | -| COMMA | FROM | MAX | SCORES | VGROUPS | -| COMP | GE | METRIC | SELECT | VIEW | -| CONCAT | GLOB | METRICS | SEMI | WAVG | -| CONFIGS | GRANTS | MIN | SET | WHERE | -| CONFLICT | GROUP | | | | \ No newline at end of file +| ABLOCKS | CONNECTION | GT | MNODES | SLIDING | +| ABORT | CONNECTIONS | ID | MODULES | SMALLINT | +| ACCOUNT | COPY | IF | NCHAR | SPREAD | +| ACCOUNTS | COUNT | IGNORE | NE | STABLE | +| ADD | CREATE | IMMEDIATE | NONE | STABLES | +| AFTER | CTIME | IMPORT | NOT | STAR | +| ALL | DATABASE | IN | NOTNULL | STATEMENT | +| ALTER | DATABASES | INITIALLY | NOW | STDDEV | +| AND | DAYS | INSERT | OF | STREAM | +| AS | DEFERRED | INSTEAD | OFFSET | STREAMS | +| ASC | DELIMITERS | INTEGER | OR | STRING | +| ATTACH | DESC | INTERVAL | ORDER | SUM | +| AVG | DESCRIBE | INTO | PASS | TABLE | +| BEFORE | DETACH | IP | PERCENTILE | TABLES | +| BEGIN | DIFF | IS | PLUS | TAG | +| BETWEEN | DIVIDE | ISNULL | PRAGMA | TAGS | +| BIGINT | DNODE | JOIN | PREV | TBLOCKS | +| BINARY | DNODES | KEEP | PRIVILEGE | TBNAME | +| BITAND | DOT | KEY | QUERIES | TIMES | +| BITNOT | DOUBLE | KILL | QUERY | TIMESTAMP | +| BITOR | DROP | LAST | RAISE | TINYINT | +| BOOL | EACH | LE | REM | TOP | +| BOTTOM | END | LEASTSQUARES | REPLACE | TRIGGER | +| BY | EQ | LIKE | REPLICA | UMINUS | +| CACHE | EXISTS | LIMIT | RESET | UPLUS | +| CASCADE | EXPLAIN | LINEAR | RESTRICT | USE | +| CHANGE | FAIL | LOCAL | ROW | USER | +| CLOG | FILL | LP | ROWS | USERS | +| CLUSTER | FIRST | LSHIFT | RP | USING | +| COLON | FLOAT | LT | RSHIFT | VALUES | +| COLUMN | FOR | MATCH | SCORES | VARIABLE | +| COMMA | FROM | MAX | SELECT | VGROUPS | +| COMP | GE | METRIC | SEMI | VIEW | +| CONCAT | GLOB | METRICS | SET | WAVG | +| CONFIGS | GRANTS | MIN | SHOW | WHERE | +| CONFLICT | GROUP | MINUS | SLASH | | -- GitLab