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 497e02953..8775f4eeb 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 945a55e33..ea4532116 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 b80ac2791..752c6caed 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 497e02953..07cca5ce0 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 945a55e33..ea4532116 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 c9ff77fef..d256eed35 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 d2b82af56..db551c91e 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 49f63cdbd..209421a64 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 4ade1db45..6ac1801fe 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. 表名称,具有以下特性: - 大小写不敏感,创建成功后,统一显示为小写 - 名称可包含特殊字符,如 `~!`"%` 等 - - 包含特殊字符或中文字符的数据库名创建时必须用双引号 "" 括起来。 + - 包含特殊字符或中文字符的表名创建时必须用双引号 "" 括起来。 + - 注意: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 d2b82af56..db551c91e 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 49f63cdbd..209421a64 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 4ade1db45..5ab9a023f 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. 表名称,具有以下特性: - 大小写不敏感,创建成功后,统一显示为小写 - 名称可包含特殊字符,如 `~!`"%` 等 - - 包含特殊字符或中文字符的数据库名创建时必须用双引号 "" 括起来。 + - 包含特殊字符或中文字符的表名创建时必须用双引号 "" 括起来。 + - 注意:SQL中特殊字符或中文表名需加双引号。原生API中无需额外添加,否则表名会包含引号字符。 - 当为表命名时,最外层的双引号(`""`)不会在实际创建的表名中出现。 - ```SQL + -- SQL 中 "a""b" --> a"b """""" --> "" + -- API 中 + "a""b" --> "a""b" ``` 5. columnDefinition 列名称与表名称具有相同特性,并且可包含特殊字符`.`。 6. COMMENT 给表添加注释。