本文主要介绍如何通过Spark SQL读写Hudi外表。

背景信息

Apache Hudi(简称Hudi)是基于OSS对象存储的一种表格式,支持UPDATE、DELETE和INSERT操作。AnalyticDB MySQL湖仓版(3.0)和Hudi做了深度整合,您可以通过Spark SQL读写Hudi外表。

前提条件

步骤一:进入数据开发

  1. 登录云原生数据仓库AnalyticDB MySQL控制台
  2. 在页面左上角,选择集群所在地域。
  3. 在左侧导航栏,单击集群列表
  4. 湖仓版(3.0)页签下,单击目标集群ID
  5. 在左侧导航栏,单击作业开发 > SQL开发
  6. SQLConsole窗口,选择Job型资源组和Spark引擎。

步骤二:创建外库与Hudi外表

说明 您可以选择批处理或交互式执行任意一种方式执行以下SQL语句。详情请参见Spark SQL执行方式
  1. 执行以下语句,创建数据库。如果已有数据库,可跳过本步骤。
    CREATE DATABASE adb_external_db_hudi
    location 'oss://<bucket_name>/test/';    /*用于在该路径中创建表,请替换为自己的OSS路径。*/
  2. 执行以下语句,创建Hudi外表。
    CREATE TABLE adb_external_db_hudi.test_hudi_tbl (
     `id` int,
     `name` string,
     `age` int
    ) using hudi 
    tblproperties
     (primaryKey = 'id', 
      preCombineField = 'age') 
      partitioned by (age) 
    location 'oss://<bucket_name>/test/table/';  /*写入的数据会存储在该路径中,请替换为自己的OSS路径。*/
    重要
    • OSS路径中的Bucket需与创建数据库所选的Bucket相同。
    • 创建外表时选择的OSS路径需比创建数据库时选择的OSS路径至少多一层目录,且外表的路径需在数据库路径下。
    • 建表时必须定义primaryKey主键。preCombineField预聚合字段为可选,如未定义preCombineField在UPDATE场景会报错。

步骤三:写入Hudi外表数据

说明 您可以选择批处理或交互式执行任意一种方式执行以下SQL语句。详情请参见Spark SQL执行方式

INSERT

执行以下语句,写入数据。您可以选择以下任意一种方式向Hudi外表中写入数据。
  • 方式一:INSERT INTO写入
    INSERT INTO adb_external_db_hudi.test_hudi_tbl values(1, 'lisa', 10),(2, 'jams', 10);
  • 方式二:INSERT OVERWRITE全表写入
    INSERT OVERWRITE adb_external_db_hudi.test_hudi_tbl values (1, 'lisa', 10), (2, 'jams', 20);
  • 方式三:INSERT OVERWRITE静态分区写入
    INSERT OVERWRITE adb_external_db_hudi.test_hudi_tbl partition(age=10) values(1, 'anna');
  • 方式四:INSERT OVERWRITE动态分区写入
    INSERT OVERWRITE adb_external_db_hudi.test_hudi_tbl partition (age) values (1, 'bom', 10);

UPDATE

执行以下语句更新数据,本文以将id=2的name列更新为box为例。
UPDATE adb_external_db_hudi.test_hudi_tbl SET name = 'box' where id = 2;

DELETE

执行以下语句删除数据,本文以删除id列为1的数据为例。
DELETE FROM adb_external_db_hudi.test_hudi_tbl where id = 1;

步骤四:查询数据

说明
  • 您可以选择批处理或交互式执行任意一种方式执行以下SQL语句。详情请参见Spark SQL执行方式
  • 执行Spark SQL语句,只返回执行成功或者失败,不返回数据。您可以在Spark开发页面应用列表页签中的日志查看表数据。详情请参见查看Spark应用信息
执行以下语句,查询Hudi外表数据。
SELECT * FROM adb_external_db_hudi.test_hudi_tbl;