[TD-11980]<docs>: update taosdemo cmdline options (#10788)

* [TD-11980]<docs>: refine taosdemo docs

* fix param list

* refine param list

* Update docs.md

* fix taosdemo markdown

* use JSON instead of meta

* add CSV format description

* [TD-11980]<docs>: update taosdemo command line list
Co-authored-by: Nwu champion <cpwu@taosdata.com>

documentation20/cn/02.getting-started/02.taosdemo/docs.md

@@ -153,41 +153,70 @@ insert delay, avg:       8.31ms, max:     860.12ms, min:       2.00ms
 ```
 $ taosBenchmark --help
 
--f, --file=FILE The JSON configuration file to the execution procedure. Currently, we support standard UTF-8 (without BOM) encoded files only.
--u, --user=USER The user name to use when connecting to the server.
--p, --password The password to use when connecting to the server.
--c, --config-dir=CONFIG_DIR Configuration directory.
--h, --host=HOST TDengine server FQDN to connect. The default host is localhost.
--P, --port=PORT The TCP/IP port number to use for the connection.
--I, --interface=INTERFACE The interface (taosc, rest, and stmt) taosBenchmark uses. By default use 'taosc'.
--d, --database=DATABASE Destination database. By default is 'test'.
--a, --replica=REPLICA Set the replica parameters of the database, By default use 1, min: 1, max: 3.
--m, --table-prefix=TABLEPREFIX Table prefix name. By default use 'd'.
--s, --sql-file=FILE The select SQL file.
--N, --normal-table Use normal table flag.
--o, --output=FILE Direct output to the named file. By default use './output.txt'.
--q, --query-mode=MODE Query mode -- 0: SYNC, 1: ASYNC. By default use SYNC.
--b, --data-type=DATATYPE The data_type of columns, By default use: FLOAT, INT, FLOAT.
--w, --binwidth=WIDTH The width of data_type 'BINARY' or 'NCHAR'. By default use 64
--l, --columns=COLUMNS The number of columns per record. Demo mode by default is 1 (float, int, float). Max values is 4095
-All of the new column(s) type is INT. If use -b to specify column type, -l will be ignored.
--T, --threads=NUMBER The number of threads. By default use 8.
--i, --insert-interval=NUMBER The sleep time (ms) between insertion. By default is 0.
--S, --time-step=TIME_STEP The timestamp step between insertion. By default is 1.
--B, --interlace-rows=NUMBER The interlace rows of insertion. By default is 0.
--r, --rec-per-req=NUMBER The number of records per request. By default is 30000.
--t, --tables=NUMBER The number of tables. By default is 10000.
--n, --records=NUMBER The number of records per table. By default is 10000.
--M, --random The value of records generated are totally random.
-By default to simulate power equipment scenario.
--x, --aggr-func Test aggregation functions after insertion.
--y, --answer-yes Input yes for prompt.
--O, --disorder=NUMBER Insert order mode--0: In order, 1 ~ 50: disorder ratio. By default is in order.
--R, --disorder-range=NUMBER Out of order data's range. Unit is ms. By default is 1000.
--g, --debug Print debug info.
--?, --help Give this help list
---usage Give a short usage message
--V, --version Print program version.
+Usage: taosBenchmark [OPTION...]
+
+  -f, --file=FILE            (**IMPORTANT**) Set JSON configuration file(all
+                             options are going to read from this JSON file),
+                             which is mutually exclusive with other commandline
+                             options
+  -a, --replia=NUMBER        The number of replica when create database,
+                             default is 1.
+  -A, --tag-type=TAG_TYPE    Data type of tables' tags, default is
+                             INT,BINARY(16).
+  -b, --data-type=COL_TYPE   Data type of tables' cols, default is
+                             FLOAT,INT,FLOAT.
+  -B, --interlace-rows=NUMBER   The number of interlace rows insert into
+                             tables, default is 0
+  -c, --config-dir=CONFIG_DIR   Configuration directory.
+  -C, --chinese              Nchar and binary are basic unicode chinese
+                             characters, optional.
+  -d, --database=DATABASE    Name of database, default is test.
+  -E, --escape-character     Use escape character in stable and child table
+                             name, optional.
+  -F, --prepared_rand=NUMBER Random data source size, default is 10000.
+  -g, --debug                Debug mode, optional.
+  -G, --performance           Performance mode, optional.
+  -h, --host=HOST            TDengine server FQDN to connect, default is
+                             localhost.
+  -i, --insert-interval=NUMBER   Insert interval for interlace mode in
+                             milliseconds, default is 0.
+  -I, --interface=IFACE      insert mode, default is taosc, options:
+                             taosc|rest|stmt|sml
+  -l, --columns=NUMBER       Number of INT data type columns in table, default
+                             is 0.
+  -m, --table-prefix=TABLE_PREFIX
+                             Prefix of child table name, default is d.
+  -M, --random               Data source is randomly generated, optional.
+  -n, --records=NUMBER       Number of records for each table, default is
+                             10000.
+  -N, --normal-table         Only create normal table without super table,
+                             optional.
+  -o, --output=FILE          The path of result output file, default is
+                             ./output.txt.
+  -O, --disorder=NUMBER      Ratio of inserting data with disorder timestamp,
+                             default is 0.
+  -p, --password=PASSWORD    The password to use when connecting to the server,
+                             default is taosdata.
+  -P, --port=PORT            The TCP/IP port number to use for the connection,
+                             default is 6030.
+  -r, --rec-per-req=NUMBER   Number of records in each insert request, default
+                             is 30000.
+  -R, --disorder-range=NUMBER   Range of disordered timestamp, default is 1000.
+
+  -S, --time-step=NUMBER     Timestamp step in milliseconds, default is 1.
+  -t, --tables=NUMBER        Number of child tables, default is 10000.
+  -T, --threads=NUMBER       The number of thread when insert data, default is
+                             8.
+  -u, --user=USER            The user name to use when connecting to the
+                             server, default is root.
+  -w, --binwidth=NUMBER      The default length of nchar and binary if not
+                             specified, default is 64.
+  -x, --aggr-func            Query aggregation function after insertion,
+                             optional.
+  -y, --answer-yes           Pass confirmation prompt to continue, optional.
+  -?, --help                 Give this help list
+      --usage                Give a short usage message
+  -V, --version              Print program version
 
 Mandatory or optional arguments to long options are also mandatory or optional
 for any corresponding short options.
@@ -198,7 +227,7 @@ Report bugs to <support@taosdata.com>.
 taosBenchmark 的参数是为了满足数据模拟的需求来设计的。下面介绍几个常用的参数：
 
 ```
--I, --interface=INTERFACE     The interface (taosc, rest, and stmt) taosBenchmark uses. Default is 'taosc'.
+-I, --interface=IFACE     The interface (taosc, rest, and stmt) taosBenchmark uses. Default is 'taosc'.
 ```
 
 前面介绍 taosBenchmark 不同接口的性能差异已经提到， -I 参数为选择不同的接口，目前支持 taosc、stmt 和 rest 几种。其中 taosc 为使用 SQL 语句方式进行数据写入；stmt 为使用参数绑定接口进行数据写入；rest 为使用 RESTful 协议进行数据写入。

documentation20/en/02.getting-started/02.taosdemo/docs.md

@@ -160,41 +160,70 @@ The complete list of taosBenchmark command-line arguments can be displayed via t
 ```
 $ taosBenchmark --help
 
--f, --file=FILE The JSON configuration file to the execution procedure. Currently, we support standard UTF-8 (without BOM) encoded files only.
--u, --user=USER The user name to use when connecting to the server.
--p, --password The password to use when connecting to the server.
--c, --config-dir=CONFIG_DIR Configuration directory.
--h, --host=HOST TDengine server FQDN to connect. The default host is localhost.
--P, --port=PORT The TCP/IP port number to use for the connection.
--I, --interface=INTERFACE The interface (taosc, rest, and stmt) taosBenchmark uses. By default use 'taosc'.
--d, --database=DATABASE Destination database. By default is 'test'.
--a, --replica=REPLICA Set the replica parameters of the database, By default use 1, min: 1, max: 3.
--m, --table-prefix=TABLEPREFIX Table prefix name. By default use 'd'.
--s, --sql-file=FILE The select SQL file.
--N, --normal-table Use normal table flag.
--o, --output=FILE Direct output to the named file. By default use './output.txt'.
--q, --query-mode=MODE Query mode -- 0: SYNC, 1: ASYNC. By default use SYNC.
--b, --data-type=DATATYPE The data_type of columns, By default use: FLOAT, INT, FLOAT.
--w, --binwidth=WIDTH The width of data_type 'BINARY' or 'NCHAR'. By default use 64
--l, --columns=COLUMNS The number of columns per record. Demo mode by default is 1 (float, int, float). Max values is 4095
-All of the new column(s) type is INT. If use -b to specify column type, -l will be ignored.
--T, --threads=NUMBER The number of threads. By default use 8.
--i, --insert-interval=NUMBER The sleep time (ms) between insertion. By default is 0.
--S, --time-step=TIME_STEP The timestamp step between insertion. By default is 1.
--B, --interlace-rows=NUMBER The interlace rows of insertion. By default is 0.
--r, --rec-per-req=NUMBER The number of records per request. By default is 30000.
--t, --tables=NUMBER The number of tables. By default is 10000.
--n, --records=NUMBER The number of records per table. By default is 10000.
--M, --random The value of records generated are totally random.
-By default to simulate power equipment scenario.
--x, --aggr-func Test aggregation functions after insertion.
--y, --answer-yes Input yes for prompt.
--O, --disorder=NUMBER Insert order mode--0: In order, 1 ~ 50: disorder ratio. By default is in order.
--R, --disorder-range=NUMBER Out of order data's range. Unit is ms. By default is 1000.
--g, --debug Print debug info.
--?, --help Give this help list
---usage Give a short usage message
--V, --version Print program version.
+Usage: taosBenchmark [OPTION...]
+
+  -f, --file=FILE            (**IMPORTANT**) Set JSON configuration file(all
+                             options are going to read from this JSON file),
+                             which is mutually exclusive with other commandline
+                             options
+  -a, --replia=NUMBER        The number of replica when create database,
+                             default is 1.
+  -A, --tag-type=TAG_TYPE    Data type of tables' tags, default is
+                             INT,BINARY(16).
+  -b, --data-type=COL_TYPE   Data type of tables' cols, default is
+                             FLOAT,INT,FLOAT.
+  -B, --interlace-rows=NUMBER   The number of interlace rows insert into
+                             tables, default is 0
+  -c, --config-dir=CONFIG_DIR   Configuration directory.
+  -C, --chinese              Nchar and binary are basic unicode chinese
+                             characters, optional.
+  -d, --database=DATABASE    Name of database, default is test.
+  -E, --escape-character     Use escape character in stable and child table
+                             name, optional.
+  -F, --prepared_rand=NUMBER Random data source size, default is 10000.
+  -g, --debug                Debug mode, optional.
+  -G, --performance           Performance mode, optional.
+  -h, --host=HOST            TDengine server FQDN to connect, default is
+                             localhost.
+  -i, --insert-interval=NUMBER   Insert interval for interlace mode in
+                             milliseconds, default is 0.
+  -I, --interface=IFACE      insert mode, default is taosc, options:
+                             taosc|rest|stmt|sml
+  -l, --columns=NUMBER       Number of INT data type columns in table, default
+                             is 0.
+  -m, --table-prefix=TABLE_PREFIX
+                             Prefix of child table name, default is d.
+  -M, --random               Data source is randomly generated, optional.
+  -n, --records=NUMBER       Number of records for each table, default is
+                             10000.
+  -N, --normal-table         Only create normal table without super table,
+                             optional.
+  -o, --output=FILE          The path of result output file, default is
+                             ./output.txt.
+  -O, --disorder=NUMBER      Ratio of inserting data with disorder timestamp,
+                             default is 0.
+  -p, --password=PASSWORD    The password to use when connecting to the server,
+                             default is taosdata.
+  -P, --port=PORT            The TCP/IP port number to use for the connection,
+                             default is 6030.
+  -r, --rec-per-req=NUMBER   Number of records in each insert request, default
+                             is 30000.
+  -R, --disorder-range=NUMBER   Range of disordered timestamp, default is 1000.
+
+  -S, --time-step=NUMBER     Timestamp step in milliseconds, default is 1.
+  -t, --tables=NUMBER        Number of child tables, default is 10000.
+  -T, --threads=NUMBER       The number of thread when insert data, default is
+                             8.
+  -u, --user=USER            The user name to use when connecting to the
+                             server, default is root.
+  -w, --binwidth=NUMBER      The default length of nchar and binary if not
+                             specified, default is 64.
+  -x, --aggr-func            Query aggregation function after insertion,
+                             optional.
+  -y, --answer-yes           Pass confirmation prompt to continue, optional.
+  -?, --help                 Give this help list
+      --usage                Give a short usage message
+  -V, --version              Print program version
 
 Mandatory or optional arguments to long options are also mandatory or optional
 for any corresponding short options.
@@ -205,7 +234,7 @@ Report bugs to <support@taosdata.com>.
 taosBenchmark's parameters are designed to meet the needs of data simulation. A few commonly used parameters are described below.
 
 ```
--I, --interface=INTERFACE     The interface (taosc, rest, and stmt) taosBenchmark uses. Default is 'taosc'.
+-I, --interface=IFACE     The interface (taosc, rest, and stmt) taosBenchmark uses. Default is 'taosc'.
 ```
 
 The performance difference between different interfaces of taosBenchmark has been mentioned earlier, the -I parameter is used to select different interfaces, currently taosc, stmt and rest are supported. The -I parameter is used to select different interfaces, currently taosc, stmt and rest are supported. taosc uses SQL statements to write data, stmt uses parameter binding interface to write data, and rest uses RESTful protocol to write data.