全部产品
Search
文档中心

ApsaraMQ for Kafka:Membuat topik secara otomatis

更新时间:Jul 06, 2025

ApsaraMQ for Kafka memungkinkan Anda menggunakan fitur pembuatan topik otomatis dalam skenario migrasi cloud dan pengujian. Setelah mengaktifkan fitur ini, Anda dapat membuat topik dengan menulis kode, sehingga tidak perlu membuat topik secara manual dan meningkatkan efisiensi.

Prasyarat

Sebuah ApsaraMQ for Kafka instance yang memenuhi kondisi berikut telah dibeli dan diterapkan.

Item

Deskripsi

Status

Running

Versi

Versi utama: V2.2.0 atau lebih baru. Versi minor: terbaru.

Catatan

Anda dapat melihat informasi status dan versi dari sebuah instance di bagian Basic Information pada halaman Instance Details di konsol ApsaraMQ for Kafka.

Catatan Penggunaan

  • Fitur pembuatan topik otomatis cocok untuk skenario migrasi cloud dan pengujian. Kami merekomendasikan agar Anda tidak mengaktifkan fitur ini di lingkungan produksi. Jika fitur ini diaktifkan di lingkungan produksi, hindari menggunakannya dalam aktivitas produksi utama.

  • Setelah mengaktifkan fitur daftar kontrol akses (ACL) untuk instance Edisi Profesional, sebuah topik tidak akan dibuat secara otomatis jika Anda mengirim pesan ke instance tanpa menentukan topik.

Prosedur

  1. Masuk ke Konsol ApsaraMQ for Kafka. Di bagian Resource Distribution pada halaman Overview, pilih wilayah tempat instance ApsaraMQ for Kafka yang ingin Anda kelola berada.

  2. Di halaman Instances, klik nama instance yang ingin Anda kelola.

  3. Di bagian Configuration Information pada halaman Instance Details, aktifkan sakelar Automatic Topic Creation.

    Catatan

    Berikut adalah konvensi penamaan untuk topik yang dibuat menggunakan fitur pembuatan topik otomatis:

    • Nama harus memiliki panjang 3 hingga 64 karakter.

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

    Setelah mengaktifkan fitur pembuatan topik otomatis, sebuah topik dapat dibuat dengan mengirim pesan ke instance ApsaraMQ for Kafka Edisi Standar Anda tanpa menentukan topik.

FAQ

Apakah topik dapat dibuat secara otomatis?

Ya, topik dapat dibuat secara otomatis. Namun, kami merekomendasikan agar Anda tidak mengaktifkan fitur pembuatan topik otomatis. ApsaraMQ for Kafka memungkinkan Anda mengelola topik di konsol atau dengan memanggil operasi API. Kami merekomendasikan agar Anda tidak mengaktifkan fitur pembuatan topik otomatis di lingkungan produksi karena alasan berikut:

  • Jika Anda mengaktifkan fitur pembuatan topik otomatis, fitur seperti kontrol izin granular dan audit tindakan sumber daya tidak dapat digunakan. Ini menimbulkan risiko keamanan bagi bisnis Anda.

  • Jika Anda mengaktifkan fitur pembuatan topik otomatis, Anda mungkin mengalami masalah seperti penggunaan sumber daya berlebih dan manajemen sumber daya yang tidak efisien. Masalah ini dapat menyebabkan ketidakstabilan sistem.

  • Topik mungkin gagal dibuat secara otomatis meskipun Anda mengaktifkan fitur pembuatan topik otomatis. Hal ini dapat memengaruhi bisnis Anda. Untuk informasi lebih lanjut, lihat Apa yang harus saya lakukan jika topik gagal dibuat secara otomatis?

Dalam skenario apa saya dapat mengaktifkan fitur pembuatan topik otomatis?

Kami merekomendasikan agar Anda tidak mengaktifkan fitur pembuatan topik otomatis kecuali dalam skenario seperti migrasi cloud dan pengujian. Setelah mengaktifkan fitur ini, gunakan hanya dalam skenario migrasi dan pengujian.

Apa yang harus saya lakukan jika topik gagal dibuat secara otomatis?

Anda dapat menggunakan metode berikut untuk menyelesaikan masalah:

  • Jika sejumlah sedang topik gagal dibuat secara otomatis, Anda dapat membuatnya secara manual di konsol ApsaraMQ for Kafka atau dengan memanggil operasi API yang sesuai.

  • Jika sejumlah besar topik gagal dibuat secara otomatis, Anda dapat menganalisis masalah dengan memeriksa log atau merujuk pada alasan yang mungkin berikut:

    • Operasi tidak valid: Jika Anda melakukan operasi tidak valid, topik gagal dibuat secara otomatis dan tidak dapat digunakan. Hal ini dapat memengaruhi bisnis Anda. Berikut adalah kemungkinan operasi tidak valid:

      • Nama topik: Setelah mengaktifkan fitur pembuatan topik otomatis, sistem secara otomatis membuat topik saat diperlukan. Jika nama topik tidak mengikuti konvensi penamaan, topik tidak dapat dibuat. Misalnya, nama tersebut tidak valid atau panjang nama melebihi batas.

      • Pengaturan topik: Jika Anda menentukan mesin yang tidak tepat untuk topik atau kuota tersisa untuk topik dan partisi tidak mencukupi, topik gagal dibuat secara otomatis.

      • ACL: Setelah fitur ACL diaktifkan, topik tidak dibuat secara otomatis saat Anda mengirim pesan ke instance ApsaraMQ for Kafka Anda tanpa menentukan topik.

    • Faktor tak terduga: Faktor tak terduga dapat muncul dan menyebabkan penundaan signifikan dalam pembuatan topik otomatis. Dalam hal ini, topik gagal dibuat karena permintaan pembuatan habis waktu. Hal ini sangat memengaruhi bisnis Anda. Faktor-faktor ini termasuk gangguan jaringan, pembaruan broker, pembaruan atau pemeliharaan konsol, dan kegagalan instance Elastic Compute Service (ECS).

    • Konflik data: Saat sistem secara otomatis membuat topik, sistem mungkin mengadopsi nama yang sama dengan topik lain. Dalam hal ini, data dari kedua topik mungkin direkam dan sistem mungkin gagal mendeteksi konflik. Bahkan jika konflik terdeteksi, jarang dapat diselesaikan dan dapat menyebabkan kerugian yang tidak dapat diperbaiki.

    • Latensi: Memicu topik yang dibuat secara otomatis membutuhkan waktu jauh lebih lama daripada memicu topik yang sudah ada. Hal ini dapat menyebabkan gangguan bisnis sementara. Dalam banyak kasus, bisnis tidak dapat menanggung gangguan semacam itu.

    • Sumber daya tidak mencukupi: Jika batas atas partisi atau topik tercapai, tidak ada lagi topik yang dapat dibuat.

Referensi