All Products
Search
Document Center

IoT Platform:Penerusan data ke ApsaraDB RDS

Last Updated:Jun 21, 2026

Gunakan fitur Penerusan Data untuk mengurai, memproses, dan menyimpan data dari Platform IoT ke instans ApsaraDB RDS.

Cara kerja

Fitur Penerusan Data meneruskan pesan dari topik perangkat ke tabel dalam database ApsaraDB RDS, yaitu layanan database terkelola. Untuk informasi selengkapnya, lihat Apa itu ApsaraDB RDS?.

Pada gambar di atas:

  • Sumber data: Pesan dari jenis topik yang didukung. Untuk informasi selengkapnya tentang format data yang didukung, lihat Format data.

  • Ekspresi SQL: Tulis ekspresi SQL untuk mengurai dan memproses data JSON dari perangkat. Untuk informasi selengkapnya tentang sintaksis SQL, lihat Ekspresi SQL.

    Catatan

    Data biner diteruskan tanpa diurai.

  • Tujuan data: Tabel dalam database yang termasuk dalam instans ApsaraDB RDS untuk MySQL atau ApsaraDB RDS untuk SQL Server di dalam Virtual Private Cloud (VPC). Tabel ini menerima data perangkat.

Batasan

  • Batasan wilayah:

    • Instans Platform IoT di wilayah tertentu mendukung penerusan data ke ApsaraDB RDS. Untuk informasi selengkapnya tentang wilayah yang didukung, lihat Ketersediaan fitur berdasarkan wilayah.

    • Instans ApsaraDB RDS harus berada di wilayah yang sama dengan instans Platform IoT Anda. Misalnya, data dari instans Platform IoT di wilayah China (Shanghai) hanya dapat diteruskan ke tabel dalam instans ApsaraDB RDS di wilayah China (Shanghai).

  • Anda hanya dapat meneruskan data ke instans ApsaraDB RDS yang berada di Virtual Private Cloud (VPC).

  • Instans ApsaraDB RDS untuk MySQL dan ApsaraDB RDS untuk SQL Server didukung.

  • Data dapat diteruskan ke database standar maupun database berhak istimewa tinggi.

  • Penerusan data hanya mendukung data dalam format JSON.

  • Versi baru maupun versi lama fitur Penerusan Data mendukung penerusan data ke ApsaraDB RDS. Untuk contoh penggunaan versi baru, lihat Penerusan data ke ApsaraDB RDS (versi baru).

  • Versi lama Penerusan Data tidak dapat digunakan untuk produk dan perangkat gerbang cloud, atau produk dan perangkat di bawah instans berbasis MQTT. Untuk meneruskan data dari produk dan perangkat tersebut, Anda harus menggunakan versi baru Penerusan Data. Untuk informasi selengkapnya, lihat Penerusan data (versi baru).

  • Untuk batasan tambahan terkait penerusan pesan perangkat dari instans Platform IoT, lihat Batasan.

Prasyarat

  • Instans ApsaraDB RDS untuk MySQL atau ApsaraDB RDS untuk SQL Server di VPC, yang berlokasi di wilayah yang sama dengan instans Platform IoT Anda. Database dan tabel harus dibuat dalam instans tersebut. Untuk informasi selengkapnya tentang cara menggunakan ApsaraDB RDS, lihat Dokumentasi ApsaraDB RDS.

  • Aturan Penerusan Data dengan ekspresi SQL untuk memproses data. Untuk informasi selengkapnya, lihat Buat aturan untuk memproses data.

Informasi latar belakang

Setelah Anda mengonfigurasi tujuan data, mesin aturan Platform IoT secara otomatis melakukan konfigurasi berikut untuk meneruskan data perangkat ke ApsaraDB RDS.

  • Platform IoT mengonsumsi dua alamat IP dari vSwitch tempat instans ApsaraDB RDS berada. Blok CIDR IPv4 vSwitch tersebut ditambahkan ke daftar putih instans ApsaraDB RDS.

  • Grup keamanan terkelola dibuat di VPC tempat instans ApsaraDB RDS berada. Nama grup keamanan tersebut secara default diawali dengan sg-nsm-.

Konfigurasi tujuan data

  1. Login ke Konsol Platform IoT.

  2. Pada halaman Overview, temukan instans yang ingin Anda kelola lalu klik ID instans atau nama instans tersebut.

  3. Di panel navigasi sebelah kiri, pilih Message Forwarding > Data Forwarding.

  4. Klik View di samping aturan yang dituju. Halaman Data Forwarding Rule akan muncul.

    Penting

    Jika halaman Data Forwarding (New Version) ditampilkan, klik Back to Previous Version di pojok kanan atas, lalu klik View di samping aturan yang dituju.

  5. Di bagian Forward Data, klik Add Operation.

  6. Pada kotak dialog Add Operation, pilih Operation untuk parameter Operation. Konfigurasikan parameter lainnya lalu klik OK.

    Parameter

    Deskripsi

    Operation

    Pilih Store Data to ApsaraDB RDS.

    Region

    Wilayah tempat instans Platform IoT Anda berada. Parameter ini bersifat tetap.

    RDS instance

    Pilih instans ApsaraDB RDS tujuan.

    Database

    Masukkan nama database.

    Catatan

    Untuk database berhak istimewa tinggi, Anda harus memasukkan nama database secara manual.

    Account

    Masukkan username untuk instans ApsaraDB RDS. Akun ini harus memiliki izin baca dan tulis pada database tersebut. Jika tidak, mesin aturan tidak dapat menulis data ke instans ApsaraDB RDS.

    Catatan

    Setelah mesin aturan memperoleh akun tersebut, ia hanya menulis data yang sesuai aturan ke database dan tidak melakukan operasi lainnya.

    Password

    Masukkan password untuk akun database.

    Table name

    Masukkan nama tabel yang telah Anda buat di database. Mesin aturan akan menulis data ke tabel ini.

    Key

    Masukkan nama kolom dari tabel ApsaraDB RDS. Mesin aturan menyimpan data di kolom ini.

    Value

    Masukkan bidang dari muatan pesan topik yang didefinisikan dalam ekspresi SQL. Mesin aturan menyimpan nilai bidang ini ke kolom yang ditentukan oleh Key.

    Catatan
    • Tipe data Value harus sesuai dengan tipe data Key (kolom). Jika tidak, operasi penulisan akan gagal.

    • Anda dapat memasukkan variabel, seperti ${deviceName}.

    Role

    Pilih role RAM yang mengizinkan Platform IoT menulis data ke ApsaraDB RDS.

    Jika belum ada role RAM, klik Create RAM Role untuk membuat role RAM dan kebijakan otorisasi di Konsol RAM. Buat role RAM.

  7. Pada halaman Data Forwarding, temukan aturan tersebut lalu klik Start di kolom Actions.

  8. Di Konsol ApsaraDB RDS, pada halaman Data Security, konfigurasikan daftar putih. Mesin aturan memerlukan koneksi ke ApsaraDB RDS. Setelah Anda mengonfigurasi tujuan data, mesin aturan secara otomatis menambahkan alamat IP-nya ke daftar putih ApsaraDB RDS. Jika alamat IP berikut tidak ada di daftar putih, Anda harus menambahkannya secara manual.ApsaraDB RDS

    • China (Shanghai): 100.104.53.192/26,100.104.148.64/26,100.104.6.192/26,100.104.143.128/26,100.104.76.0/24,100.104.73.128/26,100.104.200.64/26,100.104.40.64/26,100.104.3.0/26,100.104.29.128/26,100.104.121.0/26,100.104.84.64/26

    • Asia Pasifik (Singapura): 100.104.106.0/24

    • AS (Silicon Valley): 100.104.8.0/24

    • AS (Virginia): 100.104.133.64/26

    • Jerman (Frankfurt): 100.104.160.192/26

    • Jepang (Tokyo): 100.104.160.192/26

    Di panel navigasi sebelah kiri instans ApsaraDB RDS Anda, klik Data Security. Pada tab Whitelist settings, klik Add whitelist group lalu tambahkan blok CIDR alamat IP untuk wilayah Platform IoT yang sesuai ke dalam grup tersebut.

Langkah selanjutnya

Referensi

  • Untuk menghubungkan perangkat ke Platform IoT dan melaporkan data, lihat Panduan koneksi perangkat.

  • Di halaman detail instans, periksa sumber daya TPS penerusan pesan yang tersedia untuk memastikan pesan perangkat dapat diteruskan ke database RDS. Untuk informasi selengkapnya, lihat Lihat informasi instans dan data operasional. Jika sumber daya tidak mencukupi, lakukan upgrade instans. Untuk informasi selengkapnya, lihat Upgrade instans.

  • Untuk pertanyaan umum mengenai database ApsaraDB RDS, lihat FAQ tentang database.