常用案例 - AWS IoT SiteWise

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

常用案例

移動資料串流

若要變更資料串流與另一個資產屬性的關聯,請先取消資料串流與目前資產屬性的關聯。取消資料串流與資產屬性的關聯時,必須指派別名至該資產屬性。

aws iotsitewise disassociate-time-series-from-asset-property \ --alias <asset-property-alias> \ --assetId <asset-ID> \ --propertyId <property-ID>

現在將資料串流重新指派給新的資產屬性。

aws iotsitewise associate-time-series-from-asset-property \ --alias <data-stream-alias> \ --assetId <new-asset-ID> \ --propertyId <new-property-ID>

將別名指派給資產屬性時發生錯誤

使用 UpdateAssetProperty API 將別名指派給屬性時,您可能會看到下列錯誤訊息:

Given alias <data-stream-alias> for property <property-name> with ID <property-ID> already in use by another property or data stream

此錯誤訊息表示別名未指派給 屬性,因為目前由另一個屬性或資料串流使用。

如果 AWS IoT SiteWise 使用別名擷取資料至 ,就會發生這種情況。當資料以另一個資料串流或資產屬性未使用的別名傳送時,會使用該別名建立新的資料串流。以下兩個選項可解決問題。

  • 使用 AssociateTimeSeriesToAssetProperty API 將資料串流與其別名與資產屬性建立關聯。

  • 暫時停止資料擷取並刪除資料串流。使用 UpdateAssetProperty API 將別名指派給資產屬性,然後重新開啟資料擷取。

將資料串流與資產屬性建立關聯時發生錯誤

將資料串流與資產屬性建立關聯時,會看到下列錯誤訊息。

assetProperty <property-name> with assetId <asset-ID> propertyId <property-ID> contains data

此錯誤訊息表示資產屬性已與包含資料的資料串流相關聯。在將其他資料串流與該資產屬性建立關聯之前,該資料串流必須取消關聯或刪除。

注意

取消資料串流與資產屬性的關聯時,指派給屬性的別名會提供給資料串流。若要讓該別名保持指派給 屬性,請先將新的別名指派給該屬性,再取消資料串流的關聯。

若要保留儲存在資產屬性中的資料,請執行下列動作:

  • 確保資產屬性未擷取任何資料,以防止建立新的資料串流。

  • 使用 UpdateAssetProperty API 設定提供給目前指派資料串流的新別名。

  • 使用 DisassociateTimeSeriesFromAssetProperty API 取消目前資料串流與資產屬性的關聯。

  • 使用 AssociateTimeSeriesToAssetProperty API 將所需的資料串流與資產屬性建立關聯。

如果必須刪除存放在資產屬性中的資料,請執行下列動作:

  • 確保資產屬性未擷取任何資料,以防止建立新的資料串流。

  • 使用 DeleteTimeSeries API 刪除目前指派的資料串流。

  • 使用 AssociateTimeSeriesToAssetProperty API 將所需的資料串流與資產屬性建立關聯。