Skip to content

Commit ebc4978

Browse files
authored
docs: add map desc in create table (#3912)
1 parent c5ecca7 commit ebc4978

4 files changed

Lines changed: 24 additions & 19 deletions

File tree

docs/en/openmldb_sql/data_types/composite_types.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,3 +28,5 @@ select map (1, "12", 2, "100")[2]
2828
1. Generally not recommended to store a map value with too much key-value pairs, since it's a row-based storage model.
2929
2. Map data type can not used as the key or ts column of table index, queries can not be optimized based on specific key value inside a map column neither.
3030
3. Query a key-value in a map takes `O(n)` complexity at most.
31+
4. Currently, it is not allowed to output a map type value from a SQL query, however you can access information about the map value using map-related expressions. For example, you may use `[]` operator over a `map<int, int>` type to extract value of specific key.
32+

docs/en/openmldb_sql/ddl/CREATE_TABLE_STATEMENT.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -50,15 +50,16 @@ ColumnName ::=
5050
Identifier ( '.' Identifier ( '.' Identifier )? )?
5151

5252
ColumnType ::=
53-
'INT' | 'INT32'
54-
|'SMALLINT' | 'INT16'
55-
|'BIGINT' | 'INT64'
56-
|'FLOAT'
57-
|'DOUBLE'
58-
|'TIMESTAMP'
59-
|'DATE'
60-
|'BOOL'
61-
|'STRING' | 'VARCHAR'
53+
'INT' | 'INT32'
54+
|'SMALLINT' | 'INT16'
55+
|'BIGINT' | 'INT64'
56+
|'FLOAT'
57+
|'DOUBLE'
58+
|'TIMESTAMP'
59+
|'DATE'
60+
|'BOOL'
61+
|'STRING' | 'VARCHAR'
62+
| 'MAP' '<' ColumnType ',' ColumnType '>'
6263

6364
ColumnOptionList ::=
6465
ColumnOption*

docs/zh/openmldb_sql/data_types/composite_types.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,3 +27,4 @@ select map (1, "12", 2, "100")[2]
2727
1. 由于采用行存储形式,不建议表的 MAP 类型存储 key-value pair 特别多的情况,否则可能导致性能问题。
2828
2. map 数据类型不支持作为索引的 key 或 ts 列,无法对 map 列特定 key 做查询优化。
2929
3. map key-value 查询最多消耗 `O(n)` 复杂度
30+
4. 目前暂未支持查询结果直接输出 map 类型,但可以用 map 相关的表达式得到关于 map 值的基本类型结果,例如用 `[]` 获取 `map<int,int>` 中特定 key 的 value。

docs/zh/openmldb_sql/ddl/CREATE_TABLE_STATEMENT.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -50,15 +50,16 @@ ColumnName ::=
5050
Identifier ( '.' Identifier ( '.' Identifier )? )?
5151

5252
ColumnType ::=
53-
'INT' | 'INT32'
54-
|'SMALLINT' | 'INT16'
55-
|'BIGINT' | 'INT64'
56-
|'FLOAT'
57-
|'DOUBLE'
58-
|'TIMESTAMP'
59-
|'DATE'
60-
|'BOOL'
61-
|'STRING' | 'VARCHAR'
53+
'INT' | 'INT32'
54+
|'SMALLINT' | 'INT16'
55+
|'BIGINT' | 'INT64'
56+
|'FLOAT'
57+
|'DOUBLE'
58+
|'TIMESTAMP'
59+
|'DATE'
60+
|'BOOL'
61+
|'STRING' | 'VARCHAR'
62+
| 'MAP' '<' ColumnType ',' ColumnType '>'
6263

6364
ColumnOptionList ::=
6465
ColumnOption*
@@ -511,4 +512,4 @@ create table t1 (col0 string, col1 int) options (DISTRIBUTION=[('127.0.0.1:30921
511512

512513
[CREATE DATABASE](../ddl/CREATE_DATABASE_STATEMENT.md)
513514

514-
[USE DATABASE](../ddl/USE_DATABASE_STATEMENT.md)
515+
[USE DATABASE](../ddl/USE_DATABASE_STATEMENT.md)

0 commit comments

Comments
 (0)