すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:トピック エイリアス

最終更新日:Mar 26, 2025

このトピックでは、MQTT 5.0 のトピック エイリアス機能について説明します。

背景情報

セルラーネットワーク経由で IoT Platform に接続されているほとんどの IoT デバイスは、トラフィックと電力消費に敏感です。たとえば、農業シナリオで使用され、バッテリー駆動の温度センサーのトラフィックは、毎月数メガバイトに制限されています。この場合、データ送信に使用されるパケットが小さいほど、電力とトラフィックの消費を削減できます。トピック エイリアスを使用すると、トピック名を数値に置き換えて、メッセージを含むデータパケットの長さを短縮できます。ほとんどの場合、ビジネス プロパティを含むトピック名は数十バイトの長さになり、ペイロードの長さを超える可能性があります。トピック エイリアスを使用すると、トピック名をわずか 4 バイト長の数値に置き換えることができます。

制限事項

  • トピック エイリアスは、トピック名とエイリアス間のマッピングに基づいて機能します。デバイスと IoT Platform は、対応するマッピングを維持する必要があります。マッピングは、デバイスがエイリアスを使用してメッセージを送信するときに初めて作成され、デバイスが切断されると削除されます。デバイスが IoT Platform に再接続し、対応するトピックを使用してメッセージを送信するたびに、トピック名とエイリアスの間にマッピングが作成されます。

  • 各エイリアスは一意である必要があります。エイリアスは 1 つのトピック名にのみ対応します。

  • トピック エイリアスを使用する場合は、メッセージを同時に公開しないでください。そうしないと、IoT Platform の分散アーキテクチャが原因で、同時に公開されたメッセージが失われる可能性があります。

  • IoT Platform では、最大 20 個のトピック エイリアスを指定し、トピック エイリアスを使用して最大 20 個のダウンストリームまたはアップストリーム メッセージを送信できます。

シナリオ

次の図は、トピック エイリアスの使用方法を示しています。この例では、温度センサーが使用されています。この例では、メッセージ A とメッセージ B のペイロードは同じです。メッセージ A にはトピック名とエイリアスが指定され、メッセージ B にはトピック エイリアスのみが指定されています。/sys/product_name/device_001/farmland_1234/sensors/temperature トピックの名前は、長さが 60 バイトを超えています。image..pngトピック エイリアスは、特定の量のトラフィックを節約します。