全部產品
Search
文件中心

ApsaraDB RDS:主執行個體開啟DuckDB

更新時間:Jun 12, 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(複數形式)批量轉換多個表,表名需要使用花括弧格式,多個表名之間用英文逗號分隔。