

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

# 常用案例
<a name="data-ingestion-scenarios"></a>

## 移動資料串流
<a name="data-ingestion-scenario-move-data-stream"></a>

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

```
    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>
```

## 將別名指派給資產屬性時發生錯誤
<a name="data-ingestion-scenario-assetid-contains-data"></a>

 使用 `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 將別名指派給資產屬性，然後重新開啟資料擷取。

## 將資料串流與資產屬性建立關聯時發生錯誤
<a name="data-ingestion-scenario-move-data-stream"></a>

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

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

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

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

 若要保留儲存在資產屬性中的資料，請執行下列動作：
+  確保資產屬性未擷取任何資料，以防止建立新的資料串流。
+  使用 `UpdateAssetProperty` API 設定提供給目前指派資料串流的新別名。
+  使用 `DisassociateTimeSeriesFromAssetProperty` API 取消目前資料串流與資產屬性的關聯。
+  使用 `AssociateTimeSeriesToAssetProperty` API 將所需的資料串流與資產屬性建立關聯。

 如果必須刪除存放在資產屬性中的資料，請執行下列動作：
+  確保資產屬性未擷取任何資料，以防止建立新的資料串流。
+  使用 `DeleteTimeSeries` API 刪除目前指派的資料串流。
+  使用 `AssociateTimeSeriesToAssetProperty` API 將所需的資料串流與資產屬性建立關聯。