全部产品
Search
文档中心

云数据库 RDS:主实例开启DuckDB

更新时间:Jun 11, 2026

RDS PostgreSQL主实例支持开启DuckDB加速功能,通过列式存储引擎提升分析查询性能。本文介绍如何为RDS PostgreSQL主实例开启DuckDB加速功能。

适用范围

如需为RDS PostgreSQL主实例开启DuckDB加速,主实例需满足以下条件:

  • 实例状态:运行中。

  • 数据库大版本:RDS PostgreSQL 13.0及以上。

  • 产品系列:基础系列或高可用系列。

    说明

    集群系列实例暂不支持开启DuckDB加速功能。

  • 计费方式:包年包月或按量计费。

  • 数据库小版本:20260130及以上版本。

  • 实例参数:已配置以下参数的取值。

    wal_level取值为logicalshared_preload_libraries中包含rds_duckdbmax_replication_slots取值大于等于1024max_worker_processes取值大于等于1024max_wal_senders取值大于等于1024

  • 不是灾备实例。

注意事项

  • 触发行转列后,系统会新增列式存储,请关注实例磁盘使用情况,避免磁盘空间不足。

  • 主实例开启DuckDB加速过程中会发生一次闪断,请在业务低峰期操作,或确保应用具备自动重连机制。

  • 主实例开启DuckDB加速后,无法再添加DuckDB分析只读实例;已挂载DuckDB只读实例的主实例也无法开启DuckDB加速功能。

  • 开启DuckDB加速的主实例执行数据库恢复操作后,恢复生成的新实例不会自动继承DuckDB加速功能,需要重新开启。

操作步骤

步骤一:开启DuckDB加速

  1. 登录RDS管理控制台

  2. 在左侧导航栏,单击实例列表,然后在上方选择实例所在地域。

  3. 找到目标实例,单击实例ID。

  4. 通过以下任一方式进入DuckDB加速开启页面:

    • 方式一:在实例详情页上方,单击开启HTAP加速

    • 方式二:在实例详情页的配置信息区域,找到HTAP加速配置项,单击设置

  5. RDS PG HTAP加速前置检查弹窗中,查看前置条件检查结果。

    • 如果所有检查项均通过,单击确认开始开启DuckDB加速。

    • 如果检查项未通过,请根据提示处理:

      • 自动修复项:对于小版本参数配置等可自动修复的检查项,单击确认,系统将自动完成升级或配置。

      • 手动修复项:对于大版本实例资源等需要手动处理的检查项,请参考以下文档完成操作后,再重新开启DuckDB加速:

      image

  6. 等待开启完成。开启成功后,在实例详情页的配置信息区域,HTAP加速状态显示为已开启image

步骤二:配置列式存储

主实例开启DuckDB加速后,您需要为需要进行分析查询的表配置列式存储。具体操作如下:

  1. 通过DMS或其他数据库客户端工具,使用高权限账号连接目标数据库。

  2. 执行以下命令,创建rds_duckdb扩展:

    CREATE EXTENSION IF NOT EXISTS rds_duckdb;
  3. 执行以下命令,将指定表转换为列式存储:

    • 单表转换:

      SELECT rds_duckdb.create_duckdb_table('表名');
      说明

      表名替换为实际需要转换的表名。如需转换多个表,请多次执行该命令。

    • 批量转换:

      SELECT rds_duckdb.create_duckdb_tables('{a,b,c...}');
      说明

      使用create_duckdb_tables(复数形式)批量转换多个表,表名需要使用花括号格式,多个表名之间用英文逗号分隔。