使用資料來源

使用 AWS IoT SiteWise 主控台 或管理您的資料串流 AWS CLI。

Console

使用主 AWS IoT SiteWise 控台管理您的資料串流。

若要管理資料串流 (主控台)

1. 導覽至 AWS IoT SiteWise 主控台。

2. 在導覽窗格中，選擇 [資料串流]。

3. (選擇性) 若要新增或更新標籤，請選取要編輯的資料串流，然後選擇「管理標籤」。

   在 [編輯標籤] 頁面上，選擇 [新增標籤]。在「機碼」欄位中，輸入要使用的標籤名稱。

   選擇 Save (儲存)。

4. (選擇性) 在「資料串流」表格中，您可以使用下列方式篩選資料串流。

   • 在第一個下拉式選單中，選取「別名首碼」或「資產 ID」。

     • 別名前置詞 — 資料流的別名前置詞。如果您的目標資料流具有別名前置詞，則可以選擇此選項。

     • 資產 ID — 在其中建立資產屬性的資產 ID。如果您的目標資料串流與資產屬性相關聯，則可以選擇此選項。

   • 在第二個下拉式功能表中，選取 [所有資料串流]、[關聯的資料串流] 或 [取消關聯的資料串流

     • 所有資料串流 — 與某個資產屬性相關聯或未關聯的資料串流。

     • 關聯的資料串流 — 與資產屬性相關聯的資料串流。

     • 取消關聯的資料串流 — 與資產屬性無關聯的資料串流。

5. 選取您要管理的資料串流。 AWS IoT SiteWise 在頁面底部的圖形中顯示您選擇的資料串流。如果您選取 10 個以上，圖表將僅顯示前 10 個。

6. (選擇性) 以下列方式設定圖形。

   1. 針對彙總函數，選取下列其中一項。

      • 資料點計數 — 指定變數在目前時間間隔內的資料點總數。

      • 平均值 — 指定變數值在目前時間間隔內的平均值。

      • Sum — 指定變數在目前時間間隔內值的總和。

      • 最小值 — 目前時間間隔內指定變數值的最小值。

      • Maxi@@ mum — 目前時間間隔內指定變數值的最大值。

      如需詳細資訊，請參閱在公式運算式中使用彙總函數。

   2. 在「時間範圍」中，選取下列其中一項。

      • 過去 1 小時 — 圖表會顯示過去一小時的彙總資料。

      • 過去 2 小時 — 圖表會顯示過去兩小時的彙總資料。

      • 過去 3 小時 — 圖表會顯示過去三小時的彙總資料。

      • 過去 4 小時 — 圖表會顯示過去四小時的彙總資料。

   3. 在「時間間隔」中，選取下列其中一項。

      • 1 分鐘 — 每分鐘彙總指定時間範圍內的資料。

      • 1 小時 — 每小時彙總指定時間範圍內的資料。

7. 選擇 [管理資料串流]。

8. 在 [更新資料串流關聯] 區段的 [度量名稱] 欄中，執行下列其中一個動作。

   • 如果資料串流與度量相關聯，請選擇關閉圖示來刪除關聯。

   • 如果資料串流與度量沒有關聯，請選擇「選擇度量」。

9. 在「選擇度量」表中，導覽至目標資產，然後選擇您要關聯的度量。

10. (可選) 在「更新資產性質別名」區段中，為每個測量輸入唯一的別名。

11. 選擇更新。

「狀態」(Status) 欄可顯示下列其中一個值。

• 擱置中 — 您正在更新資料串流關聯或資產屬性別名。

• 提交 — 儲存您對關聯或資產屬性別名的變更。

• 錯誤 — AWS IoT SiteWise 無法處理您更新資料串流關聯或測量別名的請求。

• 成功 — 您已成功更新資料流關聯或測量的別名。

AWS CLI

使用下列API操作來管理您的資料串流。程式碼範例使用 AWS CLI.

• AssociateTimeSeriesToAssetProperty— 將資料串流 (時間序列) 與資產屬性相關聯。

• DisassociateTimeSeriesFromAssetProperty— 取消資料串流與資產屬性的關聯性。

• DeleteTimeSeries— 刪除資料串流。

• DescribeTimeSeries— 擷取有關資料串流的資訊。

• ListTimeSeries— 擷取資料串流的分頁清單。

AssociateTimeSeriesToAssetProperty

若要將資料串流與資產性質相關聯，請執行下列命令。

重要

指定的資產屬性目前不得與任何資料串流相關聯。

• Replace (取代) data-stream-alias 與您關聯的資料串流的別名。

• Replace (取代) asset-ID 具有在其中建立資產性質的資產 ID。

• Replace (取代) property-ID 與資產屬性的 ID。

aws iotsitewise associate-time-series-to-asset-property \ 
                         --alias data-stream-alias \
                         --assetId asset-ID \
                         --propertyId property-ID

DisassociateTimeSeriesFromAssetProperty

若要取消資料串流與資產性質的關聯，請執行下列命令。

• Replace (取代) data-stream-alias 與您要取消關聯的數據流的別名。

• Replace (取代) asset-ID 具有在其中建立資產性質的資產 ID。

• Replace (取代) property-ID 與資產屬性的 ID。

aws iotsitewise disassociate-time-series-from-asset-property \ 
                         --alias data-stream-alias \
                         --assetId asset-ID \
                         --propertyId property-ID

DeleteTimeSeries

若要刪除資料串流，請執行下列命令。

Replace (取代) data-stream-alias 與您要刪除的數據流的別名。

aws iotsitewise delete-time-series --alias data-stream-alias

若要識別資料串流，請執行下列任一項作業：

• 如果資料串流未與資產屬性相關聯，請指定alias資料串流的。

• 如果資料串流與資產性質相關聯，請指定下列其中一項：

  • 資料串流alias的。

  • 識assetId別propertyId資產性質的和。

DescribeTimeSeries

使用此DescribeTimeSeriesAPI作業可確認您是否成功關聯或取消資料串流的關聯。

若要擷取有關資料串流的資訊，請執行下列命令。

aws iotsitewise describe-time-series --alias data-stream-alias

若要識別資料串流，請執行下列任一項作業：

• 如果資料串流未與資產屬性相關聯，請指定alias資料串流的。

• 如果資料串流與資產性質相關聯，請指定下列其中一項：

  • 資料串流alias的。

  • 識assetId別propertyId資產性質的和。

ListTimeSeries

使用此ListTimeSeriesAPI作業驗證是否已成功刪除資料串流。

若要擷取資料串流的分頁清單，請執行下列命令。

aws iotsitewise list-time-series