sql: update parameters and examples of load data (#2752)

sql-statements/sql-statement-load-data.md

@@ -15,10 +15,46 @@ The `LOAD DATA` statement batch loads data into a TiDB table.
 
 ![LoadDataStmt](/media/sqlgram/LoadDataStmt.png)
 
+## Parameters
+
+### `Fields` and `Lines`
+
+You can specify how to process the data format by configuring the `Fields` and `Lines` parameters.
+
+- `FIELDS TERMINATED BY`: Specifies the separating character of each data.
+- `FIELDS ENCLOSED BY`: Specifies the enclosing character of each data.
+- `LINES TERMINATED BY`: Specifies the line terminator, if you want to end a line with a certain character.
+
+Take the following data format as an example:
+
+```
+"bob","20","street 1"\r\n
+"alice","33","street 1"\r\n
+```
+
+If you want to extract `bob`, `20`, and `street 1`, specify the separating character as `','`, and the enclosing character as `'\"'`:
+
+```sql
+FIELDS TERMINATED BY ',' ENCLOSED BY '\"' LINES TERMINATED BY '\r\n'
+```
+
+If you do not specify the parameters above, the imported data is processed in the following way by default:
+
+```sql
+FIELDS TERMINATED BY '\t' ENCLOSED BY ''
+LINES TERMINATED BY '\n'
+```
+
+### `IGNORE number LINES`
+
+You can ignore the first `number` lines of a file by configuring the `IGNORE number LINES` parameter. For example, if you configure `IGNORE 1 LINES`, the first line of a file is ignored.
+
 ## Examples
 
+{{< copyable "sql" >}}
+
 ```sql
-mysql> CREATE TABLE trips (
+CREATE TABLE trips (
     ->  trip_id bigint NOT NULL PRIMARY KEY AUTO_INCREMENT,
     ->  duration integer not null,
     ->  start_date datetime,
@@ -30,10 +66,23 @@ mysql> CREATE TABLE trips (
     ->  bike_number varchar(255),
     ->  member_type varchar(255)
     -> );
+```
+
+```
 Query OK, 0 rows affected (0.14 sec)
+```
+
+The following example imports data using `LOAD DATA`. Comma is specified as the separating character. The double quotation marks that enclose the data is ignored. The first line of the file is ignored.
 
-mysql> LOAD DATA LOCAL INFILE '/mnt/evo970/data-sets/bikeshare-data/2017Q4-capitalbikeshare-tripdata.csv' INTO TABLE trips FIELDS TERMINATED BY ',' ENCLOSED BY '\"' LINES TERMINATED BY '\r\n' IGNORE 1 LINES (duration, start_date, end_date, start_station_number, start_station, end_station_number, end_station, bike_number, member_type);
+If you see the error message `ERROR 1148 (42000): the used command is not allowed with this TiDB version`, refer to [ERROR 1148 (42000): the used command is not allowed with this TiDB version](/faq/tidb-faq.md#error-1148-42000-the-used-command-is-not-allowed-with-this-tidb-version).
 
+{{< copyable "sql" >}}
+
+```
+LOAD DATA LOCAL INFILE '/mnt/evo970/data-sets/bikeshare-data/2017Q4-capitalbikeshare-tripdata.csv' INTO TABLE trips FIELDS TERMINATED BY ',' ENCLOSED BY '\"' LINES TERMINATED BY '\r\n' IGNORE 1 LINES (duration, start_date, end_date, start_station_number, start_station, end_station_number, end_station, bike_number, member_type);
+```
+
+```
 Query OK, 815264 rows affected (39.63 sec)
 Records: 815264  Deleted: 0  Skipped: 0  Warnings: 0
 ```