教學課程：將裝置資料儲存在 DynamoDB 表格中

開啟 DynamoDB 主控台，然後選擇 Create table (建立表格)。

在 Create table (建立資料表) 中：

1. 於 Table name (表格名稱) 中，輸入表格名稱：wx_data。

2. 在 Primary key (主索引鍵) 中，輸入 sample_time，然後在欄位旁的選項清單中，選擇 Number。

3. 在 Sort key (排序索引鍵) 中，輸入 device_id，然後在欄位旁的選項清單中，選擇 Number。

4. 請在頁面底部，選擇 Create (建立)。

開啟AWS IoT 主控台的 Rules (規則) 中樞。或者，您可以在 AWS 管理主控台 中開啟 AWS IoT 首頁，並導覽至訊息路由＞規則。

如要在 Rules (規則) 中開始建立新規則，請選擇 Create rule (建立規則)。

在 Rule properties (規則屬性) 中：

1. 在 Rule name (規則名稱) 中，輸入 wx_data_ddb。

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

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

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

選擇 Next (下一步) 繼續。

在 SQL statement (SQL 陳述式) 中：

1. 在 SQL version (SQL 版本) 中，選取 2016-03-23。

2. 在 SQL statement (SQL 陳述式) 編輯方塊中，輸入陳述式：

   SELECT temperature, humidity, barometer,
     wind.velocity as wind_velocity,
     wind.bearing as wind_bearing,
   FROM 'device/+/data'

   本陳述式：

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

   • 將 wind 屬性的元素格式化為個別屬性。

   • 傳遞 temperature、humidity 和 barometer 屬性不變。

選擇 Next (下一步) 繼續。

在 Rule actions (規則動作) 中：

1. 若要開啟此規則的規則動作清單，請於 Action 1 (動作 1) 中，選擇 DynamoDB。

   注意

   請務必選擇 DynamoDB 而非 DynamoDBv2 作為規則動作。

2. 於 Table name (表格名稱) 中，選擇您在先前步驟中建立的 DynamoDB 表格名稱：wx_data。

   Partition key type (分割區索引鍵類型) 和 Sort key type (排序索引鍵類型) 欄位，都會填入 DynamoDB 表格中的值。

3. 在 Partition key (分區索引鍵)，輸入 sample_time。

4. 在 Partition key value (分割區索引鍵值) 中，輸入 ${timestamp()}。

   這是您將用於此規則中 替代範本 的首項。而非使用訊息承載中的值，其會使用 timestamp 函數傳回的值。如需進一步了解，請參閱AWS IoT Core 開發人員指南中的時間戳記。

5. 在 Sort key (排序索引鍵) 中，輸入 device_id。

6. 在 Sort key value (排序索引鍵值) 中，輸入 ${cast(topic(2) AS DECIMAL)}。

   這是您將用於此規則中 替代範本 第二項。其會在主題名稱中插入第二個元素值，即裝置的 ID，然後將其轉換為 DECIMAL 值，以與索引鍵的數值格式相符。若要進一步了解主題，請參閱AWS IoT Core 開發人員指南中的主題。或者，若要了解將值轉換為數值的詳細資訊，請參閱AWS IoT Core 開發人員指南中的將值轉換為數值。

7. 在 Write message data to this column (寫入訊息資料至此欄) 中輸入 device_data。

   這會建立 DynamoDB 表格中的 device_data 欄。

8. 將 Operation (操作) 保持空白。

9. 在 IAM Role (IAM 角色) 中，選擇 Create a new Role (建立新角色)。

10. 在 Create role (建立角色) 對話方塊中，請為 Role name (角色名稱) 輸入 wx_ddb_role。這個新角色會自動包含以 "aws-iot-rule" 為字首的政策，其允許 wx_data_ddb 規則將資料傳送到您建立的 wx_data DynamoDB 資料表。

11. 在 IAM role (IAM 角色) 中，選擇 wx_ddb_role。

12. 請選擇頁面最下方的 Next (下一頁)。

請在 Review and create (檢閱和建立) 頁面底部，選擇 Create (建立) 來建立規則。

於 AWS IoT 主控台的 MQTT 用戶端 中，訂閱輸入主題 device/+/data。

1. 於 MQTT 用戶端中，選擇 Subscribe to a topic (訂閱主題)。

2. 若為 Topic filter (主題篩選條件)，請輸入輸入主題篩選條件的主題 device/+/data。

3. 選擇 Subscribe (訂閱)。

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

1. 於 MQTT 用戶端中，請選擇 Publish to a topic (發佈至主題)。

2. 若為 Topic name (主題名稱)，請輸入輸入主題名稱 device/22/data。

3. 若為 Message payload (訊息承載)，請輸入下列範例資料。

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

4. 如要發佈 MQTT 訊息，請選擇 Publish (發佈)。

5. 現在，於 MQTT 用戶端中，選擇 Subscribe to a topic (訂閱主題)。於 Subscribe (訂閱) 欄中，選擇 device/+/data 訂閱。確認上一步的範例資料會顯示於此處。

查看您規則所建立 DynamoDB 表格中的列。

1. 在AWS IoT 主控台的 DynamoDB Tables 中樞中，選擇 wx_data，然後選擇項目索引標籤。

   若您已在 Items (項目) 索引標籤上，您可能需要選擇表格標題右上角的重新整理圖示來重新整理該顯示。

2. 請注意，表格中的 sample_time 值為連結並開啟一個。若您剛傳送了第一則訊息，則其將是清單中唯一的訊息。

   此連結會顯示表格該列中的所有資料。

3. 展開 device_data 項目，查看規則查詢陳述式所產生的資料。

4. 探索此顯示中可用資料的不同表示法。您亦可於此顯示中編輯資料。

5. 完成查閱此資料列之後，如要儲存所做的任何變更，請選擇 Save (儲存)，或者，如要結束而不儲存任何變更，請選擇 Cancel (取消)。