

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 常见场景
<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
```

 此错误消息表示该别名未分配给该属性，因为该别名当前正由其他属性或数据流使用。

 如果 Amazon 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
```

 此错误消息表明 asset 属性已与包含数据的数据流相关联。在将其他数据流与该资产属性关联之前，必须取消关联或删除该数据流。

**注意**  
 解除数据流与资产属性的关联时，分配给该属性的别名会被赋予数据流。要使该别名保持分配给该属性的状态，请在取消关联数据流之前为该属性分配一个新的别名。

 要保留存储在 asset 属性中的数据，请执行以下操作：
+  确保没有向资产属性提取任何数据，以防止创建新的数据流。
+  使用 `UpdateAssetProperty` API 为当前分配的数据流设置一个新的别名。
+  使用 `DisassociateTimeSeriesFromAssetProperty` API 取消当前数据流与资产属性的关联。
+  使用 `AssociateTimeSeriesToAssetProperty` API 将所需的数据流关联到资产属性。

 如果必须删除存储在资产属性中的数据，请执行以下操作：
+  确保没有向资产属性提取任何数据，以防止创建新的数据流。
+  使用 `DeleteTimeSeries` API 删除当前分配的数据流。
+  使用 `AssociateTimeSeriesToAssetProperty` API 将所需的数据流关联到资产属性。