sql, README: improve JSON doc #949
Conversation
|
Note: one of the 'unsupported' functions has since been merged: pingcap/docs#680 (Up to you if you want to handle in this PR, or a followup one.) |
sql/generated-columns.md
Outdated
| ); | ||
| ``` | ||
|
|
||
| 该表中，`city` 列是一个 **generated column**。顾名思义，此列由该表的其他列生成，对此列进行插入或更新操作时，并不能对之赋值。此列按需生成，并不存储在数据库中，也不占用内存空间，因而是_虚拟的_。`city` 列的索引_存储在数据库中_，并使用和 `varchar(64)` 类的其他索引相同的结构。 |
There was a problem hiding this comment.
The italic effect does not work well here. You can click "View" to check it.
In Chinese text, limit the use of the italic effect. For emphasis, the bold effect is preferred.
There was a problem hiding this comment.
How about "因而是虚拟的" Or "因而是 虚拟的 。"?
因而是**虚拟的**
因而是 _虚拟的_ 。 // NOTE: There is a space to separate the _ symbol.
sql/generated-columns.md
Outdated
|
|
||
| - 不能通过 `ALTER TABLE` 增加 `STORED` 存储方式的 generated column； | ||
| - 不能通过 `ALTER TABLE` 在 generated column 上增加索引； | ||
| - 并未支持所有的 [JSON 函数](json-functions.md)。 |
There was a problem hiding this comment.
Please update the link path to ../sql/json-functions.md.
sql/json-functions.md
Outdated
| category: user guide | ||
| --- | ||
|
|
||
| # JSON 相关的函数和语法糖 | ||
| # JSON 相关的函数及语法糖 |
There was a problem hiding this comment.
Keep this heading consistent with the title in metadata.
sql/json-functions.md
Outdated
| * `JSON_APPEND` 及其别名 `JSON_ARRAY_APPEND` | ||
| * `JSON_ARRAY_INSERT` | ||
| * `JSON_DEPTH` | ||
| * `JSON_KEYS` |
There was a problem hiding this comment.
As what Morgan has mentioned, this function has been removed from the unsupported list. See pingcap/docs#680
| @@ -30,3 +72,10 @@ category: user guide | |||
| [json_merge]: https://dev.mysql.com/doc/refman/5.7/en/json-modification-functions.html#function_json-merge | |||
| [json_object]: https://dev.mysql.com/doc/refman/5.7/en/json-creation-functions.html#function_json-object | |||
| [json_array]: https://dev.mysql.com/doc/refman/5.7/en/json-creation-functions.html#function_json-array | |||
| [json_keys]: https://dev.mysql.com/doc/refman/5.7/en/json-search-functions.html#function_json-keys | |||
There was a problem hiding this comment.
Please also check and update the links. If it links to no place, please remove it.
Via pingcap/docs#656
@lilin90 @zz-jason PTAL