This is an automated email from the ASF dual-hosted git repository.

wanghailin pushed a commit to branch dev
in repository https://gitbox.apache.org/repos/asf/seatunnel.git


The following commit(s) were added to refs/heads/dev by this push:
     new 67d0cdc9bc Improve file sink doc (#5799)
67d0cdc9bc is described below

commit 67d0cdc9bc863279a6bf3b6d136712e705437769
Author: Eric <[email protected]>
AuthorDate: Tue Nov 7 20:01:27 2023 +0800

    Improve file sink doc (#5799)
---
 docs/en/connector-v2/sink/CosFile.md      | 49 +++++++++++++++--------------
 docs/en/connector-v2/sink/FtpFile.md      | 52 ++++++++++++++++---------------
 docs/en/connector-v2/sink/HdfsFile.md     |  1 +
 docs/en/connector-v2/sink/LocalFile.md    | 43 ++++++++++++-------------
 docs/en/connector-v2/sink/OssFile.md      | 49 +++++++++++++++--------------
 docs/en/connector-v2/sink/OssJindoFile.md | 49 +++++++++++++++--------------
 docs/en/connector-v2/sink/S3File.md       |  1 +
 docs/en/connector-v2/sink/SftpFile.md     | 52 ++++++++++++++++---------------
 8 files changed, 153 insertions(+), 143 deletions(-)

diff --git a/docs/en/connector-v2/sink/CosFile.md 
b/docs/en/connector-v2/sink/CosFile.md
index 563b174c3c..0535401734 100644
--- a/docs/en/connector-v2/sink/CosFile.md
+++ b/docs/en/connector-v2/sink/CosFile.md
@@ -32,30 +32,31 @@ By default, we use 2PC commit to ensure `exactly-once`
 
 ## Options
 
-|               name               |  type   | required |               
default value                |                          remarks                 
         |
-|----------------------------------|---------|----------|--------------------------------------------|-----------------------------------------------------------|
-| path                             | string  | yes      | -                    
                      |                                                         
  |
-| bucket                           | string  | yes      | -                    
                      |                                                         
  |
-| secret_id                        | string  | yes      | -                    
                      |                                                         
  |
-| secret_key                       | string  | yes      | -                    
                      |                                                         
  |
-| region                           | string  | yes      | -                    
                      |                                                         
  |
-| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
  |
-| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
  |
-| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
  |
-| file_format_type                 | string  | no       | "csv"                
                      |                                                         
  |
-| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format is text                      
  |
-| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format is text                      
  |
-| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
  |
-| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
  |
-| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                     |
-| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
  |
-| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns |
-| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
  |
-| batch_size                       | int     | no       | 1000000              
                      |                                                         
  |
-| compress_codec                   | string  | no       | none                 
                      |                                                         
  |
-| common-options                   | object  | no       | -                    
                      |                                                         
  |
-| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format is excel.                    
  |
-| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format is excel.             
         |
+|               name               |  type   | required |               
default value                |                                                  
    remarks                                                      |
+|----------------------------------|---------|----------|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
+| path                             | string  | yes      | -                    
                      |                                                         
                                                          |
+| tmp_path                         | string  | no       | /tmp/seatunnel       
                      | The result file will write to a tmp path first and then 
use `mv` to submit tmp dir to target dir. Need a COS dir. |
+| bucket                           | string  | yes      | -                    
                      |                                                         
                                                          |
+| secret_id                        | string  | yes      | -                    
                      |                                                         
                                                          |
+| secret_key                       | string  | yes      | -                    
                      |                                                         
                                                          |
+| region                           | string  | yes      | -                    
                      |                                                         
                                                          |
+| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
                                                          |
+| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
                                                          |
+| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
                                                          |
+| file_format_type                 | string  | no       | "csv"                
                      |                                                         
                                                          |
+| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format is text                      
                                                          |
+| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format is text                      
                                                          |
+| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
                                                          |
+| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
                                                          |
+| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                                                                            
 |
+| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
                                                          |
+| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns                                                         |
+| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
                                                          |
+| batch_size                       | int     | no       | 1000000              
                      |                                                         
                                                          |
+| compress_codec                   | string  | no       | none                 
                      |                                                         
                                                          |
+| common-options                   | object  | no       | -                    
                      |                                                         
                                                          |
+| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format is excel.                    
                                                          |
+| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format is excel.             
                                                                 |
 
 ### path [string]
 
diff --git a/docs/en/connector-v2/sink/FtpFile.md 
b/docs/en/connector-v2/sink/FtpFile.md
index 8b3214e44b..ab55b6e4da 100644
--- a/docs/en/connector-v2/sink/FtpFile.md
+++ b/docs/en/connector-v2/sink/FtpFile.md
@@ -30,30 +30,31 @@ By default, we use 2PC commit to ensure `exactly-once`
 
 ## Options
 
-|               name               |  type   | required |               
default value                |                          remarks                 
         |
-|----------------------------------|---------|----------|--------------------------------------------|-----------------------------------------------------------|
-| host                             | string  | yes      | -                    
                      |                                                         
  |
-| port                             | int     | yes      | -                    
                      |                                                         
  |
-| username                         | string  | yes      | -                    
                      |                                                         
  |
-| password                         | string  | yes      | -                    
                      |                                                         
  |
-| path                             | string  | yes      | -                    
                      |                                                         
  |
-| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
  |
-| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
  |
-| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
  |
-| file_format_type                 | string  | no       | "csv"                
                      |                                                         
  |
-| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
  |
-| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
  |
-| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
  |
-| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
  |
-| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                     |
-| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
  |
-| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns |
-| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
  |
-| batch_size                       | int     | no       | 1000000              
                      |                                                         
  |
-| compress_codec                   | string  | no       | none                 
                      |                                                         
  |
-| common-options                   | object  | no       | -                    
                      |                                                         
  |
-| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
  |
-| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
         |
+|               name               |  type   | required |               
default value                |                                                  
    remarks                                                      |
+|----------------------------------|---------|----------|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
+| host                             | string  | yes      | -                    
                      |                                                         
                                                          |
+| port                             | int     | yes      | -                    
                      |                                                         
                                                          |
+| username                         | string  | yes      | -                    
                      |                                                         
                                                          |
+| password                         | string  | yes      | -                    
                      |                                                         
                                                          |
+| path                             | string  | yes      | -                    
                      |                                                         
                                                          |
+| tmp_path                         | string  | yes      | /tmp/seatunnel       
                      | The result file will write to a tmp path first and then 
use `mv` to submit tmp dir to target dir. Need a FTP dir. |
+| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
                                                          |
+| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
                                                          |
+| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
                                                          |
+| file_format_type                 | string  | no       | "csv"                
                      |                                                         
                                                          |
+| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
                                                          |
+| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
                                                          |
+| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
                                                          |
+| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
                                                          |
+| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                                                                            
 |
+| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
                                                          |
+| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns                                                         |
+| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
                                                          |
+| batch_size                       | int     | no       | 1000000              
                      |                                                         
                                                          |
+| compress_codec                   | string  | no       | none                 
                      |                                                         
                                                          |
+| common-options                   | object  | no       | -                    
                      |                                                         
                                                          |
+| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
                                                          |
+| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
                                                                 |
 
 ### host [string]
 
@@ -215,7 +216,8 @@ FtpFile {
     port = 21
     username = "username"
     password = "password"
-    path = "/data/ftp"
+    path = "/data/ftp/seatunnel/job1"
+    tmp_path = "/data/ftp/seatunnel/tmp"
     file_format_type = "text"
     field_delimiter = "\t"
     row_delimiter = "\n"
diff --git a/docs/en/connector-v2/sink/HdfsFile.md 
b/docs/en/connector-v2/sink/HdfsFile.md
index d20a6f8acc..8d1d8e1088 100644
--- a/docs/en/connector-v2/sink/HdfsFile.md
+++ b/docs/en/connector-v2/sink/HdfsFile.md
@@ -40,6 +40,7 @@ Output data to hdfs file
 
|----------------------------------|---------|----------|--------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 [...]
 | fs.defaultFS                     | string  | yes      | -                    
                      | The hadoop cluster address that start with `hdfs://`, 
for example: `hdfs://hadoopcluster`                                             
                                                                                
                                                                                
                                                                                
                [...]
 | path                             | string  | yes      | -                    
                      | The target dir path is required.                        
                                                                                
                                                                                
                                                                                
                                                                                
              [...]
+| tmp_path                         | string  | yes      | /tmp/seatunnel       
                      | The result file will write to a tmp path first and then 
use `mv` to submit tmp dir to target dir. Need a hdfs path.                     
                                                                                
                                                                                
                                                                                
              [...]
 | hdfs_site_path                   | string  | no       | -                    
                      | The path of `hdfs-site.xml`, used to load ha 
configuration of namenodes                                                      
                                                                                
                                                                                
                                                                                
                         [...]
 | custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
                                                                                
                                                                                
                                                                                
                                                                                
              [...]
 | file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when `custom_filename` is 
`true`.`file_name_expression` describes the file expression which will be 
created into the `path`. We can add the variable `${now}` or `${uuid}` in the 
`file_name_expression`, like `test_${uuid}_${now}`,`${now}` represents the 
current time, and its format can be defined by specifying the option 
`filename_time_format`.Please note that, If `is_enable_tr [...]
diff --git a/docs/en/connector-v2/sink/LocalFile.md 
b/docs/en/connector-v2/sink/LocalFile.md
index 90e80c6c37..d7a183a4ae 100644
--- a/docs/en/connector-v2/sink/LocalFile.md
+++ b/docs/en/connector-v2/sink/LocalFile.md
@@ -30,27 +30,28 @@ By default, we use 2PC commit to ensure `exactly-once`
 
 ## Options
 
-|               name               |  type   | required |               
default value                |                                            
remarks                                            |
-|----------------------------------|---------|----------|--------------------------------------------|-----------------------------------------------------------------------------------------------|
-| path                             | string  | yes      | -                    
                      |                                                         
                                      |
-| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
                                      |
-| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
                                      |
-| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
                                      |
-| file_format_type                 | string  | no       | "csv"                
                      |                                                         
                                      |
-| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
                                      |
-| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
                                      |
-| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
                                      |
-| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
                                      |
-| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                                                         |
-| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
                                      |
-| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns                                     |
-| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
                                      |
-| batch_size                       | int     | no       | 1000000              
                      |                                                         
                                      |
-| compress_codec                   | string  | no       | none                 
                      |                                                         
                                      |
-| common-options                   | object  | no       | -                    
                      |                                                         
                                      |
-| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
                                      |
-| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
                                             |
-| enable_header_write              | boolean | no       | false                
                      | Only used when file_format_type is text,csv.<br/> 
false:don't write header,true:write header. |
+|               name               |  type   | required |               
default value                |                                              
remarks                                              |
+|----------------------------------|---------|----------|--------------------------------------------|---------------------------------------------------------------------------------------------------|
+| path                             | string  | yes      | -                    
                      |                                                         
                                          |
+| tmp_path                         | string  | no       | /tmp/seatunnel       
                      | The result file will write to a tmp path first and then 
use `mv` to submit tmp dir to target dir. |
+| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
                                          |
+| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
                                          |
+| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
                                          |
+| file_format_type                 | string  | no       | "csv"                
                      |                                                         
                                          |
+| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
                                          |
+| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
                                          |
+| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
                                          |
+| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
                                          |
+| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                                                             |
+| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
                                          |
+| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns                                         |
+| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
                                          |
+| batch_size                       | int     | no       | 1000000              
                      |                                                         
                                          |
+| compress_codec                   | string  | no       | none                 
                      |                                                         
                                          |
+| common-options                   | object  | no       | -                    
                      |                                                         
                                          |
+| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
                                          |
+| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
                                                 |
+| enable_header_write              | boolean | no       | false                
                      | Only used when file_format_type is text,csv.<br/> 
false:don't write header,true:write header.     |
 
 ### path [string]
 
diff --git a/docs/en/connector-v2/sink/OssFile.md 
b/docs/en/connector-v2/sink/OssFile.md
index a3095ecfd1..c723d4a836 100644
--- a/docs/en/connector-v2/sink/OssFile.md
+++ b/docs/en/connector-v2/sink/OssFile.md
@@ -33,30 +33,31 @@ By default, we use 2PC commit to ensure `exactly-once`
 
 ## Options
 
-|               name               |  type   | required |               
default value                |                          remarks                 
         |
-|----------------------------------|---------|----------|--------------------------------------------|-----------------------------------------------------------|
-| path                             | string  | yes      | -                    
                      |                                                         
  |
-| bucket                           | string  | yes      | -                    
                      |                                                         
  |
-| access_key                       | string  | yes      | -                    
                      |                                                         
  |
-| access_secret                    | string  | yes      | -                    
                      |                                                         
  |
-| endpoint                         | string  | yes      | -                    
                      |                                                         
  |
-| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
  |
-| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
  |
-| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
  |
-| file_format_type                 | string  | no       | "csv"                
                      |                                                         
  |
-| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
  |
-| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
  |
-| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
  |
-| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
  |
-| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                     |
-| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
  |
-| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns |
-| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
  |
-| batch_size                       | int     | no       | 1000000              
                      |                                                         
  |
-| compress_codec                   | string  | no       | none                 
                      |                                                         
  |
-| common-options                   | object  | no       | -                    
                      |                                                         
  |
-| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
  |
-| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
         |
+|               name               |  type   | required |               
default value                |                                                  
    remarks                                                      |
+|----------------------------------|---------|----------|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
+| path                             | string  | yes      | -                    
                      |                                                         
                                                          |
+| tmp_path                         | string  | no       | /tmp/seatunnel       
                      | The result file will write to a tmp path first and then 
use `mv` to submit tmp dir to target dir. Need a OSS dir. |
+| bucket                           | string  | yes      | -                    
                      |                                                         
                                                          |
+| access_key                       | string  | yes      | -                    
                      |                                                         
                                                          |
+| access_secret                    | string  | yes      | -                    
                      |                                                         
                                                          |
+| endpoint                         | string  | yes      | -                    
                      |                                                         
                                                          |
+| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
                                                          |
+| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
                                                          |
+| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
                                                          |
+| file_format_type                 | string  | no       | "csv"                
                      |                                                         
                                                          |
+| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
                                                          |
+| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
                                                          |
+| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
                                                          |
+| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
                                                          |
+| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                                                                            
 |
+| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
                                                          |
+| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns                                                         |
+| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
                                                          |
+| batch_size                       | int     | no       | 1000000              
                      |                                                         
                                                          |
+| compress_codec                   | string  | no       | none                 
                      |                                                         
                                                          |
+| common-options                   | object  | no       | -                    
                      |                                                         
                                                          |
+| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
                                                          |
+| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
                                                                 |
 
 ### path [string]
 
diff --git a/docs/en/connector-v2/sink/OssJindoFile.md 
b/docs/en/connector-v2/sink/OssJindoFile.md
index b37628f923..eb4e81a8fb 100644
--- a/docs/en/connector-v2/sink/OssJindoFile.md
+++ b/docs/en/connector-v2/sink/OssJindoFile.md
@@ -36,30 +36,31 @@ By default, we use 2PC commit to ensure `exactly-once`
 
 ## Options
 
-|               name               |  type   | required |               
default value                |                          remarks                 
         |
-|----------------------------------|---------|----------|--------------------------------------------|-----------------------------------------------------------|
-| path                             | string  | yes      | -                    
                      |                                                         
  |
-| bucket                           | string  | yes      | -                    
                      |                                                         
  |
-| access_key                       | string  | yes      | -                    
                      |                                                         
  |
-| access_secret                    | string  | yes      | -                    
                      |                                                         
  |
-| endpoint                         | string  | yes      | -                    
                      |                                                         
  |
-| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
  |
-| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
  |
-| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
  |
-| file_format_type                 | string  | no       | "csv"                
                      |                                                         
  |
-| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
  |
-| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
  |
-| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
  |
-| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
  |
-| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                     |
-| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
  |
-| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns |
-| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
  |
-| batch_size                       | int     | no       | 1000000              
                      |                                                         
  |
-| compress_codec                   | string  | no       | none                 
                      |                                                         
  |
-| common-options                   | object  | no       | -                    
                      |                                                         
  |
-| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
  |
-| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
         |
+|               name               |  type   | required |               
default value                |                                                  
    remarks                                                      |
+|----------------------------------|---------|----------|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
+| path                             | string  | yes      | -                    
                      |                                                         
                                                          |
+| tmp_path                         | string  | no       | /tmp/seatunnel       
                      | The result file will write to a tmp path first and then 
use `mv` to submit tmp dir to target dir. Need a OSS dir. |
+| bucket                           | string  | yes      | -                    
                      |                                                         
                                                          |
+| access_key                       | string  | yes      | -                    
                      |                                                         
                                                          |
+| access_secret                    | string  | yes      | -                    
                      |                                                         
                                                          |
+| endpoint                         | string  | yes      | -                    
                      |                                                         
                                                          |
+| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
                                                          |
+| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
                                                          |
+| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
                                                          |
+| file_format_type                 | string  | no       | "csv"                
                      |                                                         
                                                          |
+| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
                                                          |
+| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
                                                          |
+| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
                                                          |
+| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
                                                          |
+| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                                                                            
 |
+| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
                                                          |
+| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns                                                         |
+| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
                                                          |
+| batch_size                       | int     | no       | 1000000              
                      |                                                         
                                                          |
+| compress_codec                   | string  | no       | none                 
                      |                                                         
                                                          |
+| common-options                   | object  | no       | -                    
                      |                                                         
                                                          |
+| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
                                                          |
+| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
                                                                 |
 
 ### path [string]
 
diff --git a/docs/en/connector-v2/sink/S3File.md 
b/docs/en/connector-v2/sink/S3File.md
index 4bb670ae38..483bc6d36d 100644
--- a/docs/en/connector-v2/sink/S3File.md
+++ b/docs/en/connector-v2/sink/S3File.md
@@ -93,6 +93,7 @@ If write to `csv`, `text` file type, All column will be 
string.
 |               name               |  type   | required |                     
default value                     |                                             
                                 Description                                    
                                          |
 
|----------------------------------|---------|----------|-------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | path                             | string  | yes      | -                    
                                 |                                              
                                                                                
                                         |
+| tmp_path                         | string  | no       | /tmp/seatunnel       
                                 | The result file will write to a tmp path 
first and then use `mv` to submit tmp dir to target dir. Need a S3 dir.         
                                             |
 | bucket                           | string  | yes      | -                    
                                 |                                              
                                                                                
                                         |
 | fs.s3a.endpoint                  | string  | yes      | -                    
                                 |                                              
                                                                                
                                         |
 | fs.s3a.aws.credentials.provider  | string  | yes      | 
com.amazonaws.auth.InstanceProfileCredentialsProvider | The way to authenticate 
s3a. We only support `org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider` 
and `com.amazonaws.auth.InstanceProfileCredentialsProvider` now. |
diff --git a/docs/en/connector-v2/sink/SftpFile.md 
b/docs/en/connector-v2/sink/SftpFile.md
index b6460f39e3..7bb3f12559 100644
--- a/docs/en/connector-v2/sink/SftpFile.md
+++ b/docs/en/connector-v2/sink/SftpFile.md
@@ -30,30 +30,31 @@ By default, we use 2PC commit to ensure `exactly-once`
 
 ## Options
 
-|               name               |  type   | required |               
default value                |                          remarks                 
         |
-|----------------------------------|---------|----------|--------------------------------------------|-----------------------------------------------------------|
-| host                             | string  | yes      | -                    
                      |                                                         
  |
-| port                             | int     | yes      | -                    
                      |                                                         
  |
-| username                         | string  | yes      | -                    
                      |                                                         
  |
-| password                         | string  | yes      | -                    
                      |                                                         
  |
-| path                             | string  | yes      | -                    
                      |                                                         
  |
-| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
  |
-| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
  |
-| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
  |
-| file_format_type                 | string  | no       | "csv"                
                      |                                                         
  |
-| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
  |
-| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
  |
-| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
  |
-| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
  |
-| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                     |
-| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
  |
-| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns |
-| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
  |
-| batch_size                       | int     | no       | 1000000              
                      |                                                         
  |
-| compress_codec                   | string  | no       | none                 
                      |                                                         
  |
-| common-options                   | object  | no       | -                    
                      |                                                         
  |
-| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
  |
-| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
         |
+|               name               |  type   | required |               
default value                |                                                  
    remarks                                                      |
+|----------------------------------|---------|----------|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
+| host                             | string  | yes      | -                    
                      |                                                         
                                                          |
+| port                             | int     | yes      | -                    
                      |                                                         
                                                          |
+| username                         | string  | yes      | -                    
                      |                                                         
                                                          |
+| password                         | string  | yes      | -                    
                      |                                                         
                                                          |
+| path                             | string  | yes      | -                    
                      |                                                         
                                                          |
+| tmp_path                         | string  | yes      | /tmp/seatunnel       
                      | The result file will write to a tmp path first and then 
use `mv` to submit tmp dir to target dir. Need a FTP dir. |
+| custom_filename                  | boolean | no       | false                
                      | Whether you need custom the filename                    
                                                          |
+| file_name_expression             | string  | no       | "${transactionId}"   
                      | Only used when custom_filename is true                  
                                                          |
+| filename_time_format             | string  | no       | "yyyy.MM.dd"         
                      | Only used when custom_filename is true                  
                                                          |
+| file_format_type                 | string  | no       | "csv"                
                      |                                                         
                                                          |
+| field_delimiter                  | string  | no       | '\001'               
                      | Only used when file_format_type is text                 
                                                          |
+| row_delimiter                    | string  | no       | "\n"                 
                      | Only used when file_format_type is text                 
                                                          |
+| have_partition                   | boolean | no       | false                
                      | Whether you need processing partitions.                 
                                                          |
+| partition_by                     | array   | no       | -                    
                      | Only used then have_partition is true                   
                                                          |
+| partition_dir_expression         | string  | no       | 
"${k0}=${v0}/${k1}=${v1}/.../${kn}=${vn}/" | Only used then have_partition is 
true                                                                            
 |
+| is_partition_field_write_in_file | boolean | no       | false                
                      | Only used then have_partition is true                   
                                                          |
+| sink_columns                     | array   | no       |                      
                      | When this parameter is empty, all fields are sink 
columns                                                         |
+| is_enable_transaction            | boolean | no       | true                 
                      |                                                         
                                                          |
+| batch_size                       | int     | no       | 1000000              
                      |                                                         
                                                          |
+| compress_codec                   | string  | no       | none                 
                      |                                                         
                                                          |
+| common-options                   | object  | no       | -                    
                      |                                                         
                                                          |
+| max_rows_in_memory               | int     | no       | -                    
                      | Only used when file_format_type is excel.               
                                                          |
+| sheet_name                       | string  | no       | Sheet${Random 
number}                      | Only used when file_format_type is excel.        
                                                                 |
 
 ### host [string]
 
@@ -197,7 +198,8 @@ SftpFile {
     port = 22
     username = "username"
     password = "password"
-    path = "/data/sftp"
+    path = "/data/sftp/seatunnel/job1"
+    tmp_path = "/data/sftp/seatunnel/tmp"
     file_format_type = "text"
     field_delimiter = "\t"
     row_delimiter = "\n"

Reply via email to