トピックの管理 - ApsaraMQ for RocketMQ

トピックは、ApsaraMQ for RocketMQ における主要なメッセージルーティングの構成要素です。パブリッシュ/サブスクライブ (pub/sub) モデルでは、プロデューサーがトピックにメッセージを送信し、コンシューマーがそのトピックをサブスクライブしてメッセージを受信します。ビジネスドメインごとにトピックを整理します。たとえば、注文イベント用に 1 つのトピック、物流の更新用に別のトピック、支払い通知用に 3 つ目のトピックを作成します。

このページでは、ApsaraMQ for RocketMQ コンソールでトピックを作成、表示、更新、削除する方法について説明します。プログラムでトピックを管理するには、「API リファレンス」をご参照ください。

事前準備

ApsaraMQ for RocketMQ インスタンスが利用可能であること。作成するには、インスタンス管理のドキュメントをご参照ください。
トピックのメッセージタイプを決定済みであること。各トピックは 1 つのメッセージタイプのみをサポートし、この設定は作成後に変更できません。詳細については、「メッセージタイプ」をご参照ください。

主な制約

トピックを作成する前に、次の制約を確認してください。

制限	説明
インスタンススコープ	トピックは1つのインスタンスに属し、インスタンスをまたいで使用することはできません。
メッセージタイプは変更不可	作成時に選択したメッセージタイプによって、トピックが受け入れるメッセージが決定されます。不一致が発生すると、エンドポイントの変更やインスタンス移行時にスケジュールされたメッセージの損失など、運用・保守上の問題を引き起こす可能性があります。
課金	各トピックには、使用量にかかわらず占有料金が発生します。不要な料金を回避するために、未使用のトピックを削除してください。詳細については、「メッセージング機能の課金」および「課金」をご参照ください。

命名ルール

トピック名は、次の要件を満たす必要があります：

長さが 3～64 文字であること
文字、数字、ハイフン (-)、アンダースコア (_) のみを含むこと

一意性の要件は、インスタンスに名前空間があるかどうかによって異なります：

インスタンスタイプ	一意性の範囲	詳細
名前空間あり	インスタンス内	名前は、同じインスタンス内の既存のトピック名またはグループ ID と重複することはできません。異なるインスタンス間では名前を共有できます。
名前空間なし	すべてのインスタンスおよびリージョン間	名前は、ご利用の Alibaba Cloud アカウント内の既存のトピック名またはグループ ID と重複することはできません。

説明

インスタンスに名前空間があるかどうかを、[インスタンスの詳細] ページの [基本情報] セクションで確認してください。

トピックの作成

ApsaraMQ for RocketMQ コンソールにログインします。ナビゲーションウィンドウで、[インスタンス] をクリックします。
上部のナビゲーションバーで、[中国 (杭州)] などのリージョンを選択します。管理したいインスタンスの名前をクリックします。
ナビゲーションウィンドウで、[トピック] をクリックします。左上の [トピックの作成] をクリックします。

[トピックの作成] パネルで、次のパラメーターを設定し、[OK] をクリックします。

パラメーター	説明
[名前]	命名ルールに従った一意のトピック名。
[説明]	トピックの目的の簡単な説明。
メッセージの種類	このトピックが処理するメッセージのタイプ。この値は作成後に変更できません。

重要

トピックは、そのメッセージタイプに一致するメッセージのみを送受信できます。たとえば、通常メッセージタイプで作成されたトピックは、通常メッセージのみを受け入れます。詳細については、「メッセージタイプ」をご参照ください。

トピック詳細の表示

[インスタンス] ページで、管理したいインスタンスの名前をクリックします。ナビゲーションウィンドウで、[トピック] をクリックします。
トピックリストで、トピック名をクリックするか、[アクション] 列の [詳細] をクリックします。

トピックの説明の更新

[インスタンス] ページで、管理したいインスタンスの名前をクリックします。ナビゲーションウィンドウで、[トピック] をクリックします。
トピックリストで対象のトピックを見つけ、[アクション] 列の [詳細] をクリックします。
[基本情報] セクションで、[トピックの説明] フィールドの横にある [編集] をクリックします。新しい説明を入力し、[OK] をクリックします。

トピックの削除

警告

トピックの削除は元に戻せません。削除後は、プロデューサーによるトピックへのメッセージ送信、およびコンシューマーによるメッセージのコンシュームが不可能になります。また、トピック内のすべてのメタデータとメッセージは完全に削除されます。

[インスタンス] ページで、管理したいインスタンスの名前をクリックします。ナビゲーションウィンドウで、[トピック] をクリックします。
トピックリストで対象のトピックを見つけ、[アクション] 列の [その他] をクリックし、[削除] を選択します。
確認ダイアログボックスで、[OK] をクリックします。

API リファレンス

トピック管理には、次の API オペレーションが利用できます：

API	説明
OnsTopicCreate	トピックを作成します。
OnsTopicDelete	トピックを削除します。
OnsTopicList	トピックを照会します。
OnsTopicStatus	トピックの総メッセージ数と最終更新時刻を照会します。
OnsTopicSubDetail	トピックのサブスクリプションを照会します。