Message Queue for Apache RocketMQ では、トピックはメッセージの主要なカテゴリです。Message Queue for Apache RocketMQ は、プロデューサーがトピックにメッセージをパブリッシュし、コンシューマーがそれらのトピックをサブスクライブしてメッセージを受信する、パブリッシュ/サブスクライブモデルを採用しています。この記事では、Message Queue for Apache RocketMQ コンソールでトピックを作成、削除、更新、表示する方法について説明します。
注意事項
-
トピックはインスタンス内で分離されており、異なるインスタンス間では使用できません。たとえば、インスタンス A で作成されたトピックは、インスタンス B では使用できません。
-
トピックのメッセージタイプは、処理するメッセージと一致している必要があります。たとえば、通常メッセージを送受信するためにトピックを作成する場合、そのメッセージタイプは通常メッセージに設定する必要があります。パーティション順序付きメッセージやトランザクションメッセージなど、他のメッセージタイプには使用できません。そうしないと、スケジュールメッセージが失われるなどの問題が発生する可能性があります。
課金
Message Queue for Apache RocketMQ は、トピックが使用されていない場合でも、トピックごとにリソース使用料を請求します。未使用のトピックは削除することを推奨します。詳細については、「メッセージング価格詳細」および「Enterprise Platinum Edition の課金」をご参照ください。
トピックの命名規則
-
トピック名は 3~64 文字で、英字、数字、ハイフン (-)、アンダースコア (_) のみ使用できます。
-
トピックが属するインスタンスに名前空間がある場合、トピック名はインスタンス内で一意である必要があり、既存のトピック名またはグループ ID と一致してはなりません。トピック名は、異なるインスタンス間では重複できます。たとえば、インスタンス A のトピックは、インスタンス B のトピックまたはグループ ID と同じ名前にすることができます。
-
トピックが属するインスタンスに名前空間がない場合、トピック名はすべてのインスタンスとリージョンでグローバルに一意である必要があり、既存のトピック名またはグループ ID と一致してはなりません。
Message Queue for Apache RocketMQ コンソールの インスタンスの詳細 ページに移動し、基本情報 セクションを参照してください。
トピックの作成
ApsaraMQ for RocketMQコンソールにログインします。 左側のナビゲーションウィンドウで、インスタンス数 をクリックします。
上部のナビゲーションバーで、中国 (杭州) などのリージョンを選択します。 [インスタンス] ページで、管理するインスタンスの名前をクリックします。
-
左側メニューで トピック をクリックします。ページの左上で トピックの作成 をクリックします。
-
トピックの作成 パネルで、トピックの 名前 と [説明] を入力し、[メッセージタイプ] を選択して、[OK] をクリックします。
重要トピックは、作成時に指定されたメッセージタイプのみを処理できます。たとえば、メッセージタイプを通常メッセージに設定してトピックを作成した場合、そのトピックは通常メッセージの送受信にのみ使用できます。このトピックは順序付きメッセージには使用できません。詳細については、「メッセージタイプ」をご参照ください。
[名前] は 3~64 文字で、英字、数字、ハイフン (-)、アンダースコア (_) のみ使用できます。[商品タイプ] は自動的に [従量課金] に設定されます。[メッセージタイプ] には、[通常メッセージ]、[トランザクションメッセージ]、[パーティション順序付きメッセージ]、[スケジュール/遅延メッセージ] の 4 つのオプションがあります。
トピックの削除
トピックが削除されると、関連するプロデューサーとコンシューマーは直ちに動作を停止します。トピックのメタデータとメッセージデータも削除され、復元することはできません。慎重に操作してください。
-
インスタンス数 ページで、対象インスタンスの名前をクリックします。左側メニューで トピック をクリックします。
-
トピックのリストで、削除するトピックを探します。操作 列で 詳細 をクリックし、ドロップダウンメニューから 削除 を選択します。
-
確認ダイアログボックスで、[OK] をクリックします。
トピックの更新
-
インスタンス数 ページで、対象インスタンスの名前をクリックします。左側メニューで トピック をクリックします。
-
トピックのリストで、更新するトピックを探します。操作 列で 詳細 をクリックして トピックの詳細 ページを開きます。
-
基本情報 セクションで、トピックの記述 の横にある 編集 をクリックします。新しい説明を入力し、確定 をクリックします。
トピックの表示
-
インスタンス数 ページで、対象インスタンスの名前をクリックします。左側メニューで トピック をクリックします。
-
トピックのリストで、トピックの名前をクリックするか、その 操作 列の 詳細 をクリックします。
関連 API
次の API 操作を使用してトピックを管理することもできます:
-
トピックの作成: OnsTopicCreate
-
トピックの削除: OnsTopicDelete
-
トピックのリストの照会: OnsTopicList
-
トピック内のメッセージの総数とその最終更新時刻の照会: OnsTopicStatus
-
トピックのサブスクリプションの照会: OnsTopicSubDetail