[RoutineLoad] Support modify routine load job (#4158)

Support ALTER ROUTINE LOAD JOB stmt, for example: ``` alter routine load db1.label1 properties ( "desired_concurrent_number"="3", "max_batch_interval" = "5", "max_batch_rows" = "300000", "max_batch_size" = "209715200", "strict_mode" = "false", "timezone" = "+08:00" ) ``` Details can be found in `alter-routine-load.md`
2020-08-06 23:11:02 +08:00
parent c98b411500
commit 237c0807a4
24 changed files with 1316 additions and 157 deletions
--- a/docs/en/sql-reference/sql-statements/Data
+++ b/docs/en/sql-reference/sql-statements/Data
@ -0,0 +1,111 @@
+---
+{
+    "title": "ALTER ROUTINE LOAD",
+    "language": "en"
+}
+---
+
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# ALTER ROUTINE LOAD
+## description
+
+This syntax is used to modify a routine import job that has been created.
+
+Only jobs in the PAUSED state can be modified.
+
+Syntax:
+
+    ALTER ROUTINE LOAD FOR [db.]job_name
+    [job_properties]
+    FROM data_source
+    [data_source_properties]
+
+1. `[db.]job_name`
+
+    Specify the name of the job to be modified.
+
+2. `job_properties`
+
+    Specify the job parameters that need to be modified. Currently only supports the modification of the following parameters:
+    
+    1. `desired_concurrent_number`
+    2. `max_error_number`
+    3. `max_batch_interval`
+    4. `max_batch_rows`
+    5. `max_batch_size`
+    6. `jsonpaths`
+    7. `json_root`
+    8. `strip_outer_array`
+    9. `strict_mode`
+    10. `timezone`
+
+
+3. `data_source`
+
+    The type of data source. Currently supported:
+
+    KAFKA
+
+4. `data_source_properties`
+
+    The relevant attributes of the data source. Currently only supports:
+    
+    1. `kafka_partitions`
+    2. `kafka_offsets`
+    3. Custom property, such as `property.group.id`
+    
+    Notice：
+    
+    1. `kafka_partitions` and `kafka_offsets` are used to modify the offset of the kafka partition to be consumed, and can only modify the currently consumed partition. Cannot add partition.
+
+## example
+
+1. Modify `desired_concurrent_number` to 1
+
+    ```
+    ALTER ROUTINE LOAD FOR db1.label1
+    PROPERTIES
+    (
+        "desired_concurrent_number" = "1"
+    );
+    ```
+
+2.  Modify `desired_concurrent_number` to 10, modify partition offset, and modify group id。
+
+    ```
+    ALTER ROUTINE LOAD FOR db1.label1
+    PROPERTIES
+    (
+        "desired_concurrent_number" = "10"
+    )
+    FROM kafka
+    (
+        "kafka_partitions" = "0, 1, 2",
+        "kafka_offsets" = "100, 200, 100",
+        "property.group.id" = "new_group"
+    );
+    ```
+
+
+## keyword
+
+    ALTER,ROUTINE,LOAD
+