大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:ALTER ROUTINE LOAD

· 52CE 我爱测

该语法用于修改 Routine Load 导入作业。注意,只能修改处于 状态的作业。您可以通过 PAUSE ROUTINE LOAD 暂停 Routine Load 导入作业。

ALTER ROUTINE LOAD

功能

该语法用于修改 Routine Load 导入作业。注意,只能修改处于 PAUSED 状态的作业。您可以通过 PAUSE ROUTINE LOAD 暂停 Routine Load 导入作业。

修改成功后,您可以:

语法

ALTER ROUTINE LOAD FOR [db_name.]<job_name>
[load_properties]
[job_properties]
FROM data_source
[data_source_properties]

参数说明

  • [<db_name>.]<job_name>

    指定要修改的作业名称。

  • load_properties

    待导入的源数据信息。语法如下:

    [COLUMNS TERMINATED BY '<column_separator>'],
    [ROWS TERMINATED BY '<row_separator>'],
    [COLUMNS ([<column_name> [, ...] ] [, column_assignment [, ...] ] )],
    [WHERE <expr>],
    [PARTITION ([ <partition_name> [, ...] ])]
    [TEMPORARY PARTITION (<temporary_partition1_name>[,<temporary_partition2_name>,...])]
    

    详细的参数介绍,请参见 CREATE ROUTINE LOAD。

  • job_properties

    导入作业的属性。语法如下:

    PROPERTIES ("<key1>" = "<value1>"[, "<key2>" = "<value2>" ...])
    

    目前仅支持修改如下属性:

    • desired_concurrent_number

    • max_error_number

    • max_batch_interval

    • max_batch_rows

    • max_batch_size

    • jsonpaths

    • json_root

    • strip_outer_array

    • strict_mode

    • timezone

    详细的属性介绍,请参见 CREATE ROUTINE LOAD。

  • data_source 和 data_source_properties

    • data_source

      必填,指定数据源,目前仅支持取值为 KAFKA。

    • data_source_properties

      数据源的相关属性。目前支持修改:

      • kafka_partitions 和 kafka_offsets:需要注意的是,默认仅支持修改当前已经消费的 Kafka partition 的 offset,不支持新增 Kafka partition。如果同一语句中将 property.kafka_partition_discovery 设置为 true,则所列分区改为按 Kafka 主题实际存在的分区进行校验,因此也可以为固定分区列表之外的分区指定 offset。
      • property.*: 自定义的数据源 Kafka 相关参数,例如 property.kafka_default_offsets。需要注意的是,property.kafka_partition_discovery 只能设置为 true,用于解除创建作业时固定的分区列表并重新开启分区自动发现。不支持改回 false,如需重新固定分区列表,请重建作业。

示例

  1. 将导入作业的属性 desired_concurrent_number 调大至 5,以提高导入任务的并行度。任务的并行度的详细说明,参见如何提高导入性能。

    ALTER ROUTINE LOAD FOR example_tbl_ordertest
    PROPERTIES
    (
        "desired_concurrent_number" = "5"
    );
    
  2. 同时修改导入作业的属性和数据源信息。

    ALTER ROUTINE LOAD FOR example_tbl_ordertest
    PROPERTIES
    (
        "desired_concurrent_number" = "5"
    )
    FROM KAFKA
    (
        "kafka_partitions" = "0, 1, 2",
        "kafka_offsets" = "100, 200, 100",
        "property.group.id" = "new_group"
    );
    
  3. 同时修改过滤条件和导入的目标 StarRocks 分区。

    ALTER ROUTINE LOAD FOR example_tbl_ordertest
    WHERE pay_dt < 2023-06-31
    PARTITION (p202306);
    

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。