更新时间:2025-09-19 GMT+08:00
分享

Hudi任务同步

创建Hudi任务

迁移场景

如果DWS表已经通过CDL导入数据,改为用SQL on Hudi方式迁移数据。或者使用CDM做全量初始化后,继续使用SQL on Hudi方式同步增量数据。

  1. 创建hudi.hudi_sync_state同步状态表,需要管理员权限。

    1
    SELECT pg_catalog.create_hudi_sync_table();
    

    通常情况下,每个数据库中只创建一次hudi.hudi_sync_state。

  2. 设置同步进度,用户需要有同步目标表的INSERT和UPDATE权限、HUDI外表的SELECT权限,否则无法正常设置同步进度。

    1
    SELECT hudi_set_sync_commit('SCHEMA.TABLE', 'SCHEMA.FOREIGN_TABLE', 'LATEST_COMMIT');
    

    其中:

    • SCHEMA.TABLE,表示同步数据的目标表名,schema为模式名。
    • SCHEMA.FOREIGN_TABLE,表示OBS外表名,schema为模式名。
    • LATEST_COMMIT,表示已同步的Hudi数据时间截点。

    示例:目标表public.in_rel,已经同步hudi的数据到20220913152131,切换到SQL on Hudi方式从OBS外表hudi_read1中继续导出数据。

    1
    SELECT hudi_set_sync_commit('public.in_rel', 'public.hudi_read1', '20220913152131');
    

  3. 提交Hudi同步任务。

    1
    SELECT hudi_sync_task_submit('SCHEMA.TABLE', 'SCHEMA.FOREIGN_TABLE');
    

    例如:目标表public.in_rel,切换到SQL on Hudi方式从OBS外表hudi_read1中继续导出数据。

    1
    SELECT hudi_sync_task_submit('public.in_rel', 'public.hudi_read1');
    

新建场景

DWS表为空,第一次从Hudi同步数据,可执行以下命令直接创建任务。

1
SELECT hudi_sync_task_submit('SCHEMA.TABLE', 'SCHEMA.FOREIGN_TABLE');

查询Hudi同步任务

查询Hudi同步任务。

语法:

1
SELECT * FROM pg_task_show('SQLonHudi');

查询结果中的task_id是Hudi同步任务唯一标识。

示例:

1
2
3
4
5
SELECT * FROM pg_task_show('SQLonHudi');
              task_id                |                                                                                          what                                                                                           | category_id | userid | is_broken |  interval  | time_cons |          start_time           | end_time | parameter | task_rank |        next_start_time        |         next_end_time         | last_log | failure_times 
--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------+--------+-----------+------------+-----------+-------------------------------+----------+-----------+-----------+-------------------------------+-------------------------------+----------+---------------
 64d257e9-1e9b-0d00-3ce3-7e61b5e0fffe | call pg_catalog.hudi_sync_custom('public.hudi_read_target', 'public.hudi_read101', '{"_hoodie_commit_seqno" : "_hoodie_commit_seqno", "id" : "id", "ts" : "ts", "long_field" : "ts"}'); | SQLonHudi   |     10 | f         | '00:00:10' |           | 2023-08-08 22:58:15.846903+08 |          |           |         5 | 2023-08-08 22:58:15.846903+08 | 2023-08-08 22:58:24.846903+08 |          |             0
(1 row)

暂停Hudi同步任务

通过指定的task_id,暂停对应的Hudi同步任务。

语法:

1
SELECT pg_task_pause('task_id');

示例:

暂停task_id为64479410-a04c-0700-d150-3037d700fffe的同步任务。

1
SELECT pg_task_pause('64479410-a04c-0700-d150-3037d700fffe');

恢复Hudi同步任务

通过指定的task_id,恢复对应的Hudi同步任务。

语法:

1
SELECT pg_task_resume('task_id');

示例:

恢复task_id为64479410-a04c-0700-d150-3037d700fffe的同步任务。

1
SELECT pg_task_resume('64479410-a04c-0700-d150-3037d700fffe');

复位连续失败的Hudi同步任务

通过指定连续失败Hudi任务的task_id,复位连续失败的Hudi同步任务。

连续失败次数大于等于10的任务会自动暂停,需手动调用pg_task_resume()函数复位。

1
SELECT pg_task_resume('task_id');

删除Hudi同步任务

通过指定的task_id,删除对应的Hudi同步任务。

语法:

1
SELECT pg_task_remove('task_id');

示例:

删除task_id为64479410-a04c-0700-d150-3037d700fffe的同步任务。

1
SELECT pg_task_remove('64479410-a04c-0700-d150-3037d700fffe');

查询历史Hudi同步任务信息

使用视图hudi_sync_state_history_view查询Hudi历史同步任务信息,该视图仅9.1.0及以上集群版本支持。

1
SELECT * FROM pg_catalog.hudi_sync_state_history_view;
表1 hudi_sync_state_history_view字段

名称

类型

描述

task_id

text

任务ID。

target_tbl

text

同步目标表名。

source_ftbl

text

同步源表名(外表)。

latest_commit

text

最近一次同步成功的时间戳。

latest_sync_count

bigint

最近一次同步成功的行数。

latest_sync_start

timestamp with time zone

最近一次同步任务开始的时间。

latest_sync_end

timestamp with time zone

最近一次同步任务结束的时间。

hudi_flushdisk_time

text

hudi文件落盘时间。

查询Hudi同步任务状态

使用函数hudi_show_sync_state()查询Hudi同步任务状态。

1
SELECT * FROM hudi_show_sync_state();

相关文档