morrySnow commented on code in PR #1909:
URL: https://github.com/apache/doris-website/pull/1909#discussion_r1926322691
##########
docs/sql-manual/sql-statements/data-modification/load-and-export/CANCEL-EXPORT.md:
##########
@@ -26,49 +26,69 @@ under the License.
-->
-
## Description
-This statement is used to undo an export job for the specified label. Or batch
undo export jobs via fuzzy matching
+This statement is used to undo an export job for the specified label. Or batch
undo export jobs via fuzzy matching.
+
+## Syntax
```sql
-CANCEL EXPORT
-[FROM db_name]
-WHERE [LABEL = "export_label" | LABEL like "label_pattern" | STATE =
"PENDING/IN_QUEUE/EXPORTING"]
+CANCEL EXPORT
+[FROM <db_name>]
+WHERE [LABEL = "<export_label>" | LABEL like "<label_pattern>" | STATE =
"PENDING/IN_QUEUE/EXPORTING"]
Review Comment:
```suggestion
WHERE [LABEL = "<export_label>" | LABEL like "<label_pattern>" | STATE =
"<state>"]
```
然后下面介绍参数的时候，说明`<state>`的枚举值
##########
docs/sql-manual/sql-statements/data-modification/load-and-export/EXPORT.md:
##########
@@ -24,43 +24,44 @@ specific language governing permissions and limitations
under the License.
-->
+
+
+
Review Comment:
没有意义的空行
##########
docs/sql-manual/sql-statements/data-modification/load-and-export/EXPORT.md:
##########
@@ -182,47 +247,47 @@ PROPERTIES (
);
```
-4. Export partitions p1 and p2 from the test table to local storage, with the
default exported file format being csv.
+- Export partitions p1 and p2 from the test table to local storage, with the
default exported file format being csv.
```sql
EXPORT TABLE test PARTITION (p1,p2) TO "file:///home/user/tmp/"
PROPERTIES ("columns" = "k1,k2");
- ```
+```
-5. Export all data in the test table to local storage with a non-default file
format.
+- Export all data in the test table to local storage with a non-default file
format.
```sql
-// parquet file format
+// parquet
EXPORT TABLE test TO "file:///home/user/tmp/"
PROPERTIES (
"columns" = "k1,k2",
"format" = "parquet"
);
-// orc file format
+// orc
EXPORT TABLE test TO "file:///home/user/tmp/"
PROPERTIES (
"columns" = "k1,k2",
"format" = "orc"
);
-// csv_with_names file format. Using 'AA' as the column delimiter and 'zz' as
the line delimiter.
+// csv(csv_with_names) , Use 'AA' as the column separator and 'zz' as the row
separator
EXPORT TABLE test TO "file:///home/user/tmp/"
PROPERTIES (
"format" = "csv_with_names",
"column_separator"="AA",
"line_delimiter" = "zz"
);
-// csv_with_names_and_types file format
+// csv(csv_with_names_and_types)
Review Comment:
注释使用两个减号加空格
```suggestion
-- csv(csv_with_names_and_types)
```
##########
docs/sql-manual/sql-statements/data-modification/load-and-export/EXPORT.md:
##########
@@ -24,43 +24,44 @@ specific language governing permissions and limitations
under the License.
-->
+
+
+
## Description
The `EXPORT` command is used to export the data of a specified table to a
designated location as a file. Currently, it supports exporting to remote
storage such as HDFS, S3, BOS, and COS (Tencent Cloud) through Broker process,
S3 protocol, or HDFS protocol.
-`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
After execution, you can use the [SHOW
EXPORT](../../../../sql-manual/sql-statements/data-modification/load-and-export/SHOW-EXPORT)
to view the progress.
+`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
-**grammar**
+## Syntax
```sql
- EXPORT TABLE table_name
- [PARTITION (p1[,p2])]
+ EXPORT TABLE <table_name>
+ [PARTITION (<partation_name>[,<partation_name>])]
Review Comment:
```suggestion
[PARTITION (<partation_name> [ , ... ])]
```
##########
docs/sql-manual/sql-statements/data-modification/load-and-export/EXPORT.md:
##########
@@ -24,43 +24,44 @@ specific language governing permissions and limitations
under the License.
-->
+
+
+
## Description
The `EXPORT` command is used to export the data of a specified table to a
designated location as a file. Currently, it supports exporting to remote
storage such as HDFS, S3, BOS, and COS (Tencent Cloud) through Broker process,
S3 protocol, or HDFS protocol.
-`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
After execution, you can use the [SHOW
EXPORT](../../../../sql-manual/sql-statements/data-modification/load-and-export/SHOW-EXPORT)
to view the progress.
+`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
-**grammar**
+## Syntax
```sql
- EXPORT TABLE table_name
- [PARTITION (p1[,p2])]
+ EXPORT TABLE <table_name>
+ [PARTITION (<partation_name>[,<partation_name>])]
[WHERE]
- TO export_path
- [opt_properties]
+ TO <export_path>
+ [<properties>]
WITH BROKER/S3/HDFS
Review Comment:
```
WITH <target_storage>
```
然后在参数中写清楚可能的枚举值。或者，使用多选一的语法
```
WITH { BROKER | S3 | HDFS }
```
##########
docs/sql-manual/sql-statements/data-modification/load-and-export/EXPORT.md:
##########
@@ -24,43 +24,44 @@ specific language governing permissions and limitations
under the License.
-->
+
+
+
## Description
The `EXPORT` command is used to export the data of a specified table to a
designated location as a file. Currently, it supports exporting to remote
storage such as HDFS, S3, BOS, and COS (Tencent Cloud) through Broker process,
S3 protocol, or HDFS protocol.
-`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
After execution, you can use the [SHOW
EXPORT](../../../../sql-manual/sql-statements/data-modification/load-and-export/SHOW-EXPORT)
to view the progress.
+`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
-**grammar**
+## Syntax
```sql
- EXPORT TABLE table_name
- [PARTITION (p1[,p2])]
+ EXPORT TABLE <table_name>
+ [PARTITION (<partation_name>[,<partation_name>])]
[WHERE]
Review Comment:
```suggestion
[ <where_clause> ]
```
##########
docs/sql-manual/sql-statements/data-modification/load-and-export/EXPORT.md:
##########
@@ -24,43 +24,44 @@ specific language governing permissions and limitations
under the License.
-->
+
+
+
## Description
The `EXPORT` command is used to export the data of a specified table to a
designated location as a file. Currently, it supports exporting to remote
storage such as HDFS, S3, BOS, and COS (Tencent Cloud) through Broker process,
S3 protocol, or HDFS protocol.
-`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
After execution, you can use the [SHOW
EXPORT](../../../../sql-manual/sql-statements/data-modification/load-and-export/SHOW-EXPORT)
to view the progress.
+`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
-**grammar**
+## Syntax
```sql
- EXPORT TABLE table_name
- [PARTITION (p1[,p2])]
+ EXPORT TABLE <table_name>
+ [PARTITION (<partation_name>[,<partation_name>])]
[WHERE]
- TO export_path
- [opt_properties]
+ TO <export_path>
+ [<properties>]
Review Comment:
1. 合理的增加空格，以方便人眼阅读
```suggestion
[ <properties> ]
```
##########
docs/sql-manual/sql-statements/data-modification/load-and-export/EXPORT.md:
##########
@@ -24,43 +24,44 @@ specific language governing permissions and limitations
under the License.
-->
+
+
+
## Description
The `EXPORT` command is used to export the data of a specified table to a
designated location as a file. Currently, it supports exporting to remote
storage such as HDFS, S3, BOS, and COS (Tencent Cloud) through Broker process,
S3 protocol, or HDFS protocol.
-`EXPORT` is an asynchronous operation, and the command submits an `EXPORT JOB`
to Doris. The task will be successfully submitted and returns immediately.
After execution, you can use the [SHOW
EXPORT](../../../../sql-manual/sql-statements/data-modification/load-and-export/SHOW-EXPORT)
to view the progress.
Review Comment:
删除的这后半句话，可以保留。把链接改对就可以了
--
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]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
