

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 일반적인 시나리오
<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를 사용하여 원하는 데이터 스트림을 자산 속성에 연결합니다.