기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 에 대한 데이터 스트림 관리 AWS IoT SiteWise 데이터 스트림은 과거 시계열 데이터를 포함하는 리소스입니다. 각 데이터 스트림은 고유한 별칭으로 식별되므로 각 데이터의 오리진을 더 쉽게 추적할 수 있습니다. 데이터 스트림은 첫 번째 시계열 데이터가 수신될 AWS IoT SiteWise 때에서 자동으로 생성됩니다. 첫 번째 시계열 데이터가 별칭으로 식별되면는 해당 별칭에 자산 속성이 아직 할당되지 않은 경우 해당 별칭으로 새 데이터 스트림을 AWS IoT SiteWise 생성합니다. 또는 첫 번째 시계열 데이터가 자산 ID 및 속성 ID로 식별되는 경우는 새 데이터 스트림을 AWS IoT SiteWise 생성하고 해당 데이터 스트림을 자산 속성과 연결합니다. 자산 속성에 별칭을 할당하는 방법에는 두 가지가 있습니다. 사용되는 방법은 데이터가 AWS IoT SiteWise 먼저 로 전송되는지 또는 자산이 먼저 생성되는지에 따라 달라집니다. + 데이터가 AWS IoT SiteWise 먼저 로 전송되는 경우 할당된 별칭이 있는 데이터 스트림이 자동으로 생성됩니다. 나중에 자산을 생성할 때 [ AssociateTimeSeriesToAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssociateTimeSeriesToAssetProperty.html) API를 사용하여 데이터 스트림과 해당 별칭을 자산 속성에 연결합니다. + 자산이 먼저 생성된 경우 [ UpdateAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html) API를 사용하여 자산 속성에 별칭을 할당합니다. 나중에 데이터가 로 전송되면 AWS IoT SiteWise데이터 스트림이 자동으로 생성되고 자산 속성과 연결됩니다. 현재는 데이터 스트림을 측정값에만 연결할 수 있습니다. *측정값*은 타임스탬프가 지정된 온도 값 또는 타임스탬프가 지정된 분당 회전 수(RPM) 값 같은, 디바이스의 원시 센서 데이터 스트림을 나타내는 자산 속성 유형입니다. 이러한 측정값이 지표 또는 변환을 정의하면 수신 데이터가 특정 계산을 트리거합니다. 자산 속성은 한 번에 하나의 데이터 스트림에만 연결할 수 있다는 점에 유의해야 합니다. AWS IoT SiteWise 는 Amazon 리소스 이름(ARN) 리소스`TimeSeries`에를 사용하여 스토리지 요금을 결정합니다. 자세한 내용은 [AWS IoT SiteWise 요금](https://aws.amazon.com/iot-sitewise/pricing/)을 참조하세요. 다음 섹션에서는 AWS IoT SiteWise 콘솔 또는 API를 사용하여 데이터 스트림을 관리하는 방법을 보여줍니다. **Topics** + [권한 및 설정 구성](manage-data-streams-configuration.md) + [데이터 스트림을 자산 속성에 연결](manage-data-streams-method.md) + [자산 속성에서 데이터 스트림 연결 해제](disassociate-data-streams-method.md) + [데이터 스트림 삭제](delete-data-streams-method.md) + [자산 속성 별칭 업데이트](update-data-streams-method.md) + [일반적인 시나리오](data-ingestion-scenarios.md) # 권한 및 설정 구성 데이터 스트림은 첫 번째 시계열 데이터가 수신될 AWS IoT SiteWise 때에서 자동으로 생성됩니다. 수집된 데이터가 자산 속성과 연결되지 않은 경우는 자산 속성과 연결되도록 구성할 수 있는 연결 해제된 새 데이터 스트림을 AWS IoT SiteWise 생성합니다. IAM 정책을 AWS IoT SiteWise사용하여 수집할 데이터 유형을 지정하여 데이터를 전송하는 게이트웨이의 액세스 제어를 구성합니다. 다음 IAM 정책은 게이트웨이에서 연결 해제된 데이터 수집을 비활성화하는 동시에 자산 속성과 연결된 데이터 스트림에 대한 데이터 수집을 허용합니다. **Example 게이트웨이에서 연결 해제된 데이터 수집을 비활성화하는 IAM 사용자 정책** **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowPutAssetPropertyValuesUsingAssetIdAndPropertyId", "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "arn:aws:iotsitewise:*:*:asset/*" }, { "Sid": "AllowPutAssetPropertyValuesUsingAliasWithAssociatedAssetProperty", "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "arn:aws:iotsitewise:*:*:time-series/*", "Condition": { "StringLikeIfExists": { "iotsitewise:isAssociatedWithAssetProperty": "true" } } }, { "Sid": "DenyPutAssetPropertyValuesUsingAliasWithNoAssociatedAssetProperty", "Effect": "Deny", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "arn:aws:iotsitewise:*:*:time-series/*", "Condition": { "StringLikeIfExists": { "iotsitewise:isAssociatedWithAssetProperty": "false" } } } ] } ``` **Example 게이트웨이에서 모든 데이터 수집을 비활성화하는 IAM 사용자 정책** **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "DenyPutAssetPropertyValues", "Effect": "Deny", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": [ "arn:aws:iotsitewise:*:*:asset/*", "arn:aws:iotsitewise:*:*:time-series/*" ] } ] } ``` # 데이터 스트림을 자산 속성에 연결 AWS IoT SiteWise Console 또는를 사용하여 데이터 스트림을 관리합니다 AWS CLI. ------ #### [ Console ] AWS IoT SiteWise 콘솔을 사용하여 데이터 스트림을 관리합니다. **데이터 스트림을 관리하려면(콘솔) 다음을 수행하세요.** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 패널에서 **데이터 스트림**을 선택합니다. 1. 데이터 스트림 별칭을 필터링하거나 필터 드롭다운 메뉴에서 **연결 해제된 데이터 스트림을** 선택하여 데이터 스트림을 선택합니다. 1. 업데이트할 데이터 스트림을 선택합니다. 여러 데이터 스트림을 선택할 수 있습니다. 오른쪽 상단에서 **데이터 스트림 관리를** 클릭합니다. 1. 데이터 스트림 연결 **업데이트에서 연결할 데이터 스트림을** 선택하고 **측정 선택** 버튼을 클릭합니다. 1. **측정 선택** 섹션에서 해당 자산 측정 속성을 찾습니다. 측정값을 선택한 다음 **선택을** 클릭합니다. 1. 3단계에서 선택한 다른 데이터 스트림에 대해 4단계와 5단계를 수행합니다. 모든 데이터 스트림에 자산 속성을 할당합니다. 1. **업데이트를** 선택하여 변경 사항을 커밋합니다. 업데이트를 확인하는 성공 확인 배너가 표시됩니다. ------ #### [ AWS CLI ] 데이터 스트림(별칭으로 식별됨)을 자산 속성(IDs로 식별됨)에 연결하려면 다음 명령을 실행합니다. ``` aws iotsitewise associate-time-series-to-asset-property \ --alias \ --assetId \ --propertyId ``` ------ # 자산 속성에서 데이터 스트림 연결 해제 ------ #### [ Console ] AWS IoT SiteWise 콘솔을 사용하여 자산 속성에서 데이터 스트림의 연결을 해제합니다. **자산 속성에서 데이터 스트림의 연결을 해제하려면(콘솔)** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 패널에서 **데이터 스트림**을 선택합니다. 1. 데이터 스트림 별칭을 필터링하거나 필터 드롭다운 메뉴에서 **연결된 데이터 스트림을** 선택하여 데이터 스트림을 선택합니다. 1. 연결을 해제할 데이터 스트림을 선택합니다. **데이터 스트림 별칭** 열에는 별칭이 포함되어야 합니다. **자산 이름** 및 **자산 속성 이름** 열에는 데이터 스트림이 연결된 자산 속성의 값이 포함되어야 합니다. 여러 데이터 스트림을 선택할 수 있습니다. 1. 오른쪽 상단에서 **데이터 스트림 관리를** 클릭합니다. 1. **데이터 스트림 연결 업데이트 섹션의** **측정 이름** 열에서 **X**를 클릭합니다. `submitted` 상태가 상태 **** 열에 나타나야 합니다. 1. **업데이트를** 선택하여 변경 사항을 커밋합니다. 이제 데이터 스트림이 자산 속성에서 연결 해제되고 별칭이 데이터 스트림을 식별하는 데 사용됩니다. ------ #### [ AWS CLI ] 자산 속성( `ID`및 별칭으로 식별됨)에서 데이터 스트림의 연결을 해제하려면 다음 명령을 실행합니다. ``` aws iotsitewise disassociate-time-series-from-asset-property \ --alias \ --assetId \ --propertyId ``` 이제 데이터 스트림이 자산 속성에서 연결 해제되고 별칭이 데이터 스트림을 식별하는 데 사용됩니다. 별칭은 이제 데이터 스트림과 연결되므로 자산 속성과 더 이상 연결되지 않습니다. ------ # 데이터 스트림 삭제 자산 모델에서 속성이 제거되면 자산 모델에서 관리하는 모든 자산에서 속성과 해당 데이터 스트림을 AWS IoT SiteWise 삭제합니다. 또한 자산이 삭제될 때 자산의 모든 속성과 해당 데이터 스트림을 삭제합니다. 데이터 스트림 데이터를 보존해야 하는 경우 삭제하기 전에 자산 속성과 연결을 해제해야 합니다. **주의** 자산에서 속성이 삭제되면 연결된 데이터 스트림도 삭제됩니다. 데이터 스트림을 보존하려면 먼저 자산 모델에서 속성을 삭제하거나 자산을 삭제하기 전에 자산 속성에서 연결을 해제합니다. ------ #### [ Console ] AWS IoT SiteWise 콘솔을 사용하여 자산 속성에서 데이터 스트림의 연결을 해제합니다. **데이터 스트림을 삭제하려면(콘솔)** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 패널에서 **데이터 스트림**을 선택합니다. 1. 데이터 스트림 별칭을 기준으로 필터링하여 데이터 스트림을 선택합니다. 1. 삭제할 데이터 스트림을 선택합니다. 여러 데이터 스트림을 선택할 수 있습니다. 1. **삭제** 버튼을 선택하여 데이터 스트림을 삭제합니다. ------ #### [ AWS CLI ] [ DeleteTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteTimeSeries.html) API를 사용하여 별칭으로 특정 데이터 스트림을 삭제합니다. ``` aws iotsitewise delete-time-series \ --alias ``` ------ # 자산 속성 별칭 업데이트 별칭은 AWS 리전 내에서 고유해야 합니다. 여기에는 자산 속성과 데이터 스트림의 별칭이 모두 포함됩니다. 다른 속성 또는 데이터 스트림이 해당 별칭을 사용하는 경우 자산 속성에 별칭을 할당하지 마십시오. ------ #### [ Console ] AWS IoT SiteWise 콘솔을 사용하여 자산 속성 별칭을 업데이트합니다. **자산 속성 별칭을 업데이트하려면(콘솔)** 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다. 1. 탐색 창에서 **자산**을 선택합니다. 1. 테이블에서 자산을 선택합니다. 1. **Edit** 버튼을 클릭합니다. 1. **속성 테이블에서 속성 유형을** 선택합니다. **** 1. 속성을 찾고 속성 별칭 텍스트 필드에 새 별칭을 입력합니다. 1. **저장** 버튼을 클릭하여 변경 사항을 저장합니다. ------ #### [ AWS CLI ] 자산 속성의 별칭을 업데이트하려면 다음 명령을 실행합니다. ``` aws iotsitewise update-asset-property \ --asset-id \ --property-id \ --property-alias \ --property-notification-state ``` **참고** 속성 알림이 현재 활성화된 경우 계속 활성화되도록 다시 제공해야 합니다. ------ # 일반적인 시나리오 ## 데이터 스트림 이동 데이터 스트림의 연결을 다른 자산 속성으로 변경하려면 먼저 데이터 스트림을 현재 자산 속성에서 연결 해제합니다. 자산 속성에서 데이터 스트림의 연결을 해제할 때는 해당 자산 속성에 할당된 별칭이 있어야 합니다. ``` aws iotsitewise disassociate-time-series-from-asset-property \ --alias \ --assetId \ --propertyId ``` 이제 데이터 스트림을 새 자산 속성에 다시 할당합니다. ``` aws iotsitewise associate-time-series-from-asset-property \ --alias \ --assetId \ --propertyId ``` ## 자산 속성에 별칭을 할당할 때 오류 발생 `UpdateAssetProperty` API를 사용하여 속성에 별칭을 할당할 때 다음과 같은 오류 메시지가 표시될 수 있습니다. ``` Given alias for property with ID already in use by another property or data stream ``` 이 오류 메시지는 별칭이 현재 다른 속성 또는 데이터 스트림에서 사용되므로 속성에 할당되지 않았음을 나타냅니다. 이는 데이터가 별칭 AWS IoT SiteWise 을 사용하여에 수집되는 경우에 발생합니다. 다른 데이터 스트림 또는 자산 속성에서 사용하지 않는 별칭으로 데이터가 전송되면 해당 별칭으로 새 데이터 스트림이 생성됩니다. 아래 두 가지 옵션으로 문제를 해결할 수 있습니다. + `AssociateTimeSeriesToAssetProperty` API를 사용하여 데이터 스트림을 별칭과 자산 속성에 연결합니다. + 데이터 수집을 일시적으로 중지하고 데이터 스트림을 삭제합니다. `UpdateAssetProperty` API를 사용하여 자산 속성에 별칭을 할당한 다음 데이터 수집을 다시 켭니다. ## 데이터 스트림을 자산 속성에 연결할 때 오류 발생 데이터 스트림을 자산 속성에 연결할 때 다음 오류 메시지가 표시됩니다. ``` assetProperty with assetId propertyId contains data ``` 이 오류 메시지는 자산 속성이 이미 데이터가 포함된 데이터 스트림과 연결되어 있음을 나타냅니다. 다른 데이터 스트림을 해당 자산 속성에 연결하기 전에 해당 데이터 스트림을 연결 해제하거나 삭제해야 합니다. **참고** 자산 속성에서 데이터 스트림의 연결을 해제하면 속성에 할당된 별칭이 데이터 스트림에 제공됩니다. 해당 별칭이 속성에 할당된 상태로 유지되도록 하려면 데이터 스트림의 연결을 해제하기 전에 해당 속성에 새 별칭을 할당합니다. 자산 속성에 저장된 데이터를 보존하려면 다음을 수행합니다. + 새 데이터 스트림이 생성되지 않도록 자산 속성에 데이터가 수집되지 않는지 확인합니다. + `UpdateAssetProperty` API를 사용하여 현재 할당된 데이터 스트림에 제공되는 새 별칭을 설정합니다. + `DisassociateTimeSeriesFromAssetProperty` API를 사용하여 자산 속성에서 현재 데이터 스트림의 연결을 해제합니다. + `AssociateTimeSeriesToAssetProperty` API를 사용하여 원하는 데이터 스트림을 자산 속성에 연결합니다. 자산 속성에 저장된 데이터를 삭제해야 하는 경우 다음을 수행합니다. + 새 데이터 스트림이 생성되지 않도록 자산 속성에 데이터가 수집되지 않는지 확인합니다. + `DeleteTimeSeries` API를 사용하여 현재 할당된 데이터 스트림을 삭제합니다. + `AssociateTimeSeriesToAssetProperty` API를 사용하여 원하는 데이터 스트림을 자산 속성에 연결합니다.