文档首页/ 数据治理中心 DataArts Studio/ 用户指南/ 数据集成(离线作业)/ 参数配置实践教程/ Hudi Load/Truncate+Load/Insert Overwrite写入模式最佳实践
更新时间:2025-10-30 GMT+08:00
分享

Hudi Load/Truncate+Load/Insert Overwrite写入模式最佳实践

概述

在数据集成服务中,Hudi 的数据写入操作是高效处理数据更新和增量加载的重要方式。Hudi支持 Load、Truncate + LoadInsert Overwrite三种写入模式,每种模式都有其独特的适用场景和特点,可以根据不同的业务需求进行选择。

Hive 数据写入模式

  • Load 模式

    Load 模式是Hudi 最基本的写入方式,直接将数据写入目标Hudi表中,不会对目标表进行清理操作,而是以追加的方式写入数据。

    • 特点
      • 不清理目标表:写入数据前不会对目标表进行任何清理操作,新数据会追加到目标表中。
      • 支持增量写入:适用于数据追加场景,即目标表中已存在数据,新数据需要追加到目标表中,能够高效地处理增量数据。
    • 实践样例

      假设源端为MYSQL数据表data,目标表为Hudi数据表data,分区字段为dt。配置作业,MySQL表中的增量数据写入Hudi表中,Hudi会根据分区字段 dt将数据追加到对应的分区中。

      图1 配置源端目的端数据表

      源端MySQL表

      CREATE TABLE `data` (  `id` varchar(10) DEFAULT NULL,  `dt` date DEFAULT NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8;

      目标端Hudi 表

      CREATE TABLE `data` (  `id` varchar(10) DEFAULT NULL,  `dt` date DEFAULT NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8;
  • Truncate+Load 模式

    Truncate+Load 模式是先清空目标Hudi表中的分区数据,然后加载新的数据。

    • 特点
      • 清空目标表分区数据:写入数据前会清空目标表选择的分区数据。
      • 分区保留:虽然清空了数据,但分区结构仍然保留,新的数据会根据分区字段重新写入到对应的分区中。
    • 实践样例

      假设源端为MYSQL数据表data,目标表为Hudi数据表data,分区字段为dt。

      配置作业,先Truncate删除Hudi表中dt=2025-10-21分区数据,然后将MySQL表中的数据重新写入Hudi表中,Hudi会根据分区字段dt将数据重新组织到对应的分区中。

      图2 配置参数

      源端MySQL表

      CREATE TABLE `data` ( 
       `id` varchar(10) DEFAULT NULL, 
       `dt` date DEFAULT NULL
      ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

      目标端Hive表

      CREATE TABLE `data` ( 
       `id` varchar(10)
      )
      PARTITIONED BY (`dt` date)
      STORED AS PARQUET
  • Insert Overwrite 模式

    Insert Overwrite模式会先将数据写入一个临时表,然后使用Hudi的INSERT OVERWRITE语法将临时表中的数据覆盖到目标表中。

    • 实现

      这种模式在Hudi中通过以下步骤实现:

      1. 创建临时表:首先创建一个临时表,用于暂存写入的数据。
      2. 写入临时表:将数据写入临时表。
      3. 覆盖目标表:使用INSERT OVERWRITE语法将临时表中的数据覆盖到目标表中。
    • 特点
      • 临时:生成一个临时表,用于暂存写入的数据。
      • 覆盖目标表:使用Hudi的INSERT OVERWRITE语法覆盖目标表中的数据,确保数据的一致性。
      • 动态分区与静态分区写入支持:Insert Overwrite模式支持动态分区和静态分区两种写入场景。
        • 动态分区写入:在动态分区写入场景中,源数据中的分区字段值将被自动识别并用于确定目标分区,允许一次性覆盖多个分区,满足多分区数据更新的需求。
        • 静态分区写入:在静态分区写入场景中,需要在写入操作中明确指定目标分区,仅覆盖指定的单个分区,适用于对特定分区进行精确更新的场景。
    • 实践样例

      假设源端为MySQL数据表data,目标表为Hudi数据表data,分区字段为dt。

      源端 MySQL 表结构如下:

      CREATE TABLE `data` (  `id` varchar(10) DEFAULT NULL,  `dt` date DEFAULT NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8;

      目标端Hudi表结构如下:

      CREATE TABLE `data` (  `id` varchar(10))PARTITIONED BY (`dt` date)STORED AS PARQUET LOCATION 'hdfs://path/to/hudi/table/data';
      • 静态分区

        如果希望将MySQL表中的所有数据写入Hudi表的 dt=2025-10-21 的分区,可以选择INSERT OVERWRITE模式,并在写入操作中指定分区过滤条件为 dt=2025-10-21。

        图3 配置参数
      • 动态分区

        如果 MySQL 表中的数据包含多个分区的数据,希望根据源数据中的分区字段值自动识别并覆盖目标分区,可以选择 Insert Overwrite 模式,此时,无需指定分区过滤条件,同时确保字段映射配置dt分区字段。

        图4 配置参数
        图5 配置映射

总结

通过合理选择Load、Truncate + Load 和Insert Overwrite三种Hudi数据写入模式,可以根据不同的业务需求高效地进行数据迁移和更新。在实际操作中,建议遵循上述最佳实践建议,确保数据的一致性和系统的性能。

相关文档