morrySnow commented on code in PR #1812:
URL: https://github.com/apache/doris-website/pull/1812#discussion_r1918243125
##########
docs/sql-manual/sql-functions/table-valued-functions/catalogs.md:
##########
@@ -24,48 +24,34 @@ specific language governing permissions and limitations
under the License.
-->
-## `catalogs`
-
-### Name
-
-
-catalogs
-
-
### description
-The table function generates a temporary table of catalogs to view the
information of the catalogs created in the current Doris.
+This table function generates a temporary catalogs table, allowing you to view
the information of all the catalogs currently created in Apache Doris.
-This function is used in the from clause.
+It is used in the FROM clause, making it easier to query and analyze the
catalog data in Doris.
#### syntax
-
-`catalogs()`
-
-Catalogs () table structure:
-```
-mysql> desc function catalogs();
-+-------------+--------+------+-------+---------+-------+
-| Field | Type | Null | Key | Default | Extra |
-+-------------+--------+------+-------+---------+-------+
-| CatalogId | BIGINT | No | false | NULL | NONE |
-| CatalogName | TEXT | No | false | NULL | NONE |
-| CatalogType | TEXT | No | false | NULL | NONE |
-| Property | TEXT | No | false | NULL | NONE |
-| Value | TEXT | No | false | NULL | NONE |
-+-------------+--------+------+-------+---------+-------+
-5 rows in set (0.04 sec)
+```sql
+CATALOGS()
```
-The information presented by `catalogs()` tvf is the result of synthesizing
`show catalogs` and `show catalog xxx` statements.
-
-The table generated by tvf can be used for filtering, join and other
operations.
+## RETURN VALUE
+- **CatalogId**: The unique identifier of the `catalog`.
+- **CatalogName**: The name of the `catalog`.
+- **CatalogType**: The type of the `catalog`.
+- **Property**: The name of the `catalog` configuration property.
+- **Value**: The value of the configuration property.
Review Comment:
使用表格吧，比较直观
##########
docs/sql-manual/sql-functions/table-valued-functions/catalogs.md:
##########
@@ -24,48 +24,34 @@ specific language governing permissions and limitations
under the License.
-->
-## `catalogs`
-
-### Name
-
-
-catalogs
-
-
### description
-The table function generates a temporary table of catalogs to view the
information of the catalogs created in the current Doris.
+This table function generates a temporary catalogs table, allowing you to view
the information of all the catalogs currently created in Apache Doris.
-This function is used in the from clause.
+It is used in the FROM clause, making it easier to query and analyze the
catalog data in Doris.
#### syntax
-
-`catalogs()`
-
-Catalogs () table structure:
-```
-mysql> desc function catalogs();
-+-------------+--------+------+-------+---------+-------+
-| Field | Type | Null | Key | Default | Extra |
-+-------------+--------+------+-------+---------+-------+
-| CatalogId | BIGINT | No | false | NULL | NONE |
-| CatalogName | TEXT | No | false | NULL | NONE |
-| CatalogType | TEXT | No | false | NULL | NONE |
-| Property | TEXT | No | false | NULL | NONE |
-| Value | TEXT | No | false | NULL | NONE |
-+-------------+--------+------+-------+---------+-------+
-5 rows in set (0.04 sec)
+```sql
+CATALOGS()
```
-The information presented by `catalogs()` tvf is the result of synthesizing
`show catalogs` and `show catalog xxx` statements.
-
-The table generated by tvf can be used for filtering, join and other
operations.
+## RETURN VALUE
+- **CatalogId**: The unique identifier of the `catalog`.
+- **CatalogName**: The name of the `catalog`.
+- **CatalogType**: The type of the `catalog`.
+- **Property**: The name of the `catalog` configuration property.
+- **Value**: The value of the configuration property.
-### example
+## Usage Notes
+- The information returned by the `catalogs()` function is a combination of
the results from the `show catalogs` and `show catalog xxx` statements.
Review Comment:
直接放到描述里面
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/table-valued-functions/frontends_disks.md:
##########
@@ -1,6 +1,6 @@
---
{
- "title": "frontends_disks",
+ "title": "FRONTENDS_DISK",
Review Comment:
```suggestion
"title": "FRONTENDS_DISKS",
```
##########
docs/sql-manual/sql-functions/table-valued-functions/catalogs.md:
##########
@@ -24,48 +24,34 @@ specific language governing permissions and limitations
under the License.
-->
-## `catalogs`
-
-### Name
-
-
-catalogs
-
-
### description
-The table function generates a temporary table of catalogs to view the
information of the catalogs created in the current Doris.
+This table function generates a temporary catalogs table, allowing you to view
the information of all the catalogs currently created in Apache Doris.
-This function is used in the from clause.
+It is used in the FROM clause, making it easier to query and analyze the
catalog data in Doris.
#### syntax
-
-`catalogs()`
-
-Catalogs () table structure:
-```
-mysql> desc function catalogs();
-+-------------+--------+------+-------+---------+-------+
-| Field | Type | Null | Key | Default | Extra |
-+-------------+--------+------+-------+---------+-------+
-| CatalogId | BIGINT | No | false | NULL | NONE |
-| CatalogName | TEXT | No | false | NULL | NONE |
-| CatalogType | TEXT | No | false | NULL | NONE |
-| Property | TEXT | No | false | NULL | NONE |
-| Value | TEXT | No | false | NULL | NONE |
-+-------------+--------+------+-------+---------+-------+
-5 rows in set (0.04 sec)
+```sql
+CATALOGS()
```
-The information presented by `catalogs()` tvf is the result of synthesizing
`show catalogs` and `show catalog xxx` statements.
-
-The table generated by tvf can be used for filtering, join and other
operations.
+## RETURN VALUE
+- **CatalogId**: The unique identifier of the `catalog`.
+- **CatalogName**: The name of the `catalog`.
+- **CatalogType**: The type of the `catalog`.
+- **Property**: The name of the `catalog` configuration property.
+- **Value**: The value of the configuration property.
-### example
+## Usage Notes
+- The information returned by the `catalogs()` function is a combination of
the results from the `show catalogs` and `show catalog xxx` statements.
+### Examples
Review Comment:
二级标题
```suggestion
## Examples
```
##########
docs/sql-manual/sql-functions/table-valued-functions/catalogs.md:
##########
@@ -24,48 +24,34 @@ specific language governing permissions and limitations
under the License.
-->
-## `catalogs`
-
-### Name
-
-
-catalogs
-
-
### description
-The table function generates a temporary table of catalogs to view the
information of the catalogs created in the current Doris.
+This table function generates a temporary catalogs table, allowing you to view
the information of all the catalogs currently created in Apache Doris.
-This function is used in the from clause.
+It is used in the FROM clause, making it easier to query and analyze the
catalog data in Doris.
#### syntax
Review Comment:
二级标题
```suggestion
## syntax
```
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/table-valued-functions/frontends_disks.md:
##########
@@ -24,63 +24,54 @@ specific language governing permissions and limitations
under the License.
-->
-## `frontends_disks`
-
-### Name
-
-frontends_disks
-
## 描述
-表函数，生成 frontends_disks 临时表，可以查看当前 doris 集群中的 FE 节点的磁盘信息。
+`frontends_disks` 表函数会生成一个临时表，允许查看当前 Doris 集群中 FE 节点的磁盘信息。
-该函数用于 from 子句中。
+该函数可用于 `FROM` 子句中。
-## 语法
-`frontends_disks()`
-frontends_disks() 表结构：
-```
-mysql> desc function frontends_disks();
-+-------------+------+------+-------+---------+-------+
-| Field | Type | Null | Key | Default | Extra |
-+-------------+------+------+-------+---------+-------+
-| Name | TEXT | No | false | NULL | NONE |
-| Host | TEXT | No | false | NULL | NONE |
-| DirType | TEXT | No | false | NULL | NONE |
-| Dir | TEXT | No | false | NULL | NONE |
-| Filesystem | TEXT | No | false | NULL | NONE |
-| Capacity | TEXT | No | false | NULL | NONE |
-| Used | TEXT | No | false | NULL | NONE |
-| Available | TEXT | No | false | NULL | NONE |
-| UseRate | TEXT | No | false | NULL | NONE |
-| MountOn | TEXT | No | false | NULL | NONE |
-+-------------+------+------+-------+---------+-------+
-11 rows in set (0.14 sec)
+## 语法
+```sql
+FRONTENDS_DISK()
Review Comment:
```suggestion
FRONTENDS_DISKS()
```
##########
docs/sql-manual/sql-functions/table-valued-functions/catalogs.md:
##########
@@ -24,48 +24,34 @@ specific language governing permissions and limitations
under the License.
-->
-## `catalogs`
-
-### Name
-
-
-catalogs
-
-
### description
Review Comment:
二级标题
```suggestion
## Description
```
--
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: commits-unsubscr...@doris.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
