You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iotdb.apache.org by ha...@apache.org on 2021/01/15 07:30:17 UTC
[iotdb] branch CharDoc created (now f3c3c91)
This is an automated email from the ASF dual-hosted git repository.
haonan pushed a change to branch CharDoc
in repository https://gitbox.apache.org/repos/asf/iotdb.git.
at f3c3c91 add special character specification
This branch includes the following new commits:
new f3c3c91 add special character specification
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
[iotdb] 01/01: add special character specification
Posted by ha...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
haonan pushed a commit to branch CharDoc
in repository https://gitbox.apache.org/repos/asf/iotdb.git
commit f3c3c91021025d21b4f6c98595ae1fb091526d09
Author: HTHou <hh...@outlook.com>
AuthorDate: Fri Jan 15 15:28:53 2021 +0800
add special character specification
---
docs/UserGuide/Concept/Data Model and Terminology.md | 13 ++++++++++++-
.../Operation Manual/DDL Data Definition Language.md | 3 +++
docs/zh/UserGuide/Concept/Data Model and Terminology.md | 16 ++++++++++++++--
.../Operation Manual/DDL Data Definition Language.md | 4 ++++
4 files changed, 33 insertions(+), 3 deletions(-)
diff --git a/docs/UserGuide/Concept/Data Model and Terminology.md b/docs/UserGuide/Concept/Data Model and Terminology.md
index 36af91f..3f9aa6e 100644
--- a/docs/UserGuide/Concept/Data Model and Terminology.md
+++ b/docs/UserGuide/Concept/Data Model and Terminology.md
@@ -78,7 +78,18 @@ It is worth noting that in the path, root is a reserved character, which is only
Single quotes are not allowed in the path. If you want to use special characters such as "." in LayerName, use double quotes. For example, `root.sg."d.1"."s.1"`.
-> Note: the LayerName of storage group can only be characters, numbers and underscores.
+The characters supported in LayerName without double quotes are as below:
+
+* Chinese characters '\u2E80' 到'\u9FFF'
+* '+', '&', '%', '$', '#', '@', '/', '_', '-', ':'
+* 'A' to 'Z', 'a' to 'z', '0' to '9'
+* '[', ']'
+
+'-' and ':' cannot be the first character.
+
+> Note: the LayerName of storage group can only be characters, numbers and underscores.
+>
+> Besides, if deploy on Windows system, the LayerName is case-insensitive, which means it's not allowed to set storage groups `root.ln` and `root.LN` at the same time.
* Timeseries Path
diff --git a/docs/UserGuide/Operation Manual/DDL Data Definition Language.md b/docs/UserGuide/Operation Manual/DDL Data Definition Language.md
index 750363b..145e49a 100644
--- a/docs/UserGuide/Operation Manual/DDL Data Definition Language.md
+++ b/docs/UserGuide/Operation Manual/DDL Data Definition Language.md
@@ -38,6 +38,9 @@ It is worth noting that when the path itself or the parent/child layer of the pa
IoTDB> set storage group to root.ln.wf01
Msg: org.apache.iotdb.exception.MetadataException: org.apache.iotdb.exception.MetadataException: The prefix of root.ln.wf01 has been set to the storage group.
```
+The LayerName of storage group can only be characters, numbers and underscores.
+
+Besides, if deploy on Windows system, the LayerName is case-insensitive, which means it's not allowed to set storage groups `root.ln` and `root.LN` at the same time.
## Show Storage Group
diff --git a/docs/zh/UserGuide/Concept/Data Model and Terminology.md b/docs/zh/UserGuide/Concept/Data Model and Terminology.md
index dbd6fcf..8952bf0 100644
--- a/docs/zh/UserGuide/Concept/Data Model and Terminology.md
+++ b/docs/zh/UserGuide/Concept/Data Model and Terminology.md
@@ -59,6 +59,9 @@
一个存储组设定后,其对应的前缀路径的所有父层级与子层级也不允许再设置存储组(如,`root.ln`设置存储组后,root层级与`root.ln.wf01`不允许被设置为存储组)。
+存储组节点名只支持中英文字符、数字和下划线的组合。例如`root.存储组_1` 。
+
+
* 路径
在IoTDB中,路径是指符合以下约束的表达式:
@@ -74,9 +77,18 @@ LayerName: Identifier | STAR
值得说明的是,在路径中,root为一个保留字符,它只允许出现在下文提到的时间序列的开头,若其他层级出现root,则无法解析,提示报错。
-在路径中,不允许使用单引号。如果你想在LayerName中使用“.”等特殊字符,请使用双引号。例如,`root.sg."d.1"."s.1"`。双引号内支持使用转义符进行双引号的嵌套,如 `root.sg.d1."s.\"t\"1"`。
+在路径中,不允许使用单引号。如果你想在LayerName中使用`.`等特殊字符,请使用双引号。例如,`root.sg."d.1"."s.1"`。双引号内支持使用转义符进行双引号的嵌套,如 `root.sg.d1."s.\"t\"1"`。
+
+LayerName中不加双引号支持的字符如下:
+
+* 中文字符 '\u2E80' 到'\u9FFF'
+* '+', '&', '%', '$', '#', '@', '/', '_', '-', ':'
+* 'A' 到 'Z', 'a' 到 'z', '0' 到 '9'
+* '[', ']'
+
+其中'-' 和 ':' 不能放置在第一位
-> 注意: storage group中的LayerName只支持数字,字母,和下划线。
+> 注意: storage group中的LayerName只支持数字,字母,汉字和下划线。另外,如果在Windows系统上部署,存储组层级名称是大小写不敏感的。例如同时创建`root.ln` 和 `root.LN` 是不被允许的。
* 时间序列
diff --git a/docs/zh/UserGuide/Operation Manual/DDL Data Definition Language.md b/docs/zh/UserGuide/Operation Manual/DDL Data Definition Language.md
index bd7b185..db1963c 100644
--- a/docs/zh/UserGuide/Operation Manual/DDL Data Definition Language.md
+++ b/docs/zh/UserGuide/Operation Manual/DDL Data Definition Language.md
@@ -38,6 +38,9 @@ IoTDB > set storage group to root.sgcc
IoTDB> set storage group to root.ln.wf01
Msg: org.apache.iotdb.exception.MetadataException: org.apache.iotdb.exception.MetadataException: The prefix of root.ln.wf01 has been set to the storage group.
```
+存储组节点名只支持中英文字符、数字和下划线的组合。
+
+还需注意,如果在Windows系统上部署,存储组名是大小写不敏感的。例如同时创建`root.ln` 和 `root.LN` 是不被允许的。
## 查看存储组
@@ -93,6 +96,7 @@ error: encoding TS_2DIFF does not support BOOLEAN
详细的数据类型与编码方式的对应列表请参见[编码方式](../Concept/Encoding.md)。
+
### 标签点管理
我们可以在创建时间序列的时候,为它添加别名和额外的标签和属性信息。