terrymanu commented on code in PR #19740:
URL: https://github.com/apache/shardingsphere/pull/19740#discussion_r934353873
##########
docs/document/content/reference/distsql/syntax/rdl/resource-definition/alter-resource.cn.md:
##########
@@ -0,0 +1,91 @@
++++
+title = "ALTER RESOURCE"
+weight = 4
++++
+
+### 描述
+
+`ALTER RESOURCE` 语法用于修改当前所选逻辑库（DATABASE）的资源。
+
+### 语法
+```SQL
+AlterResource ::=
+ 'ALTER' 'RESOURCE' dataSource (',' dataSource)*
+
+dataSource ::=
+ dataSourceName '(' ( 'HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '='
dbName | 'URL' '=' url ) ',' 'USER' '=' user (',' 'PASSWORD' '=' password )?
(',' 'PROPERTIES' '(' ( key '=' value ) ( ',' key '=' value )* ')' )?')'
+
+dataSourceName ::=
+ identifier
+
+hostname ::=
+ identifier | ip
+
+dbName ::=
+ identifier
+
+port ::=
+ int
+
+password ::=
+ identifier | int | string
+
+user ::=
+ identifier
+
+url ::=
+ identifier | string
+```
+
+ ### 补充说明
+
+- 修改资源前请确认已经在 Proxy 中创建逻辑数据库，并执行 `use` 命令成功选择一个逻辑数据库；
+- 修改资源时不允许改变该资源关联的真实数据源；
+- 修改资源时会发生连接池的切换，这个操作可能对进行中的业务造成影响，请谨慎使用；
+- 确认添加的资源是可以正常连接的， 否则将不能添加成功；
+- `dataSourceName` 区分大小写；
+- `dataSourceName` 在当前逻辑库中需要唯一；
+- `dataSourceName` 命名只允许使用字母、数字以及 `_` ，且必须以字母开头；
+- `poolProperty` 用于自定义连接池参数，`key` 必须和连接池参数名一致，`value` 支持 int 和 String 类型；
+- 当 `password` 包含特殊字符时，建议使用 string 形式；例如 `password@123`的 string 形式为
`"password@123"`。
+
+ ### 示例
+- 使用标准模式修改资源
Review Comment:
Please keep blank line between markdown syntax and content
##########
docs/document/content/reference/distsql/syntax/rdl/resource-definition/alter-resource.cn.md:
##########
@@ -0,0 +1,91 @@
++++
+title = "ALTER RESOURCE"
+weight = 4
++++
+
+### 描述
+
+`ALTER RESOURCE` 语法用于修改当前所选逻辑库（DATABASE）的资源。
+
+### 语法
+```SQL
Review Comment:
Please keep blank line between markdown syntax and content
##########
docs/document/content/reference/distsql/syntax/rdl/resource-definition/alter-resource.cn.md:
##########
@@ -0,0 +1,91 @@
++++
+title = "ALTER RESOURCE"
+weight = 4
++++
+
+### 描述
+
+`ALTER RESOURCE` 语法用于修改当前所选逻辑库（DATABASE）的资源。
+
+### 语法
+```SQL
+AlterResource ::=
+ 'ALTER' 'RESOURCE' dataSource (',' dataSource)*
+
+dataSource ::=
+ dataSourceName '(' ( 'HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '='
dbName | 'URL' '=' url ) ',' 'USER' '=' user (',' 'PASSWORD' '=' password )?
(',' 'PROPERTIES' '(' ( key '=' value ) ( ',' key '=' value )* ')' )?')'
+
+dataSourceName ::=
+ identifier
+
+hostname ::=
+ identifier | ip
+
+dbName ::=
+ identifier
+
+port ::=
+ int
+
+password ::=
+ identifier | int | string
+
+user ::=
+ identifier
+
+url ::=
+ identifier | string
+```
+
+ ### 补充说明
+
+- 修改资源前请确认已经在 Proxy 中创建逻辑数据库，并执行 `use` 命令成功选择一个逻辑数据库；
+- 修改资源时不允许改变该资源关联的真实数据源；
+- 修改资源时会发生连接池的切换，这个操作可能对进行中的业务造成影响，请谨慎使用；
+- 确认添加的资源是可以正常连接的， 否则将不能添加成功；
+- `dataSourceName` 区分大小写；
+- `dataSourceName` 在当前逻辑库中需要唯一；
+- `dataSourceName` 命名只允许使用字母、数字以及 `_` ，且必须以字母开头；
+- `poolProperty` 用于自定义连接池参数，`key` 必须和连接池参数名一致，`value` 支持 int 和 String 类型；
+- 当 `password` 包含特殊字符时，建议使用 string 形式；例如 `password@123`的 string 形式为
`"password@123"`。
+
+ ### 示例
+- 使用标准模式修改资源
+```SQL
+ALTER RESOURCE ds_0 (
+ HOST=127.0.0.1,
+ PORT=3306,
+ DB=db_0,
+ USER=root,
+ PASSWORD=root
+);
+```
+
+- 使用标准模式修改资源并设置连接池参数
+```SQL
Review Comment:
Please keep blank line between markdown syntax and content
##########
docs/document/content/reference/distsql/syntax/rdl/resource-definition/alter-resource.cn.md:
##########
@@ -0,0 +1,91 @@
++++
+title = "ALTER RESOURCE"
+weight = 4
++++
+
+### 描述
+
+`ALTER RESOURCE` 语法用于修改当前所选逻辑库（DATABASE）的资源。
+
+### 语法
+```SQL
+AlterResource ::=
+ 'ALTER' 'RESOURCE' dataSource (',' dataSource)*
+
+dataSource ::=
+ dataSourceName '(' ( 'HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '='
dbName | 'URL' '=' url ) ',' 'USER' '=' user (',' 'PASSWORD' '=' password )?
(',' 'PROPERTIES' '(' ( key '=' value ) ( ',' key '=' value )* ')' )?')'
+
+dataSourceName ::=
+ identifier
+
+hostname ::=
+ identifier | ip
+
+dbName ::=
+ identifier
+
+port ::=
+ int
+
+password ::=
+ identifier | int | string
+
+user ::=
+ identifier
+
+url ::=
+ identifier | string
+```
+
+ ### 补充说明
+
+- 修改资源前请确认已经在 Proxy 中创建逻辑数据库，并执行 `use` 命令成功选择一个逻辑数据库；
+- 修改资源时不允许改变该资源关联的真实数据源；
+- 修改资源时会发生连接池的切换，这个操作可能对进行中的业务造成影响，请谨慎使用；
+- 确认添加的资源是可以正常连接的， 否则将不能添加成功；
+- `dataSourceName` 区分大小写；
+- `dataSourceName` 在当前逻辑库中需要唯一；
+- `dataSourceName` 命名只允许使用字母、数字以及 `_` ，且必须以字母开头；
+- `poolProperty` 用于自定义连接池参数，`key` 必须和连接池参数名一致，`value` 支持 int 和 String 类型；
+- 当 `password` 包含特殊字符时，建议使用 string 形式；例如 `password@123`的 string 形式为
`"password@123"`。
+
+ ### 示例
+- 使用标准模式修改资源
+```SQL
+ALTER RESOURCE ds_0 (
+ HOST=127.0.0.1,
+ PORT=3306,
+ DB=db_0,
+ USER=root,
+ PASSWORD=root
+);
+```
+
+- 使用标准模式修改资源并设置连接池参数
+```SQL
+ALTER RESOURCE ds_1 (
+ HOST=127.0.0.1,
+ PORT=3306,
+ DB=db_1,
+ USER=root,
+ PASSWORD=root,
+ PROPERTIES("maximumPoolSize"=10)
+);
+```
+
+- 使用 URL 模式修改资源并设置连接池参数
+```SQL
+ALTER RESOURCE ds_2 (
+ URL="jdbc:mysql://127.0.0.1:3306/db_2?serverTimezone=UTC&useSSL=false",
+ USER=root,
+ PASSWORD=root,
+ PROPERTIES("maximumPoolSize"=10,"idleTimeout"="30000")
+);
+```
+
+### 保留字
+
+ ALTER、RESOURCE、HOST、PORT、DB、USER、PASSWORD、PROPERTIES、URL
Review Comment:
Please do not keep space, just keep consist with other lines.
##########
docs/document/content/reference/distsql/syntax/rdl/resource-definition/alter-resource.cn.md:
##########
@@ -0,0 +1,91 @@
++++
+title = "ALTER RESOURCE"
+weight = 4
++++
+
+### 描述
+
+`ALTER RESOURCE` 语法用于修改当前所选逻辑库（DATABASE）的资源。
+
+### 语法
+```SQL
Review Comment:
Please keep consist with SQL and sql.
It is better to use sql
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
