All Products
Search

This Product

    ApsaraMQ for Kafka:Membuat topik secara otomatis

    Document Center

    ApsaraMQ for Kafka:Membuat topik secara otomatis

    Last Updated:Jul 18, 2026

    Untuk skenario migrasi cloud dan pengujian, Anda dapat mengaktifkan pembuatan topik otomatis guna membuat topik secara terprogram tanpa menggunakan Konsol.

    Prasyarat

    Anda telah membeli dan men-deploy instans Message Queue for Apache Kafka yang memenuhi persyaratan berikut:

    Item

    Deskripsi

    Status

    Running

    Versi

    Versi utama adalah 2.2.0 atau lebih baru, dan versi minor adalah versi terbaru.
    Catatan

    Anda dapat melihat status dan versi instans di bagian Basic Information pada halaman Instance Details di Konsol Message Queue for Apache Kafka.

    Catatan penggunaan

    • Penting: Fitur ini hanya ditujukan untuk skenario migrasi dan pengujian. Kami sangat menyarankan agar Anda tidak mengaktifkan pembuatan topik otomatis di lingkungan produksi. Jika terpaksa mengaktifkannya di lingkungan produksi, jangan gunakan untuk layanan produksi kritis.

    • Pada instans Edisi Profesional dengan ACL diaktifkan, Anda tidak dapat membuat topik secara otomatis dengan mengirim pesan.

    Prosedur

    1. Masuk ke ApsaraMQ for Kafka console. Pada halaman Overview, pilih wilayah di bagian Resource Distribution.

    2. Pada halaman Instances, klik nama instans target.

    3. Pada halaman Instance Details, di bagian Configuration Information, aktifkan sakelar Automatic Topic Creation.

      Catatan

      Konvensi penamaan untuk topik yang dibuat secara otomatis:

      • Panjangnya harus antara 3 hingga 64 karakter.

      • Hanya boleh berisi huruf, angka, tanda hubung (-), dan garis bawah (_), serta harus mengandung setidaknya satu huruf atau angka.

      Pada instans Edisi Standar dengan fitur ini diaktifkan, mengirim pesan ke topik yang belum ada akan secara otomatis membuat topik tersebut. Topik baru tersebut kemudian akan muncul di Konsol.

    FAQ

    Apakah topik dapat dibuat secara otomatis?

    Ya, tetapi kami sangat menyarankan untuk tidak melakukannya. Di Message Queue for Apache Kafka, sebaiknya Anda mengelola topik menggunakan Konsol Message Queue for Apache Kafka dan OpenAPI. Kami menyarankan agar tidak mengaktifkan pembuatan topik otomatis di lingkungan produksi karena alasan berikut:

    • Pembuatan topik otomatis tidak mendukung kontrol izin detail halus atau audit operasi resource, sehingga menimbulkan risiko keamanan dan tata kelola.

    • Dapat menyebabkan konsumsi resource yang tidak terkendali, sehingga mengganggu stabilitas sistem.

    • Pembuatan topik otomatis tidak dijamin berhasil, dan kegagalan dapat mengganggu layanan Anda. Untuk informasi lebih lanjut, lihat Apa yang harus saya lakukan jika pembuatan topik otomatis gagal?

    Kapan saya harus mengaktifkan pembuatan topik otomatis?

    Aktifkan fitur ini hanya untuk kasus penggunaan tertentu seperti migrasi cloud cepat dan pengujian. Jangan menggunakannya di luar skenario tersebut.

    Penanganan kegagalan pembuatan topik otomatis

    Jika pembuatan topik otomatis gagal, Anda dapat mencoba solusi berikut:

    • Jika Anda hanya perlu membuat beberapa topik, kami menyarankan membuatnya secara manual di Konsol atau menggunakan OpenAPI.

    • Periksa log atau lakukan pemecahan masalah berdasarkan kemungkinan penyebab berikut:

      • Operasi tidak valid: Operasi yang tidak valid dapat mencegah topik dibuat atau digunakan dengan benar, sehingga memengaruhi layanan Anda. Contohnya meliputi:

        • Nama topik tidak valid: Nama topik yang ditentukan oleh aplikasi tidak memenuhi Konvensi penamaan. Misalnya, nama tersebut mengandung karakter yang tidak valid atau melebihi batas panjang.

        • Konfigurasi topik tidak valid: Mesin broker dipilih secara tidak tepat, atau kuota untuk topik atau partisi tidak mencukupi.

        • ACL diaktifkan: Jika fitur ACL diaktifkan, Anda tidak dapat membuat topik secara otomatis dengan mengirim pesan.

      • Faktor eksternal yang tidak terkendali: Faktor eksternal seperti fluktuasi jaringan, peningkatan server, maintenance platform manajemen, atau kegagalan Instance ECS dapat secara signifikan memperpanjang waktu pembuatan topik dan menyebabkan kegagalan.

      • Konflik layanan: Pembuatan topik otomatis dapat menyebabkan konflik penamaan antar layanan, sehingga mencampur data lintas layanan. Masalah semacam ini sulit dideteksi dan dipulihkan, berpotensi menyebabkan kehilangan data yang tidak dapat dipulihkan.

      • Masalah latensi: Membuat topik sesuai permintaan membutuhkan waktu jauh lebih lama dibandingkan menggunakan topik yang sudah ada, berpotensi menyebabkan gangguan layanan singkat.

      • Batas kuota: Pembuatan topik gagal jika kuota untuk topik atau partisi telah terlampaui.

    Referensi