This is an automated email from the ASF dual-hosted git repository.
critas pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iotdb-docs.git
The following commit(s) were added to refs/heads/main by this push:
new 436d45e4 update tablename description (#881)
436d45e4 is described below
commit 436d45e42c215bda75b446fa9a3748c88a715436
Author: leto-b <[email protected]>
AuthorDate: Fri Sep 12 15:06:44 2025 +0800
update tablename description (#881)
---
.../Master/Table/API/Programming-Java-Native-API_apache.md | 2 ++
.../Master/Table/API/Programming-Java-Native-API_timecho.md | 2 ++
src/UserGuide/Master/Table/Basic-Concept/Table-Management.md | 1 +
.../latest-Table/API/Programming-Java-Native-API_apache.md | 3 +++
.../latest-Table/API/Programming-Java-Native-API_timecho.md | 2 ++
src/UserGuide/latest-Table/Basic-Concept/Table-Management.md | 1 +
.../Master/Table/API/Programming-Java-Native-API_apache.md | 2 ++
.../Master/Table/API/Programming-Java-Native-API_timecho.md | 2 ++
src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management.md | 6 +++++-
.../latest-Table/API/Programming-Java-Native-API_apache.md | 2 ++
.../latest-Table/API/Programming-Java-Native-API_timecho.md | 2 ++
src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management.md | 6 +++++-
12 files changed, 29 insertions(+), 2 deletions(-)
diff --git
a/src/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
b/src/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
index 497e0295..8775f4ee 100644
--- a/src/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
+++ b/src/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
@@ -343,6 +343,8 @@ public class TableSessionBuilder {
}
```
+> Note: When creating tables using the native API, if table or column names
contain special characters or Chinese characters, do not add extra double
quotes around them. Otherwise, the quotation marks will become part of the name
itself.
+
## 4. Session Pool
### 4.1 ITableSessionPool Interface
diff --git
a/src/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
b/src/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
index 945a55e3..ea453211 100644
--- a/src/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
+++ b/src/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
@@ -343,6 +343,8 @@ public class TableSessionBuilder {
}
```
+> Note: When creating tables using the native API, if table or column names
contain special characters or Chinese characters, do not add extra double
quotes around them. Otherwise, the quotation marks will become part of the name
itself.
+
## 4. Session Pool
### 4.1 ITableSessionPool Interface
diff --git a/src/UserGuide/Master/Table/Basic-Concept/Table-Management.md
b/src/UserGuide/Master/Table/Basic-Concept/Table-Management.md
index b80ac279..752c6cae 100644
--- a/src/UserGuide/Master/Table/Basic-Concept/Table-Management.md
+++ b/src/UserGuide/Master/Table/Basic-Concept/Table-Management.md
@@ -70,6 +70,7 @@ comment
2. Can include special characters such as `~!`"`%`, etc.
3. Names with special or Chinese characters must be enclosed in double
quotes (`""`).
4. Outer double quotes are not retained in the final table name. For
example: `"a""b"` becomes `a"b`.
+ 5. Note: In SQL, table or column names with special characters or Chinese
characters must be wrapped in double quotes. However, in the native API, do not
add extra quotes—otherwise, the quotation marks will become part of the name
itself.
5. **`columnDefinition`**: Column names share the same characteristics as
table names and can include special characters such as `.`.
6. COMMENT adds comments to the table.
diff --git
a/src/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md
b/src/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md
index 497e0295..07cca5ce 100644
--- a/src/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md
+++ b/src/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md
@@ -343,6 +343,9 @@ public class TableSessionBuilder {
}
```
+
+> Note: When creating tables using the native API, if table or column names
contain special characters or Chinese characters, do not add extra double
quotes around them. Otherwise, the quotation marks will become part of the name
itself.
+
## 4. Session Pool
### 4.1 ITableSessionPool Interface
diff --git
a/src/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md
b/src/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md
index 945a55e3..ea453211 100644
--- a/src/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md
+++ b/src/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md
@@ -343,6 +343,8 @@ public class TableSessionBuilder {
}
```
+> Note: When creating tables using the native API, if table or column names
contain special characters or Chinese characters, do not add extra double
quotes around them. Otherwise, the quotation marks will become part of the name
itself.
+
## 4. Session Pool
### 4.1 ITableSessionPool Interface
diff --git a/src/UserGuide/latest-Table/Basic-Concept/Table-Management.md
b/src/UserGuide/latest-Table/Basic-Concept/Table-Management.md
index c9ff77fe..d256eed3 100644
--- a/src/UserGuide/latest-Table/Basic-Concept/Table-Management.md
+++ b/src/UserGuide/latest-Table/Basic-Concept/Table-Management.md
@@ -70,6 +70,7 @@ comment
2. Can include special characters such as `~!`"`%`, etc.
3. Names with special or Chinese characters must be enclosed in double
quotes (`""`).
4. Outer double quotes are not retained in the final table name. For
example: `"a""b"` becomes `a"b`.
+ 5. Note: In SQL, table or column names with special characters or Chinese
characters must be wrapped in double quotes. However, in the native API, do not
add extra quotes—otherwise, the quotation marks will become part of the name
itself.
5. **`columnDefinition`**: Column names share the same characteristics as
table names and can include special characters such as `.`.
6. COMMENT adds comments to the table.
diff --git
a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
index d2b82af5..db551c91 100644
--- a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
+++ b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
@@ -348,6 +348,8 @@ public class TableSessionBuilder {
}
```
+> 注意： 原生API中创建表时，表名或列名中若含有特殊字符或中文字符，无需额外添加双引号括起，否则会包含引号字符。
+
## 4. 客户端连接池
### 4.1 ITableSessionPool 接口
diff --git
a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
index 49f63cdb..209421a6 100644
--- a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
+++ b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
@@ -348,6 +348,8 @@ public class TableSessionBuilder {
}
```
+> 注意： 原生API中创建表时，表名或列名中若含有特殊字符或中文字符，无需额外添加双引号括起，否则会包含引号字符。
+
## 4. 客户端连接池
### 4.1 ITableSessionPool 接口
diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management.md
b/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management.md
index 4ade1db4..6ac1801f 100644
--- a/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management.md
+++ b/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management.md
@@ -68,11 +68,15 @@ comment
4. <TABLE_NAME>表名称，具有以下特性：
- 大小写不敏感，创建成功后，统一显示为小写
- 名称可包含特殊字符，如 `~!`"%` 等
- - 包含特殊字符或中文字符的数据库名创建时必须用双引号 "" 括起来。
+ - 包含特殊字符或中文字符的表名创建时必须用双引号 "" 括起来。
+ - 注意：SQL中特殊字符或中文表名需加双引号。原生API中无需额外添加，否则表名会包含引号字符。
- 当为表命名时，最外层的双引号（`""`）不会在实际创建的表名中出现。
- ```SQL
+ -- SQL 中
"a""b" --> a"b
"""""" --> ""
+ -- API 中
+ "a""b" --> "a""b"
```
5. columnDefinition 列名称与表名称具有相同特性，并且可包含特殊字符`.`。
6. COMMENT 给表添加注释。
diff --git
a/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md
b/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md
index d2b82af5..db551c91 100644
--- a/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md
+++ b/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_apache.md
@@ -348,6 +348,8 @@ public class TableSessionBuilder {
}
```
+> 注意： 原生API中创建表时，表名或列名中若含有特殊字符或中文字符，无需额外添加双引号括起，否则会包含引号字符。
+
## 4. 客户端连接池
### 4.1 ITableSessionPool 接口
diff --git
a/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md
b/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md
index 49f63cdb..209421a6 100644
--- a/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md
+++ b/src/zh/UserGuide/latest-Table/API/Programming-Java-Native-API_timecho.md
@@ -348,6 +348,8 @@ public class TableSessionBuilder {
}
```
+> 注意： 原生API中创建表时，表名或列名中若含有特殊字符或中文字符，无需额外添加双引号括起，否则会包含引号字符。
+
## 4. 客户端连接池
### 4.1 ITableSessionPool 接口
diff --git a/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management.md
b/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management.md
index 4ade1db4..5ab9a023 100644
--- a/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management.md
+++ b/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management.md
@@ -68,11 +68,15 @@ comment
4. <TABLE_NAME>表名称，具有以下特性：
- 大小写不敏感，创建成功后，统一显示为小写
- 名称可包含特殊字符，如 `~!`"%` 等
- - 包含特殊字符或中文字符的数据库名创建时必须用双引号 "" 括起来。
+ - 包含特殊字符或中文字符的表名创建时必须用双引号 "" 括起来。
+ - 注意：SQL中特殊字符或中文表名需加双引号。原生API中无需额外添加，否则表名会包含引号字符。
- 当为表命名时，最外层的双引号（`""`）不会在实际创建的表名中出现。
- ```SQL
+ -- SQL 中
"a""b" --> a"b
"""""" --> ""
+ -- API 中
+ "a""b" --> "a""b"
```
5. columnDefinition 列名称与表名称具有相同特性，并且可包含特殊字符`.`。
6. COMMENT 给表添加注释。
