All Products
Search

This Product

    ApsaraDB RDS:Aktifkan DuckDB untuk instans primary

    Document Center

    ApsaraDB RDS:Aktifkan DuckDB untuk instans primary

    Last Updated:Jun 13, 2026

    Anda dapat mengaktifkan akselerasi DuckDB pada instans primary ApsaraDB RDS for PostgreSQL untuk meningkatkan performa kueri analitik menggunakan mesin penyimpanan kolom (columnar storage engine). Topik ini menjelaskan cara mengaktifkan akselerasi DuckDB pada instans primary ApsaraDB RDS for PostgreSQL.

    Prasyarat

    Instans harus memenuhi persyaratan berikut sebelum Anda mengaktifkan akselerasi DuckDB pada instans primary ApsaraDB RDS for PostgreSQL:

    • instance state: Running.

    • major version: PostgreSQL 13.0 atau lebih baru.

    • Edition: Basic Edition atau High-availability Edition.

      Catatan

      Instans Cluster Edition tidak mendukung akselerasi DuckDB.

    • billing method: subscription atau pay-as-you-go.

    • minor version: 20260130 atau lebih baru.

    • instance parameters: Parameter berikut dikonfigurasi sesuai ketentuan.

      Parameter wal_level diatur ke logical, shared_preload_libraries mencakup rds_duckdb, max_replication_slots diatur ke nilai yang lebih besar dari atau sama dengan 1024, max_worker_processes diatur ke nilai yang lebih besar dari atau sama dengan 1024, dan max_wal_senders diatur ke nilai yang lebih besar dari atau sama dengan 1024.

    • Instans bukan merupakan disaster recovery instance.

    Catatan penting

    • Setelah Anda mengonversi tabel berbasis baris menjadi penyimpanan kolom, sistem akan membuat data kolom tambahan. Pantau penggunaan disk Anda untuk mencegah kehabisan ruang penyimpanan.

    • Mengaktifkan akselerasi DuckDB pada instans primary menyebabkan pemutusan koneksi sementara. Kami menyarankan Anda melakukan operasi ini di luar jam sibuk atau memastikan aplikasi Anda memiliki mekanisme rekoneksi otomatis.

    • Setelah akselerasi DuckDB diaktifkan pada instans primary, Anda tidak dapat menambahkan instans hanya baca DuckDB. Demikian pula, Anda tidak dapat mengaktifkan akselerasi DuckDB pada instans primary yang sudah memiliki instans hanya baca DuckDB.

    • Jika Anda melakukan operasi pemulihan database pada instans primary yang telah diaktifkan akselerasi DuckDB, instans baru yang dibuat melalui pemulihan tersebut tidak secara otomatis mewarisi akselerasi DuckDB. Anda harus mengaktifkannya kembali secara manual.

    Prosedur

    Langkah 1: Aktifkan akselerasi DuckDB

    1. Masuk ke Konsol ApsaraDB RDS.

    2. Pada panel navigasi di sebelah kiri, klik Instances. Pada bilah navigasi atas, pilih wilayah tempat instans Anda berada.

    3. Temukan instans target dan klik ID instans-nya.

    4. Buka halaman akselerasi DuckDB dengan salah satu metode berikut:

      • Metode 1: Di bagian atas halaman Instance Details, klik Enable HTAP Acceleration.

      • Metode 2: Pada bagian Basic Information di halaman Instance Details, temukan HTAP Acceleration dan klik Settings.

    5. Pada kotak dialog HTAP Acceleration Pre-check, tinjau hasil pemeriksaan prasyarat.

      • Jika semua pemeriksaan lolos, klik confirm untuk mulai mengaktifkan akselerasi DuckDB.

      • Jika ada pemeriksaan yang gagal, selesaikan masalah tersebut dengan mengikuti petunjuk di bawah ini:

        • Item yang dapat diperbaiki otomatis: Untuk item yang dapat diperbaiki secara otomatis, seperti Minor Version dan Parameter Settings, klik confirm. Sistem akan secara otomatis melakukan peningkatan atau konfigurasi yang diperlukan.

        • Item yang memerlukan perbaikan manual: Untuk item yang memerlukan intervensi manual, seperti Major Version atau Instance Resources, rujuk dokumentasi berikut untuk melakukan operasi yang diperlukan. Kemudian, coba aktifkan kembali akselerasi DuckDB.

        image

    6. Tunggu hingga proses selesai. Setelah akselerasi DuckDB diaktifkan, status HTAP Acceleration berubah menjadi Enabled pada bagian Basic Information di halaman Instance Details.image

    Langkah 2: Konfigurasikan penyimpanan kolom

    Setelah Anda mengaktifkan akselerasi DuckDB pada instans primary, konfigurasikan penyimpanan kolom untuk tabel yang ingin digunakan dalam kueri analitik dengan mengikuti langkah-langkah berikut:

    1. Gunakan Data Management Service (DMS) atau tool client database lain untuk terhubung ke database target dengan akun istimewa.

    2. Jalankan pernyataan berikut untuk membuat ekstensi rds_duckdb:

      CREATE EXTENSION IF NOT EXISTS rds_duckdb;

    3. Jalankan pernyataan berikut untuk mengonversi tabel tertentu ke penyimpanan kolom:

      • Konversi satu tabel:

        SELECT rds_duckdb.create_duckdb_table('your_table_name');
        Catatan

        Ganti TableName dengan nama tabel yang sebenarnya. Jika Anda perlu mengonversi beberapa tabel, jalankan perintah ini beberapa kali.

      • Konversi beberapa tabel secara batch:

        SELECT rds_duckdb.create_duckdb_tables('{table_a,table_b,table_c}');
        Catatan

        Gunakan create_duckdb_tables (bentuk jamak) untuk mengonversi beberapa tabel secara batch. Nama tabel harus diapit tanda kurung kurawal dan dipisahkan dengan koma.