教學課程：重新發佈 MQTT 訊息

開啟 AWS IoT主控台的規則中樞。

在 Rules (規則) 中，選擇Create(建立)，然後開始建立新規則。

在 Create a rule (建立規則) 的頂部中：

1. 在 Name (名稱) 中，輸入規則的名稱。在本教學課程中，請將其命名為 republish_temp。

   請記住，規則名稱在您的帳戶和區域內必須是唯一的，且不能有任何空格。我們在此名稱中使用底線字元來分隔規則名稱中的兩個單字。

2. 在 Description (說明) 中，說明規則。

   有意義的說明可幫助您記住此規則的作用及建立規則的原因。說明可依所需而定，因此請盡可能詳細說明。

在 Create a rule (建立規則) 的 Rule query statement (規則查詢陳述式) 中：

1. 在使用 SQL 版本中，選取 2016-03-23。

2. 在 Rule query statement (規則查詢陳述式) 編輯方塊中輸入陳述式：

   SELECT topic(2) as device_id, temperature FROM 'device/+/data'

   本陳述式：

   • 聆聽具與 device/+/data 主題篩選條件相符之主題的 MQTT 訊息。

   • 從主題字串中選取第二個元素，並將其指定給 device_id 欄位。

   • 從訊息承載選取值 temperature 欄位，並將其指派給 temperature 欄位。

在 Set one or more actions (設定一個或多個動作) 中：

1. 若要開啟此規則的規則動作清單，請選擇 Add action (新增動作)。

2. 在選取動作中，選擇將訊息重新發佈至 AWS IoT主題。

3. 在動作清單底部，選擇設定動作以開啟所選動作的組態頁面。

在 Configure action (設定動作)：

1. 在 Topic (主題) 中，輸入 device/data/temp。這是此規則將發佈訊息的 MQTT 主題。

2. 在Quality of Service (服務品質) 中，選擇 0 - The message is delivered zero or more times (0 - 訊息傳遞零次或多次)。

3. 在選擇或建立角色以授予執行此動作的AWS IoT存取權：

   1. 選擇 Create Role (建立角色)。Create a new role (建立新角色) 對話方塊隨即開啟。

   2. 輸入可說明新角色的名稱。在本教學課程中，使用 republish_role。

      當您建立新角色時，會建立執行規則動作的正確政策，並將其連接至新角色。如果您變更此規則動作的主題，或在其他規則動作中使用此角色，則必須更新該角色的政策，以授權新的主題或動作。若要更新現有角色，請選擇本節中的 Update role (更新角色)。

   3. 選擇Create Role (建立角色)，以建立角色並關閉對話方塊。

4. 選擇Add action (新增動作)，將動作新增至規則，並返回Create a rule (建立規則) 頁面。

將訊息重新發佈至AWS IoT主題動作現在列在設定一或多個動作中。

在新動作的圖標中，Republish a message to an AWS IoT topic (將訊息重新發佈至 IoT 主題) 之下，您可看到重新發佈動作將發佈的主題。

這是您將新增至此規則的唯一規則動作。

在 Create a rule (建立規則) 中，向下捲動至底部，然後選擇 Create rule (建立規則)，建立規則並完成此步驟。

在 AWS IoT 主控台的 MQTT 用戶端 中，訂閱輸入主題，在此案例中為 device/+/data。

1. 在 MQTT 用戶端中的 Subscriptions (訂閱) 下選擇 Subscribe to a topic (訂閱主題)。

2. 在 Subscription topic (訂閱主題) 中，輸入輸入主題篩選條件 device/+/data 的主題 。

3. 將剩下的欄位保留為其預設設定。

4. 請選擇 Subscribe to topic (訂閱主題)。

   在 Subscriptions (訂閱) 欄中，Publish to a topic (發佈到主題) 之下，device/+/data 隨即顯示。

訂閱規則將發佈的主題：device/data/temp。

1. 在 Subscriptions (訂閱) 之下，選擇 Subscribe to a topic (訂閱主題)，並在 Subscription topic (訂閱主題) 中，輸入重新發佈訊息 device/data/temp 的主題。

2. 將剩下的欄位保留為其預設設定。

3. 請選擇 Subscribe to topic (訂閱主題)。

   在 Subscriptions (訂閱) 欄中，device/+/data 之下，device/data/temp 隨即顯示。

使用特定裝置 ID device/22/data，將訊息發佈至輸入主題。您無法發佈至包含萬用字元的 MQTT 主題。

1. 在 MQTT 用戶端中的 Subscriptions (訂閱) 下選擇 Publish to topic (發佈至主題)。

2. 在 Publish (發佈) 欄位中輸入輸入主題名稱 device/22/data。

3. 複製此處顯示的範例資料，並在主題名稱下方的編輯方塊中貼上範例資料。

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. 若要傳送 MQTT 訊息，請選擇 Publish to topic (發佈至主題)。

檢閱傳送的訊息。

1. 在 MQTT 用戶端中的 Subscriptions (訂閱) 下，您先前訂閱的兩個主題旁會有一個綠點。

   該綠點表示自上次查看後，已收到一個或多個新訊息。

2. 於 Subscriptions (訂閱) 下，選擇 device/+/data，來檢查訊息承載是否與您剛剛發佈的內容相符，如下所示：

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

3. 於 Subscriptions (訂閱) 下，選擇 device/data/temp，來檢查您重新發佈的訊息承載，如下所示：

   {
     "device_id": "22",  
     "temperature": 28
   }

   請注意，device_id 值是個帶有引號的字串，而 temperature 值是個數字。這是因為 topic() 函數從輸入訊息的主題名稱中提取字串，而 temperature 值會使用輸入訊息承載的數值。

   若要將 device_id 值設為數值，請將規則查詢陳述式中的 topic(2) 替換為：

   cast(topic(2) AS DECIMAL)

   請注意，將 topic(2) 值轉換為數值，僅適用於主題的該部分僅包含數字字元時。

若您看到正確的訊息已發佈至 device/data/temp 主題，則您的規則有效。請參閱下一節，了解更多 Republish (重新發佈) 規則動作的相關資訊。

若您看不到正確的訊息已發佈至 device/+/data 或 device/data/temp 主題中，請查看疑難排解提示。