目录
一、背景
二、方案流程
1. 方案可行性评估口径
2. 方案设计
3. 方案规划
4. 方案实施
5. 方案验证&验收
三、方案成果
四、方案展望
一
引言
2024年之前，DBA维护的StarRocks集群存在在用低版本多、稳定性受组件bug影响大的问题，给日常运维带来一定压力，版本升级迫在眉睫。于是，我们在今年年初安排了针对2.5以下版本升级2.5.13的专项。这里和大家分享下，针对因版本兼容问题而不能原地升级的场景下，进行跨集群升级时迁移数据方面的实践。
二
方案流程
方案可行性评估口径
针对跨集群迁移方案的评估，主要从迁移成本角度考虑，主要分为资源成本和稳定性成本：
资源成本
完成迁移所需要的人力工时投入、软硬件投入（如使用哪些三方平台、需要多少机器资源、带宽资源等）。
稳定性成本
数据迁移过程中，线上业务一般仍会继续提供服务，则迁移操作对系统产生的压力可能影响正常的生产服务，随之会带来额外的稳定性成本。这里从迁移服务产生系统压力的可监控预警能力评估稳定性成本。
方案设计
方案一：StarRocks外表
1. 技术原理
1.19 版本开始，StarRocks支持将数据通过外表方式写入另一个StarRocks集群的表中。这可以解决用户的读写分离需求，提供更好的资源隔离。用户需要首先在目标集群上创建一张目标表，然后在源StarRocks集群上创建一个Schema信息一致的外表，并在属性中指定目标集群和表的信息。
通过INSERT INTO写入数据至StarRocks外表，可以将源集群的数据写入至目标集群。借助这一能力，可以实现如下目标：
集群间的数据同步；
读写分离。向源集群中写入数据，并且源集群的数据变更同步至目标集群，目标集群提供查询服务。
2. 方案评估
3. 适用场景
数据量较小（200G以内）；
无三方平台可用；
数据迁移无需考虑稳定性成本；
测试场景快速验证；
存在hll、bitmap类型字段，但是又没有底表数据进行数据重建（hll/bitmap类型字段借助三方组件进行迁移的方案可参考官方文档flink导入至-bitmap-列、flink导入导入至-hll-列等）；
Array/Map/Row等复杂类型的迁移。
方案二：Flink Connector
1. 技术原理
Flink是一个框架和分布式处理引擎，用于在无边界和有边界数据流上进行有状态的计算。Flink能在所有常见集群环境中运行，并能以内存速度和任意规模进行计算。随着不断迭代，Flink已提供了接口统一的批流处理模型定义，同时提供了灵活强大的DataStream API和抽象度更高的Table API，供开发人员尽情发挥，更提供了SQL支持。
Flink提供了丰富的Connector，用以打通各类数据源，形成强大的数据联通能力。StarRocks官方也推出了导入和导出Connector，满足基于Flink对StarRocks的读写能力。
2. 方案评估
3. 适用场景
数据量较大；
有三方平台可用；
稳定性要求高，期望控制稳定性成本；
有24h持续同步需求。
方案规划
在同步操作前，需要明确待同步的数据范围，统计较精确的待迁移数据量，评估数据迁移所需耗时，决策数据迁移完成时间等。
方式一
结合预期的同步完成DDL，集群每天可用于同步的时间段，推导出同步时需要达到的速率。
计算公式：
预期同步最大速率(MB/s)=待同步数据总量(MB)/同步总耗时(天)/每天可同步时间(个小时/天)
方式二
根据集群负载可支持的最大速率、集群每天可用于同步的时间段，计算完成同步所需的时间。
同步总耗时(天)=待同步数据总量(MB)/预期同步最大速率(MB/s)/每天可同步时间(个小时/天)
注意
准确的待迁移数据量评估，依赖数据时间范围的确认。对于新旧集群双写场景，同步的最晚时间是完全双写介入的那一天（包含）。
预期同步最大速率(MB/s)，需要兼顾集群当前流量和预估可承受的最大流量，避免因数据同步给集群造成预期外的压力，影响线上服务稳定性。
方案实施
方案一：外表
1. 创建外表
在源集群/库上创建外表，指向目标集群。
建议创建一个外表专用db，用于与源db隔离，避免误操作风险。
`CREATE EXTERNAL TABLE external_db.external_t``(` `k1 DATE,` `k2 INT,` `k3 SMALLINT,` `k4 VARCHAR(2048),` `k5 DATETIME``)``ENGINE=olap```DUPLICATE KEY(`timestamp`)````PARTITION BY RANGE(`timestamp`)```(PARTITION p20231016 VALUES [("2023-10-16 00:00:00"), ("2023-10-17 00:00:00")),``PARTITION p20231017 VALUES [("2023-10-17 00:00:00"), ("2023-10-18 00:00:00")))``DISTRIBUTED BY HASH(k1) BUCKETS 10``PROPERTIES``(` `"host" = "127.0.0.x",` `"port" = "9020",` `"user" = "${user}",` `"password" = "${passwd}",` `"database" = "test_db",` `"table" = "t"``);`
2. 写入外表
在源集群/库上写入外表。
insert into external_db.external_t select * from db.other_table;
3. 优缺点
方案二 Flink SQL
1. 接入实时计算平台
本方案基于我司自研的实时计算平台（Flink任务开发调度平台）实现，需要业务方先接入平台，拥有专属项目空间和计算资源，这里不再赘述。
2. 新建Flink SQL任务
同步任务SQL即为Flink SQL，分为定义数据来源表、定义数据输出表、定义同步ETL SQL三部分。
语法上遵守Flink SQL规范，更多参数设置可参见官方文档使用Flink Connector读取数据-使用 Flink SQL读取数据。
注意事项：
StarRocks与Flink SQL的数据类型映射；
Flink scan参数设置，尤其是超时（time-out）类字段的设置，建议往大了设置；
考虑到数据迁移的源端和目标端的库、表均同名，在定义时需要对源表和输出表的表名做区分，以免混淆错乱。比如源表命名为{table名}_source，输出表命名为{table名}_sink 。
示例：
`CREATE TABLE rule_script_etl_source (` `` `timestamp` TIMESTAMP, `` `` `identity_id` STRING, `` `` `app` STRING, `` `` `cost` BIGINT, `` `` `name` STRING, `` `` `error` STRING, `` `` `script` STRING, `` `` `rule_id` STRING ```) WITH ( `` 'connector'='du-starrocks-1.27', --具体值以官方组件或自研组件定义为准` `'jdbc-url'='jdbc:mysql://1.1.1.1:9030?useSSL=false&rewriteBatchedStatements=true',` `'scan-url'='1.1.1.1:8030',` `"user" = "${user}",` `"password" = "${passwd}",` `'database-name'='test_db',` `'table-name'='rule_script_etl',` `'scan.max-retries'='3',` `'scan.connect.timeout-ms'='600000',` `'scan.params.keep-alive-min'='1440',` `'scan.params.query-timeout-s'='86400',` `'scan.params.mem-limit-byte'='1073741824'``);`
注意事项：
StarRocks与Flink SQL的数据类型映射；
Flink sink参数设置，尤其是超时（time-out）类字段的设置，建议往大了设置；
尽量进行攒批，减小对StarRocks的导入压力；
考虑到数据迁移的源端和目标端的库、表均同名，在定义时需要对源表和输出表的表名做区分，以免混淆错乱。比如源表命名为{table名}_source，输出表命名为{table名}_sink ；
如果输出表是主键模型，表定义中字段列表后需要加上PRIMARY KEY ({primary_key}) NOT ENFORCED。
示例：
`CREATE TABLE rule_script_etl_sink (` `` `timestamp` TIMESTAMP, `` `` `identity_id` STRING, `` `` `app` STRING, `` `` `rule_id` STRING, `` `` `uid` BIGINT, `` `` `cost` BIGINT, `` `` `name` STRING, `` `` `error` BIGINT, `` `` `script` STRING, `` `` `sink_time` TIMESTAMP, `` ``PRIMARY KEY (`identity_id`) NOT ENFORCED # 仅适用主键模型```) WITH (` `'connector'='du-starrocks-1.27',` `'jdbc-url'='jdbc:mysql://1.1.1.2:9030?useSSL=false&rewriteBatchedStatements=true',` `'load-url'='1.1.1.2:8030',` `"user" = "${user}",` `"password" = "${passwd}",` `'database-name'='test_db',` `'table-name'='rule_script_etl',` `'sink.buffer-flush.max-rows'='400000',` `'sink.buffer-flush.max-bytes'='94371840',` `'sink.buffer-flush.interval-ms'='30000',` `'sink.connect.timeout-ms'='60000',` `'sink.wait-for-continue.timeout-ms'='60000'``);`
一般为insert select语句；可以根据自身需求，添加一些ETL逻辑。
注意事项：
有映射关系的非同名字段，添加as，提升可阅读性；
前后字段类型不一样的，需要使用case as进行显式类型转换；
如果是仅输出表包含的字段，也需要在select子句中显式指出，并使用case null as {dataType}的形式进行类型转换；
部分String/VARCHAR(n)类型字段中，可能存在StarRocks Flink Connector使用的默认列分隔符(参数sink.properties.column_separator，默认\t)、行分隔符(参数sink.properties.row_delimiter，默认\n)，导致导入是报“errorLog:Error:Value count does not match column count. Expect xx, but got xx. Row:xxx”错误，需要替换为自定义的分隔符；
select子句尽量添加filter信息，一般是分区字段，以便Flink根据同步任务设置的并行度，拆分任务，生成合适的执行计划。
示例：
`insert into rule_script_etl_sink``select` `` `timestamp`, `` `` `identity_id`, `` `` `app`, `` `` `rule_id`, `` ``cast(null as BIGINT) `uid`,`` `` `cost`, `` `` `name`, `` ``cast(`error` as BIGINT) `error`,`` `` `script`, `` `` `timestamp` as `sink_time` ```from rule_script_etl_source```where `timestamp` >='2023-08-20 00:00:00' and `timestamp` < '2023-09-20 00:00:00';``
完整示例：
`CREATE TABLE rule_script_etl_source (` `` `timestamp` TIMESTAMP, `` `` `identity_id` STRING, `` `` `app` STRING, `` `` `cost` BIGINT, `` `` `name` STRING, `` `` `error` STRING, `` `` `script` STRING, `` `` `rule_id` STRING ```) WITH ( `` 'connector'='du-starrocks-1.27',` `'jdbc-url'='jdbc:mysql://1.1.1.1:9030?useSSL=false&rewriteBatchedStatements=true',` `'scan-url'='1.1.1.1:8030',` `"user" = "${user}",` `"password" = "${passwd}",` `'database-name'='test_db',` `'table-name'='rule_script_etl',` `'scan.max-retries'='3',` `'scan.connect.timeout-ms'='600000',` `'scan.params.keep-alive-min'='1440',` `'scan.params.query-timeout-s'='86400',` `'scan.params.mem-limit-byte'='1073741824'``);`` ``CREATE TABLE rule_script_etl_sink (` `` `timestamp` TIMESTAMP, `` `` `identity_id` STRING, `` `` `app` STRING, `` `` `rule_id` STRING, `` `` `uid` BIGINT, `` `` `cost` BIGINT, `` `` `name` STRING, `` `` `error` BIGINT, `` `` `script` STRING, `` `` `sink_time` TIMESTAMP, `` ``PRIMARY KEY (`identity_id`) NOT ENFORCED # 仅适用主键模型```) WITH (` `'connector'='du-starrocks-1.27',` `'jdbc-url'='jdbc:mysql://1.1.1.2:9030?useSSL=false&rewriteBatchedStatements=true',` `'load-url'='1.1.1.2:8030',` `"user" = "${user}",` `"password" = "${passwd}",` `'database-name'='test_db',` `'table-name'='rule_script_etl',` `'sink.buffer-flush.max-rows'='400000',` `'sink.buffer-flush.max-bytes'='94371840',` `'sink.buffer-flush.interval-ms'='30000',` `'sink.connect.timeout-ms'='60000',` `'sink.wait-for-continue.timeout-ms'='60000',` `'sink.properties.column_separator'='#=#', -- 自定义列分隔符` `'sink.properties.row_delimiter'='@=@' -- 自定义行分隔符``);`` ``insert into rule_script_etl_sink``select` `` `timestamp`, `` `` `identity_id`, `` `` `app`, `` `` `rule_id`, `` ``cast(null as BIGINT) `uid`, -- sinl表才有的字段`` `` `cost`, `` `` `name`, `` ``cast(`error` as BIGINT) `error`,`` `` `script`, `` `` `timestamp` as `sink_time` ```from rule_script_etl_source```where `timestamp` >='2023-08-20 00:00:00' and `timestamp` < '2023-09-20 00:00:00';``
3. 调度任务
在开始调度前，还需要为任务的设置合适的并行度。通常SlotNum/TM设置为1，Parallelism设置为3，以长耗时换取导入任务的运行稳定性。
为避免任务失败带来的重跑工作量，单表每次任务可以迁移部分分区，多次执行。
4. 优缺点
方案验证&验收
验证
可以选取不同大小的表若干，组成有梯度的待同步数据量，使用上述任一种方案，执行同步操作，并观察同步时间内集群的负载。
以集群各水位不超过80%、无业务报错为准，尝试验证集群可承载的最大同步速率，及时校正上面的数据同步规划。
验收
1. 集群负载
以集群各水位不超过80%、无业务报错为准。可根据集群水位情况，酌情增加或减少同步任务的并发。
2. 数据diff校验
针对迁移前后数据模型未发生改变的表，一定范围内（通常是单分区级别）的数据量需要保持相等；
针对迁移前后数据模型发生改变的表，需要case by base分析。
如下：
数据质量校验
针对维度表，可参考分区及或表级行数校验结果；
针对事实表，可以在分区级别做指标列的SUM/MAX/MIN/AVG值校验；
研发也可以结合业务自定义更多的校验方式。
三
方案成果
基于本方案，有效地解决了原地升级异常再回滚的方案带来的不稳定风险，完成了多个集群从低版本直升2.5.13的目标，累计迁移数据逾10T，迁移流量摸高至2Gb/s（10+个节点）。
结合原地升级方式，共同构成了较完善的升级方案，尽量减少升级带给业务的闪断等影响的同时，以较高效率完成升级。
四
方案展望
方案的不足
对比云商和自建DTS平台的数据迁移功能，本方案在流程化、产品化上的建设还有较大进步空间，诸如在迁移任务的量级分析、任务拆分、持续性调度、容错等步骤都可以做更多的自动化建设。
因StarRocks 2.5.13尚未支持CDC功能，当前的迁移方案暂只能提供离线同步的能力，在跨集群升级过程中，为保障数据的一致性，仍需要花费较多的精力，诸如协调新旧集群的双写、切流、补数等。
未来规划
方案中一些功能点，可以封装成原子功能，供更多场景使用。封装随着新版本StarRocks稳定性逐渐增强，组件自身bug影响稳定向的概率已经非常低了，跨集群升级的场景需求也越来越少。但方案中的原子能力，诸如库表特征分析、跨集群的shcema同步、表重建等等，仍有继续打磨的空间，可以在日常运维中提供帮助。
数据迁移的实时CDC能力也是一项亟待补齐的能力，集成离线和实时迁移功能，将助力实现无感升级。
探索跨集群迁移流程将探索更多的适用场景，诸如基于资源利用率或稳定性的集群拆分、合并等场景。
引用：
https://docs.starrocks.io/zh/docs/2.5/unloading/Flink\_connector/
往期回顾
1. Apache Flink类型及序列化研读&生产应用｜得物技术
2. 可视化流量录制规则探索和实践｜得物技术
3. 在得物的小程序生态实践
4. 客服测试流水线编排设计思路和准入准出应用｜得物技术
5. 深入剖析时序Prophet模型：工作原理与源码解析｜得物技术
文 / 管虎
关注得物技术，每周一、三、五更新技术干货
要是觉得文章对你有帮助的话，欢迎评论转发点赞～
未经得物技术许可严禁转载，否则依法追究法律责任。
“
扫码添加小助手微信
如有任何疑问，或想要了解更多技术资讯，请添加小助手微信：
线下活动推荐
**快快点击下方图片报名吧！
**