기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 에서 데이터 스토리지 관리 AWS IoT SiteWise
다음 스토리지 계층에 데이터를 저장 AWS IoT SiteWise 하도록를 구성할 수 있습니다.
**핫 티어**
핫 스토리지 계층은 AWS IoT SiteWise 관리형 시계열 스토리지입니다. 핫 티어는 쓰기 후 읽기 지연 시간이 낮고 자주 액세스하는 데이터에 가장 효과적입니다. 핫 티어에 저장된 데이터는 장비의 최신 측정값에 빠르게 액세스해야 하는 산업 애플리케이션에서 사용됩니다. 여기에는 대화형 대시보드를 사용하여 실시간 지표를 시각화하는 애플리케이션 또는 작업을 모니터링하고 성능 문제를 식별하기 위해 경보를 실행하는 애플리케이션이 포함됩니다.
기본적으로에 수집된 데이터는 핫 티어에 AWS IoT SiteWise 저장됩니다. 핫 티어의 보존 기간을 정의할 수 있습니다. 그 후는 구성에 따라 핫 티어의 데이터를 웜 또는 콜드 티어 스토리지로 AWS IoT SiteWise 이동합니다. 최상의 성능과 비용 효율성을 위해 핫 티어 보존 기간을 데이터를 자주 검색하는 데 걸리는 시간보다 길게 설정합니다. 이는 실시간 지표, 경보 및 모니터링 시나리오에 사용됩니다. 보존 기간이 설정되지 않은 경우 데이터는 핫 티어에 무기한 저장됩니다.
**웜 티어**
웜 스토리지 계층은 기록 데이터의 비용 효율적인 스토리지에 효과적인 AWS IoT SiteWise 관리형 계층입니다. 중간 정도의 쓰기 후 읽기 지연 시간으로 대용량 데이터를 검색하는 데 가장 적합합니다. 웜 티어를 사용하여 대규모 워크로드에 필요한 기록 데이터를 저장합니다. 예를 들어 분석, 비즈니스 인텔리전스 애플리케이션(BI), 보고 도구 및 기계 학습(ML) 모델의 훈련을 위한 데이터 검색에 사용됩니다. 콜드 스토리지 티어를 활성화하면 웜 티어 보존 기간을 정의할 수 있습니다. 보존 기간이 끝나면는 웜 티어에서 데이터를 AWS IoT SiteWise 삭제합니다.
**콜드 티어**
콜드 스토리지 티어는 Amazon S3 버킷을 사용하여 거의 사용되지 않는 데이터를 저장합니다. 콜드 티어가 활성화된 상태에서 AWS IoT SiteWise 는 측정값, 지표, 변환 및 집계, 자산 모델 정의를 포함하여 시계열을 6시간마다 복제합니다. 콜드 티어는 기록 보고서 및 백업에 대한 긴 읽기 지연 시간을 허용하는 데이터를 저장하는 데 사용됩니다.
**Topics**
+ [에서 스토리지 설정 구성 AWS IoT SiteWise](configure-storage.md)
+ [의 스토리지 설정 문제 해결 AWS IoT SiteWise](troubleshoot-storage-configuration.md)
+ [콜드 티어에 저장된 데이터의 파일 경로 및 스키마](file-path-and-schema.md)
# 에서 스토리지 설정 구성 AWS IoT SiteWise
서비스 관리형 웜 티어 스토리지에 옵트인하고 콜드 티어에 데이터를 복제하도록 스토리지 설정을 구성할 수 있습니다. 웜 티어와 핫 티어의 보존 기간에 대한 자세한 내용은 [데이터 보존 영향](#retention-period) 섹션을 참조하세요. 스토리지 설정을 구성하는 동안 다음을 수행합니다.
+ **핫 티어 보존** - 데이터가 삭제되기 전에 핫 티어에 저장되고 스토리지 설정에 따라 서비스 관리형 웜 티어 스토리지 또는 콜드 티어 스토리지로 이동하는 기간에 대한 보존 기간을 설정합니다. AWS IoT SiteWise 는 보존 기간이 끝나기 전에 핫 티어에 있던 모든 데이터를 삭제합니다. 보존 기간을 설정하지 않으면 데이터가 무기한 핫 티어에 저장됩니다.
+ **웜 티어 보존** - 스토리지에서 데이터를 삭제하고 고객 관리형 콜드 티어 AWS IoT SiteWise 스토리지로 이동하기 전에 웜 티어에 데이터가 저장되는 기간의 보존 기간을 설정합니다. 보존 기간이 끝나기 전에 존재했던 웜 티어의 모든 데이터를 AWS IoT SiteWise 삭제합니다. 보존 기간이 설정되지 않은 경우 데이터는 웜 티어에 무기한 저장됩니다.
**참고**
쿼리 성능을 개선하려면 웜 티어 스토리지에 핫 티어 보존 기간을 설정합니다.
## 핫 티어 스토리지와 웜 티어 스토리지의 데이터 보존 영향
+ 핫 티어 스토리지의 보존 기간을 줄이면 데이터가 핫 티어에서 웜 티어 또는 콜드 티어로 영구적으로 이동됩니다. 웜 티어의 보존 기간을 줄이면 데이터가 콜드 티어로 이동하고 웜 티어에서 영구적으로 삭제됩니다.
+ 핫 또는 웜 티어 스토리지의 보존 기간을 늘리면 변경 사항이 그때 AWS IoT SiteWise 부터 로 전송되는 데이터에 영향을 미칩니다.는 핫 티어를 채우기 위해 웜 또는 콜드 스토리지에서 데이터를 검색하지 AWS IoT SiteWise 않습니다. 예를 들어 핫 티어 스토리지의 보존 기간이 처음에 30일 동안 설정된 다음 60일로 증가하면 핫 티어 스토리지에 60일 분량의 데이터가 포함되려면 30일이 걸립니다.
**Topics**
+ [핫 티어 스토리지와 웜 티어 스토리지의 데이터 보존 영향](#retention-period)
+ [웜 티어에 대한 스토리지 설정 구성(콘솔)](#configure-storage-console-warm)
+ [웜 티어에 대한 스토리지 설정 구성(AWS CLI)](#configure-storage-cli-warm)
+ [콜드 티어에 대한 스토리지 설정 구성(콘솔)](#configure-storage-console)
+ [콜드 티어에 대한 스토리지 설정 구성(AWS CLI)](#configure-storage-cli)
## 웜 티어에 대한 스토리지 설정 구성(콘솔)
다음 절차에서는 AWS IoT SiteWise 콘솔의 웜 티어에 데이터를 복제하도록 스토리지 설정을 구성하는 방법을 보여줍니다.
**콘솔을 사용하여 저장 설정을 구성하는 방법**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.
1. 탐색 창의 **설정** 아래에서 **저장**을 선택합니다.
1. 오른쪽 상단 모서리에서 **편집**을 선택합니다.
1. **작업 편집** 페이지에서 다음을 수행합니다.
1. **핫 티어 설정**에서 다음을 수행합니다.
+ 데이터가 삭제되기 전에 핫 티어에 저장되고 서비스 관리형 웜 티어 스토리지로 이동되는 기간인 보존 기간을 설정하려면 **보존 기간 활성화**를 선택합니다.
+ 보존 기간을 구성하려면 정수를 입력하고 단위를 선택합니다. 보존 기간은 30일 이상이어야 합니다.
AWS IoT SiteWise 는 보존 기간보다 오래된 핫 티어의 모든 데이터를 삭제합니다. 보존 기간을 설정하지 않으면 데이터가 무기한 저장됩니다.
1. (권장) **웜 티어 설정**에서 다음을 수행합니다.
+ 웜 티어 스토리지에 옵트인하려면 **웜 티어 스토리지의 옵트인 확인**을 선택하고 웜 티어 스토리지에 옵트인합니다.
+ (선택 사항) 보존 기간을 구성하려면 정수를 입력하고 단위를 선택합니다. 보존 기간은 365일 이상이어야 합니다.
AWS IoT SiteWise 는 보존 기간 이전에 존재했던 웜 티어의 데이터를 삭제합니다. 보존 기간을 설정하지 않으면 데이터가 무기한 저장됩니다.
**참고**
웜 티어에 옵트인하면 구성이 한 번만 표시됩니다.
핫 티어 보존을 설정하려면 웜 티어 또는 콜드 티어 스토리지가 있어야 합니다. 비용 효율성 및 과거 데이터 검색을 위해는 웜 티어에 장기 데이터를 저장할 것을 AWS IoT SiteWise 권장합니다.
웜 티어 보존을 설정하려면 콜드 티어 스토리지가 있어야 합니다.
1. 설정을 저장하려면 **저장**을 선택합니다.
**AWS IoT SiteWise 스토리지** 섹션에서 **웜 티어 스토리지**는 다음 상태 중 하나에 있습니다.
+ **활성화됨** - 데이터가 핫 티어 보존 기간 이전에 존재한 경우 AWS IoT SiteWise 는 데이터를 웜 티어로 이동합니다.
+ **비활성화됨** - 웜 티어 스토리지가 비활성화되었습니다.
## 웜 티어에 대한 스토리지 설정 구성(AWS CLI)
AWS CLI 및 다음 명령을 사용하여 데이터를 웜 티어로 이동하도록 스토리지 설정을 구성할 수 있습니다.
기존 구성을 재정의하지 않으려면 다음 명령을 실행하여 현재 스토리지 구성 정보를 검색합니다.
```
aws iotsitewise describe-storage-configuration
```
**Example 기존 콜드 티어 구성이 없는 응답**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-10-14T15:53:35-07:00",
"warmTier": "DISABLED"
}
```
**Example 기존 콜드 티어 구성이 있는 응답**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": retention-in-days
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2023-10-25T15:59:46-07:00",
"warmTier": "DISABLED"
}
```
### 를 사용하여 웜 티어에 대한 스토리지 설정 구성 AWS CLI
스토리지 설정을 구성하려면 다음 명령을 실행합니다. 를 AWS IoT SiteWise 스토리지 구성이 포함된 파일의 이름으로 `file-name` 바꿉니다.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise 핫 티어와 웜 티어를 사용한 구성**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"warmTier": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
}
}
```
`hot-tier-retention-in-days`는 30일 이상의 정수여야 합니다.
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
콜드 티어 스토리지가 활성화되어 있는 경우 [AWS CLI 및 기존 콜드 티어를 사용하여 스토리지 설정 구성](#configure-storage-cli-existing-cold) 섹션을 참조하세요.
### AWS CLI 및 기존 콜드 티어를 사용하여 스토리지 설정 구성
**기존 콜드 티어 스토리지 AWS CLI 와 함께를 사용하여 스토리지 설정 구성**
+ 스토리지 설정을 구성하려면 다음 명령을 실행합니다. *file-name*을 AWS IoT SiteWise 스토리지 구성이 포함된 파일의 이름으로 바꿉니다.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise 스토리지 구성**
+ *amzn-s3-demo-bucket*을 Amazon S3 버킷 이름으로 바꿉니다.
+ *prefix*를 Amazon S3 접두사로 바꿉니다.
+ *aws-account-id*를 AWS 계정 ID로 바꿉니다.
+ *role-name*을가 Amazon S3로 데이터를 전송하도록 허용하는 Amazon S3 액세스 역할의 이름으로 바꿉 AWS IoT SiteWise 니다.
+ *hot-tier-retention-in-days*를 30일 이상의 정수로 바꿉니다.
+ *warm-tier-retention-in-days*를 365일 이상의 정수로 바꿉니다.
**참고**
AWS IoT SiteWise 는 콜드 티어의 보존 기간보다 오래된 웜 티어의 모든 데이터를 삭제합니다. 보존 기간을 설정하지 않으면 데이터가 무기한 저장됩니다.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
},
"warmTier": "ENABLED",
"warmTierRetentionPeriod": {
"numberOfDays": warm-tier-retention-in-days
}
}
```
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
## 콜드 티어에 대한 스토리지 설정 구성(콘솔)
다음 절차에서는 AWS IoT SiteWise 콘솔의 콜드 티어에 데이터를 복제하도록 스토리지 설정을 구성하는 방법을 보여줍니다.
**콘솔을 사용하여 저장 설정을 구성하는 방법**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.
1. 탐색 창의 **설정** 아래에서 **저장**을 선택합니다.
1. 오른쪽 상단 모서리에서 **편집**을 선택합니다.
1. **작업 편집** 페이지에서 다음을 수행합니다.
1. **스토리지 설정**에서 **콜드 티어 스토리지 활성화**를 선택합니다. 기본적으로 콜드 티어 스토리지는 비활성화되어 있습니다.
1. **S3 버킷 위치**의 경우 기존 Amazon S3 버킷의 이름과 접두사를 입력합니다.
**참고**
Amazon S3는 접두사를 Amazon S3 버킷의 폴더 이름으로 사용합니다. 접두사는 1\$1255자로 구성되어야 하며 슬래시(/)로 끝나야 합니다. AWS IoT SiteWise 데이터는 이 폴더에 저장됩니다.
Amazon S3 버킷이 없는 경우에는 **보기**를 선택한 후 Amazon S3 콘솔에서 새 버킷을 생성합니다. 자세한 내용은 *Amazon S3 사용 설명서*에서 [첫 S3 버킷 생성](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket)을 참조하세요.
1. **S3 액세스 역할**의 경우 다음 중 하나를 수행합니다.
+ ** AWS 관리형 템플릿에서 역할 생성을** 선택하면가 Amazon S3 AWS IoT SiteWise 로 데이터를 전송할 수 있는 IAM 역할이 AWS 자동으로 생성됩니다.
+ **기존 역할 사용**을 선택하고 목록에서 생성한 에 역할을 선택합니다.
**참고**
이전 단계 및 IAM 정책에서 사용한 것과 동일한 Amazon S3 버킷 이름을 **S3 버킷 위치**에 사용해야 합니다.
역할에 다음 예에 표시된 것과 같은 권한이 있는지 확인합니다.
**Example 권한 정책:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
amzn-s3-demo-bucket을 Amazon S3 버킷 이름으로 바꿉니다.
Amazon S3 버킷이 고객 관리형 KMS 키를 사용하여 암호화된 경우 KMS 키에는 `kms:Decrypt` 및 `kms:GenerateDataKey` 작업에 대한 IAM 역할이 있는 액세스 정책이 있어야 합니다.
1. 핫 티어를 설정하려면 [웜 티어에 대한 스토리지 설정 구성(콘솔)](#configure-storage-console-warm)의 5단계를 참조하세요.
1. (선택 사항) **AWS IoT 분석 통합**의 경우 다음을 수행합니다.
**참고**
지원 종료 공지: 2025년 12월 15 AWS 일에는에 대한 지원을 종료합니다 AWS IoT Analytics. 2025년 12월 15일 이후에는 AWS IoT 분석 콘솔 또는 AWS IoT 분석 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은 [AWS IoT 분석 지원 종료를 참조하세요](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
1. 를 AWS IoT 분석 사용하여 데이터를 쿼리하려면 **활성화된 AWS IoT 분석 데이터 스토어를** 선택합니다.
1. AWS IoT SiteWise 는 데이터 스토어의 이름을 생성하거나 다른 이름을 입력할 수 있습니다.
AWS IoT SiteWise 는에 데이터 스토어를 자동으로 생성 AWS IoT 분석 하여 데이터를 저장합니다. 데이터를 쿼리하려면를 사용하여 데이터 세트를 AWS IoT 분석 생성할 수 있습니다. 자세한 내용은 *AWS IoT Analytics 사용 설명서*의 [AWS IoT SiteWise 데이터 작업을](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) 참조하세요.
1. **저장**을 선택합니다.
**AWS IoT SiteWise 스토리지** 섹션에서 **콜드 티어 스토리지**는 다음 값 중 하나일 수 있습니다.
+ **활성화됨** - 지정된 Amazon S3 버킷에 데이터를 AWS IoT SiteWise 복제합니다.
+ **활성화** - AWS IoT SiteWise 가 콜드 티어 스토리지 활성화 요청을 처리하고 있습니다. 이 프로세스는 완료하는 데 몇 분 정도 걸립니다.
+ **Enable\$1Failed** - 콜드 티어 스토리지 활성화 요청을 처리할 수 AWS IoT SiteWise 없습니다. Amazon CloudWatch Logs AWS IoT SiteWise 로 로그를 전송하도록를 활성화한 경우 이러한 로그를 사용하여 문제를 해결할 수 있습니다. 자세한 내용은 [Amazon CloudWatch Logs를 사용하여 모니터링](monitor-cloudwatch-logs.md) 단원을 참조하십시오.
+ **Disabled** - 콜드 티어 스토리지가 비활성화되었습니다.
## 콜드 티어에 대한 스토리지 설정 구성(AWS CLI)
다음 절차에서는 AWS CLI를 사용하여 콜드 티어에 데이터를 복제하도록 스토리지 설정을 구성하는 방법을 보여줍니다.
**를 사용하여 스토리지 설정을 구성하려면 AWS CLI**
1. 계정의 Amazon S3 버킷으로 데이터를 내보내려면 다음 명령을 실행하여 스토리지 설정을 구성합니다. *file-name*을 AWS IoT SiteWise 스토리지 구성이 포함된 파일의 이름으로 바꿉니다.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise 스토리지 구성**
+ *amzn-s3-demo-bucket*을 Amazon S3 버킷 이름으로 바꿉니다.
+ *prefix*를 Amazon S3 접두사로 바꿉니다.
+ *aws-account-id*를 AWS 계정 ID로 바꿉니다.
+ *role-name*을가 Amazon S3로 데이터를 전송하도록 허용하는 Amazon S3 액세스 역할의 이름으로 바꿉 AWS IoT SiteWise 니다.
+ *retention-in-days*를 30일 이상의 정수로 바꿉니다.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"retentionPeriod": {
"numberOfDays": retention-in-days,
"unlimited": false
}
}
```
**참고**
AWS IoT SiteWise 스토리지 구성 및 IAM 정책에 동일한 Amazon S3 버킷 이름을 사용해야 합니다.
역할에 다음 예에 표시된 것과 같은 권한이 있는지 확인합니다.
**Example 권한 정책:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
amzn-s3-demo-bucket을 Amazon S3 버킷 이름으로 바꿉니다.
Amazon S3 버킷이 고객 관리형 KMS 키를 사용하여 암호화된 경우 KMS 키에는 `kms:Decrypt` 및 `kms:GenerateDataKey` 작업에 대한 IAM 역할이 있는 액세스 정책이 있어야 합니다.
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
**참고**
에서 스토리지 구성을 업데이트 AWS IoT SiteWise 하는 데 몇 분 정도 걸릴 수 있습니다.
1. 스토리지 구성 정보를 검색하려면 다음 명령을 실행합니다.
```
aws iotsitewise describe-storage-configuration
```
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/torque/",
"roleArn": "arn:aws:iam::123456789012:role/SWAccessS3Role"
}
},
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:54:14-07:00"
}
```
1. Amazon S3 버킷으로 데이터 내보내기를 중지하려면 다음 명령을 실행하여 스토리지 설정을 구성합니다.
```
aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
```
**참고**
기본적으로 데이터는의 핫 티어에만 저장됩니다 AWS IoT SiteWise.
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
1. 스토리지 구성 정보를 검색하려면 다음 명령을 실행합니다.
```
aws iotsitewise describe-storage-configuration
```
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:57:14-07:00"
}
```
### (선택 사항) AWS IoT 분석 데이터 스토어 생성(AWS CLI)
**참고**
지원 종료 공지: 2025년 12월 15 AWS 일에는에 대한 지원을 종료합니다 AWS IoT Analytics. 2025년 12월 15일 이후에는 AWS IoT 분석 콘솔 또는 AWS IoT 분석 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은 [AWS IoT 분석 지원 종료를 참조하세요](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
AWS IoT 분석 데이터 스토어는 데이터를 수신하고 저장하는 확장 가능하고 쿼리 가능한 리포지토리입니다. AWS IoT SiteWise 콘솔 또는 AWS IoT 분석 APIs를 사용하여 AWS IoT 분석 데이터 스토어를 생성하여 AWS IoT SiteWise 데이터를 저장할 수 있습니다. 데이터를 쿼리하려면를 사용하여 데이터 세트를 생성합니다 AWS IoT 분석. 자세한 내용을 알아보려면 *AWS IoT Analytics 사용 설명서*의 [AWS IoT SiteWise 데이터를 사용하여 작업하기](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html)를 참조하세요.
다음 단계에서는 AWS CLI 를 사용하여에서 데이터 스토어를 생성합니다 AWS IoT 분석.
다음 명령을 실행하여 데이터 스토어를 생성합니다. *file-name*을 데이터 스토어 구성이 포함된 파일의 이름으로 바꿉니다.
```
aws iotanalytics create-datastore --cli-input-json file://file-name.json
```
**참고**
기존 Amazon S3 버킷의 이름을 지정해야 합니다. Amazon S3 버킷이 없는 경우에는 먼저 하나를 만들 수 있습니다. 자세한 내용은 *Amazon S3 사용 설명서*에서 [첫 S3 버킷 생성](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket)을 참조하세요.
AWS IoT SiteWise 스토리지 구성, IAM 정책 및 AWS IoT 분석 데이터 스토어 구성에 동일한 Amazon S3 버킷 이름을 사용해야 합니다.
**Example AWS IoT 분석 데이터 스토어 구성**
*data-store-name* 및 *amzn-s3-demo-bucket*을 AWS IoT 분석 데이터 스토어 이름 및 Amazon S3 버킷 이름으로 바꿉니다.
```
{
"datastoreName": "data-store-name",
"datastoreStorage": {
"iotSiteWiseMultiLayerStorage": {
"customerManagedS3Storage": {
"bucket": "amzn-s3-demo-bucket"
}
}
},
"retentionPeriod": {
"numberOfDays": 90
}
}
```
**Example response**
```
{
"datastoreName": "datastore_IoTSiteWise_demo",
"datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
"retentionPeriod": {
"numberOfDays": 90,
"unlimited": false
}
}
```
# 의 스토리지 설정 문제 해결 AWS IoT SiteWise
다음 정보를 사용하여 스토리지 구성 관련 문제를 해결하세요.
**Topics**
+ [오류: 버킷이 존재하지 않습니다](#no-s3-bucket)
+ [오류: Amazon S3 경로에 대한 액세스 거부됨](#iam-permissions)
+ [오류: 역할 ARN을 맡을 수 없습니다](#iam-trust-relationship)
+ [오류: 리전 간 S3 버킷에 액세스하지 못함](#cross-region-s3-bucket)
## 오류: 버킷이 존재하지 않습니다
**솔루션:** AWS IoT SiteWise Amazon S3 버킷을 찾을 수 없습니다. 현재 리전의 기존 Amazon S3 버킷의 이름을 입력해야 합니다.
## 오류: Amazon S3 경로에 대한 액세스 거부됨
**솔루션:** AWS IoT SiteWise Amazon S3 버킷에 액세스할 수 없습니다. 해결 방법:
+ IAM 정책에서 지정한 것과 동일한 Amazon S3 버킷을 사용해야 합니다.
+ 역할에 다음 예에 표시된 것과 같은 권한이 있는지 확인합니다.
**Example 권한 정책**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
------
amzn-s3-demo-bucket을 Amazon S3 버킷 이름으로 바꿉니다.
## 오류: 역할 ARN을 맡을 수 없습니다
**Solution:** AWS IoT SiteWise couldn은 사용자를 대신하여 IAM 역할을 수임하지 않습니다. 역할이 다음 서비스를 신뢰하는지 확인합니다. `iotsitewise.amazonaws.com` 자세한 내용은 *IAM 사용자 가이드*의 [역할을 가정할 수 없습니다](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_cant-assume-role)를 참조하세요.
## 오류: 리전 간 S3 버킷에 액세스하지 못함
**솔루션:** 지정한 Amazon S3 버킷이 다른 AWS 리전에 있습니다. Amazon S3 버킷과 AWS IoT SiteWise 자산이 동일한 리전에 있는지 확인합니다.
# 콜드 티어에 저장된 데이터의 파일 경로 및 스키마
AWS IoT SiteWise 는 측정값, 지표, 변환 및 집계, 자산 및 자산 모델 정의를 포함하여 시계열을 복제하여 콜드 티어에 데이터를 저장합니다. 다음은 콜드 티어로 전송되는 데이터의 파일 경로와 스키마를 설명합니다.
**Topics**
+ [장비 데이터(측정값)](#measurements-file-path-and-schema)
+ [지표, 변환, 집계](#metrics-file-path-and-schema)
+ [자산 메타데이터](#asset-metadata)
+ [자산 계층 구조 메타데이터](#asset-hierarchy-metadata)
+ [스토리지 데이터 인덱스 파일](#storage-data-index)
## 장비 데이터(측정값)
AWS IoT SiteWise 는 6시간마다 한 번씩 장비 데이터(측정값)를 콜드 티어로 내보냅니다. 원시 데이터는 [Apache AVRO](https://avro.apache.org)(`.avro`) 형식으로 콜드 티어에 저장됩니다.
### 파일 경로
AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 장비 데이터(측정값)를 저장합니다.
```
{keyPrefix}/raw/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/raw_{timeseriesId}_{startTimestamp}_{quality}.avro
```
Amazon S3의 원시 데이터에 대한 모든 파일 경로에는 다음과 같은 구성 요소가 포함되어 있습니다.
#### 파일 경로
| 경로 구성 요소 | 설명 |
| --- | --- |
| `keyPrefix` | AWS IoT SiteWise 스토리지 구성에서 지정한 Amazon S3 접두사입니다. Amazon S3 에서는 접두사를 버킷의 폴더 이름으로 사용합니다. |
| `raw` | 장비의 시계열 데이터(측정값)를 저장하는 폴더. `raw` 폴더는 접두사 폴더에 저장됩니다. |
| `seriesBucket` | 00\$1ff 사이의 16진수입니다. 이 숫자는 `timeSeriesId`에서 파생되었습니다. 이 파티션은가 콜드 티어에 AWS IoT SiteWise 쓸 때 처리량을 높이는 데 사용됩니다. Amazon Athena를 사용하여 쿼리를 실행하면 세분화된 분할에 파티션을 사용하여 쿼리 성능을 개선할 수 있습니다. 자산 메타데이터의 `seriesBucket`과 `timeSeriesBucket`은 같은 숫자입니다. |
| `startYear` | 시계열 데이터와 연결된 배타적 시작 시간의 연도. |
| `startMonth` | 시계열 데이터와 연결된 배타적 시작 시간의 달. |
| `startDay` | 시계열 데이터와 연결된 배타적 시작 시간의 달의 날짜. |
| `fileName` | 파일 이름은 밑줄 (\$1)문자를 구분 기호로 사용하여 다음을 구분합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/file-path-and-schema.html) 파일은 [Snappy](https://github.com/google/snappy) 압축을 사용하여 `.avro` 형식으로 저장됩니다. |
**Example 콜드 티어의 원시 데이터 파일 경로**
`keyPrefix/raw/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/raw_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`
### 필드
콜드 티어로 내보내는 원시 데이터의 스키마에는 다음 필드가 포함됩니다.
AWS IoT SiteWise 는 향후 추가 필드가 도입될 수 있으므로 콜드 티어에서 원시 데이터를 읽는 시스템에서 스키마 진화 지원을 구현하도록 고객에게 조언합니다.
Null 데이터는 null인 모든 값 필드로 표시됩니다. 그러나 AWS IoT SiteWise APIs.
#### 필드
| 필드 이름 | 지원되는 유형 | 기본 형식 | 설명 |
| --- | --- | --- | --- |
| `seriesId` | `string` | 해당 사항 없음 | 장비의 시계열 데이터(측정값)를 식별하는 ID. 이 필드를 사용하여 쿼리에서 원시 데이터와 자산 메타데이터를 결합할 수 있습니다. |
| `timeInSeconds` | `long` | 해당 사항 없음 | Unix epoch 형식의 타임스탬프 날짜(초)입니다. `offsetInNanos`에서 나노초 단위의 데이터를 제공합니다. |
| `offsetInNanos` | `long` | 해당 사항 없음 | `timeInSeconds`의 나노초 오프셋. |
| `quality` | `string` | 해당 사항 없음 | 시계열 값의 품질. |
| `doubleValue` | `double` 또는 `null` | `null` | 더블 유형의 시계열 데이터(이동 소숫점 수). |
| `stringValue` | `string` 또는 `null` | `null` | 문자열 유형의 시계열 데이터(문자 시퀀스). |
| `integerValue` | `int` 또는 `null` | `null` | 정수 유형의 시계열 데이터(정수). |
| `booleanValue` | `boolean` 또는 `null` | `null` | 부울 유형의 시계열 데이터(true 또는 false). |
| `jsonValue` | `string` 또는 `null` | `null` | JSON 유형의 시계열 데이터(문자열로 저장된 복잡한 데이터 유형). |
| `recordVersion` | `long` 또는 `null` | `null` | 기록을 위한 버전 번호. 버전 번호를 사용하여 최신 레코드를 선택할 수 있습니다. 최신 레코드는 버전 번호가 더 큽니다. |
**Example 콜드 티어의 원시 데이터**
```
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675887,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.75},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675889,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.69},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675890,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.66},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675891,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.92},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675892,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.73},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
```
## 지표, 변환, 집계
AWS IoT SiteWise 는 6시간마다 한 번씩 지표, 변환 및 집계를 콜드 티어로 내보냅니다. 지표, 변환 및 집계는 [Apache AVRO](https://avro.apache.org)(`.avro`) 형식으로 콜드 티어에 저장됩니다.
### 파일 경로
AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 지표, 변환 및 집계를 저장합니다.
```
{keyPrefix}/agg/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/agg_{timeseriesId}_{startTimestamp}_{quality}.avro
```
Amazon S3의 지표, 변환 및 집계에 대한 모든 파일 경로에는 다음 구성 요소가 포함되어 있습니다.
#### 파일 경로
| 경로 구성 요소 | 설명 |
| --- | --- |
| `keyPrefix` | AWS IoT SiteWise 스토리지 구성에서 지정한 Amazon S3 접두사입니다. Amazon S3 에서는 접두사를 버킷의 폴더 이름으로 사용합니다. |
| `agg` | 지표의 시계열 데이터를 저장하는 폴더. `agg` 폴더는 접두사 폴더에 저장됩니다. |
| `seriesBucket` | 00\$1ff 사이의 16진수입니다. 이 숫자는 `timeSeriesId`에서 파생되었습니다. 이 파티션은가 콜드 티어에 AWS IoT SiteWise 쓸 때 처리량을 높이는 데 사용됩니다. Amazon Athena를 사용하여 쿼리를 실행하면 세분화된 분할에 파티션을 사용하여 쿼리 성능을 개선할 수 있습니다. 자산 메타데이터의 `seriesBucket`과 `timeSeriesBucket`은 같은 숫자입니다. |
| `startYear` | 시계열 데이터와 연결된 배타적 시작 시간의 연도. |
| `startMonth` | 시계열 데이터와 연결된 배타적 시작 시간의 달. |
| `startDay` | 시계열 데이터와 연결된 배타적 시작 시간의 달의 날짜. |
| `fileName` | 파일 이름은 밑줄 (\$1)문자를 구분 기호로 사용하여 다음을 구분합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/file-path-and-schema.html) 파일은 [Snappy](https://github.com/google/snappy) 압축을 사용하여 `.avro` 형식으로 저장됩니다. |
**Example 콜드 티어의 지표에 대한 파일 경로**
`keyPrefix/agg/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/agg_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`
### 필드
콜드 티어로 내보내는 지표, 변환 및 집계의 스키마에는 다음 필드가 포함됩니다.
#### 필드
| 필드 이름 | 지원되는 유형 | 기본 형식 | 설명 |
| --- | --- | --- | --- |
| `seriesId` | `string` | 해당 사항 없음 | 장비, 지표 또는 변환의 시계열 데이터를 식별하는 ID. 이 필드를 사용하여 쿼리에서 원시 데이터와 자산 메타데이터를 결합할 수 있습니다. |
| `timeInSeconds` | `long` | 해당 사항 없음 | Unix epoch 형식의 타임스탬프 날짜(초)입니다. `offsetInNanos`에서 나노초 단위의 데이터를 제공합니다. |
| `offsetInNanos` | `long` | 해당 사항 없음 | `timeInSeconds`의 나노초 오프셋. |
| `quality` | `string` | 해당 사항 없음 | 자산 데이터를 필터링하는 데 사용되는 품질. |
| `resolution` | `string` | 해당 사항 없음 | 데이터를 집계하는 데 걸리는 시간 간격. |
| `count` | `double` 또는 `null` | `null` | 현재 시간 간격 동안 해당 변수에 대한 총 데이터 포인트 수. |
| `average` | `double` 또는 `null` | `null` | 현재 시간 간격 동안 해당 변수 값의 평균. |
| `min` | `double` 또는 `null` | `null` | 현재 시간 간격 동안 해당 변수 값의 최소값. |
| `max` | `boolean` 또는 `null` | `null` | 현재 시간 간격 동안 해당 변수 값의 최대값. |
| `sum` | `string` 또는 `null` | `null` | 현재 시간 간격 동안 해당 변수 값의 합계. |
| `recordVersion` | `long` 또는 `null` | `null` | 기록을 위한 버전 번호. 버전 번호를 사용하여 최신 레코드를 선택할 수 있습니다. 최신 레코드는 버전 번호가 더 큽니다. |
**Example 콜드 티어의 지표 데이터**
```
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334060,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334120,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":29.0,"average":{"double":46.0},"min":{"double":32.0},"max":{"double":60.0},"sum":{"double":1334.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334540,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334600,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":29.0,"average":{"double":46.0},"min":{"double":32.0},"max":{"double":60.0},"sum":{"double":1334.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637335020,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
```
## 자산 메타데이터
AWS IoT SiteWise 가 처음으로 콜드 티어로 데이터를 내보내도록 활성화하면 자산 메타데이터가 콜드 티어로 내보내집니다. 초기 구성 후는 자산 모델 정의 또는 자산 정의를 변경할 때만 자산 메타데이터를 계층으로 내 AWS IoT SiteWise 보냅니다. 자산 메타데이터는 콜드 티어에 새 줄 구분 JSON(`.ndjson`) 형식으로 저장됩니다.
### 파일 경로
AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 자산 메타데이터를 저장합니다.
```
{keyPrefix}/asset_metadata/asset_{assetId}.ndjson
```
콜드 티어의 자산 메타데이터에 대한 모든 파일 경로에는 다음 구성 요소가 포함됩니다.
#### 파일 경로
| 경로 구성 요소 | 설명 |
| --- | --- |
| `keyPrefix` | 스토리지 구성에서 지정한 Amazon S3 접두사 AWS IoT SiteWise입니다. Amazon S3 에서는 접두사를 버킷의 폴더 이름으로 사용합니다. |
| `asset_metadata` | 자산 메타데이터를 저장하는 폴더. `asset_metadata` 폴더는 접두사 폴더에 저장됩니다. |
| `fileName` | 파일 이름은 밑줄 (\$1)문자를 구분 기호로 사용하여 다음을 구분합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/file-path-and-schema.html) 파일은 `.ndjson` 형식으로 저장됩니다. |
**Example 더 콜드 티어의 자산 메타데이터에 대한 파일 경로**
`keyPrefix/asset_metadata/asset_35901915-d476-4dca-8637-d9ed4df939ed.ndjson`
### 필드
콜드 티어로 내보내는 자산 메타데이터의 스키마에는 다음 필드가 포함됩니다.
#### 필드
| 필드 이름 | 설명 |
| --- | --- |
| `assetId` | 자산의 ID입니다. |
| `assetName` | 자산 이름. |
| `assetExternalId` | 자산의 외부 ID입니다. |
| `assetModelId` | 자산을 생성할 때 사용된 자산 모델의 ID입니다. |
| `assetModelName` | 자산 모델의 이름입니다. |
| `assetModelExternalId` | 자산의 외부 ID입니다. |
| `assetPropertyId` | 자산 속성의 ID입니다. |
| `assetPropertyName` | 자산 특성의 이름입니다. |
| `assetPropertyExternalId` | 자산 속성의 ID입니다. |
| `assetPropertyDataType` | 자산 속성의 데이터 유형입니다. |
| `assetPropertyUnit` | 자산 속성의 단위(예: `Newtons` 및 `RPM`). |
| `assetPropertyAlias` | OPC UA 서버 데이터 스트림 경로(예: `/company/windfarm/3/turbine/7/temperature`)와 같이 자산 속성을 식별하는 별칭입니다. |
| `timeSeriesId` | 장비, 지표 또는 변환의 시계열 데이터를 식별하는 ID. 이 필드를 사용하여 쿼리에서 원시 데이터와 자산 메타데이터를 결합할 수 있습니다. |
| `timeSeriesBucket` | 00\$1ff 사이의 16진수입니다. 이 숫자는 `timeSeriesId`에서 파생되었습니다. 이 파티션은가 콜드 티어에 AWS IoT SiteWise 쓸 때 처리량을 높이는 데 사용됩니다. Amazon Athena를 사용하여 쿼리를 실행하면 세분화된 분할에 파티션을 사용하여 쿼리 성능을 개선할 수 있습니다. 원시 데이터에 대한 파일 경로의 `timeSeriesBucket`와 `seriesBucket`는 같은 숫자입니다. |
| `assetCompositeModelId` | 복합 모델의 ID입니다. |
| `assetCompositeModelExternalId` | 복합 모델의 외부 ID입니다. |
| `assetCompositeModelDescription` | 복합 모델에 대한 설명입니다. |
| `assetCompositeModelName` | 복합 모델의 이름입니다. |
| `assetCompositeModelType` | 복합 모델의 유형입니다. 경보 복합 모델의 경우 이 유형은 `AWS/ALARM`입니다. |
| `assetCreationDate` | UNIX epoch 시간 형식으로 표시된 자산이 생성된 날짜. |
| `assetLastUpdateDate` | Unix Epoch 시간으로 표시된 자산이 마지막으로 업데이트된 날짜. |
| `assetStatusErrorCode` | 오류 코드입니다. |
| `assetStatusErrorMessage` | 오류 메시지입니다. |
| `assetStatusState` | 자산의 현재 상태입니다. |
**Example 콜드 티어의 자산 메타데이터**
```
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"95e63da7-d34e-43e1-bc6f-1b490154b07a","assetPropertyExternalId":null,"assetPropertyName":"Temperature","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"Celsius","assetPropertyAlias":"USA/Washington/Seattle/WT2/temp","timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeSeriesBucket":"f6","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"c706d54d-4c11-42dc-9a01-63662fc697b4","assetPropertyExternalId":null,"assetPropertyName":"Pressure","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"KiloPascal","assetPropertyAlias":"USA/Washington/Seattle/WT2/pressure","timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_c706d54d-4c11-42dc-9a01-63662fc697b4","timeSeriesBucket":"1e","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"8cf1162f-dead-4fbe-b468-c8e24cde9f50","assetPropertyExternalId":null,"assetPropertyName":"Max Temperature","assetPropertyDataType":"DOUBLE","assetPropertyUnit":null,"assetPropertyAlias":null,"timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_8cf1162f-dead-4fbe-b468-c8e24cde9f50","timeSeriesBucket":"d7","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"3a5f2a22-3b37-4332-9c1c-404ea1d73fab","assetExternalId":null,"assetName":"BatchAssetDouble1","assetModelId":"814bdfd8-24db-4a33-8d9b-ebc75e75e827","assetModelExternalId":null,"assetModelName":"FlashTestAssetModelDouble","assetPropertyId":"6b7e1532-175b-4c02-b410-ab401a9176ed","assetPropertyExternalId":null,"assetPropertyName":"measurementProperty","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"u","assetPropertyAlias":null,"timeSeriesId":"ab19f4fa-7e7b-4247-ae89-ff316f5ff8aa","timeSeriesBucket":"af","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1646960106,"assetLastUpdateDate":1646960106,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
```
## 자산 계층 구조 메타데이터
AWS IoT SiteWise 가 처음으로 콜드 티어에 데이터를 저장하도록 활성화하면 자산 계층 메타데이터가 콜드 티어로 내보내집니다. 초기 구성 후는 자산 모델 또는 자산 정의를 변경할 때만 자산 계층 구조 메타데이터를 콜드 티어로 내 AWS IoT SiteWise 보냅니다. 자산 계층 구조 메타데이터는 콜드 티어에 새 줄 구분 JSON(`.ndjson`) 형식으로 저장됩니다.
계층 구조, 대상 자산 또는 소스 자산의 외부 식별자는 [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) API를 직접적으로 호출하여 검색됩니다.
### 파일 경로
AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 자산 계층 구조 메타데이터를 저장합니다.
```
{keyPrefix}/asset_hierarchy_metadata/{parentAssetId}_{hierarchyId}.ndjson
```
콜드 티어의 자산 계층 구조 메타데이터에 대한 모든 파일 경로에는 다음 구성 요소가 포함됩니다.
#### 파일 경로
| 경로 구성 요소 | 설명 |
| --- | --- |
| `keyPrefix` | AWS IoT SiteWise 스토리지 구성에서 지정한 Amazon S3 접두사입니다. Amazon S3 에서는 접두사를 버킷의 폴더 이름으로 사용합니다. |
| `asset_hierarchy_metadata` | 자산 계층 구조 메타데이터를 저장하는 폴더. `asset_hierarchy_metadata` 폴더는 접두사 폴더에 저장됩니다. |
| `fileName` | 파일 이름은 밑줄 (\$1)문자를 구분 기호로 사용하여 다음을 구분합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/file-path-and-schema.html) 파일은 `.ndjson` 형식으로 저장됩니다. |
**Example 콜드 티어의 자산 계층 구조 메타데이터에 대한 파일 경로**
`keyPrefix/asset_hierarchy_metadata/35901915-d476-4dca-8637-d9ed4df939ed_c5b3ced8-589a-48c7-9998-cdccfc9747a0.ndjson`
### 필드
콜드 티어로 내보내는 자산 계층 구조 메타데이터의 스키마에는 다음 필드가 포함됩니다.
#### 필드
| 필드 이름 | 설명 |
| --- | --- |
| `sourceAssetId` | 이 자산 관계에 있는 소스 자산의 ID. |
| `targetAssetId` | 이 자산 관계에 있는 대상 자산의 ID. |
| `hierarchyId` | 해당 계층 구조의 ID. |
| `associationType` | 이 자산 관계의 연결 유형. 값은 `CHILD`여야 합니다. 대상 자산은 소스 자산의 하위 자산입니다. |
**Example 콜드 티어의 자산 계층 구조 메타데이터**
```
{"sourceAssetId":"80388e72-2284-44fb-9c89-bfbaf0dfedd2","targetAssetId":"2b866c25-0c74-4750-bdf5-b73683c8a2a2","hierarchyId":"bbed9f59-0412-4585-a61d-6044db526aee","associationType":"CHILD"}
{"sourceAssetId":"80388e72-2284-44fb-9c89-bfbaf0dfedd2","targetAssetId":"6b51246e-984d-460d-bc0b-470ea47d1e31","hierarchyId":"bbed9f59-0412-4585-a61d-6044db526aee","associationType":"CHILD"}
```
**콘솔 티어에서 데이터를 보려면**
1. [Amazon S3 콘솔](https://console.aws.amazon.com/s3/)로 이동합니다.
1. 탐색 패널에서, **버킷**을 선택하고 Amazon S3 버킷을 선택합니다.
1. 원시 데이터, 자산 메타데이터 또는 자산 계층 구조 메타데이터가 포함된 폴더로 이동합니다.
1. 파일을 선택한 다음 **작업**에서 **다운로드**를 선택합니다.
## 스토리지 데이터 인덱스 파일
AWS IoT SiteWise 는 이러한 파일을 사용하여 데이터 쿼리 성능을 최적화합니다. Amazon S3 버킷에 표시되지만 사용할 필요는 없습니다.
### 파일 경로
AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 데이터 인덱스 파일을 저장합니다.
```
keyPrefix/index/series=timeseriesId/startYear=startYear/startMonth=startMonth/startDay=startDay/index_timeseriesId_startTimestamp_quality
```
**Example 데이터 스토리지 인덱스 파일의 파일 경로**
`keyPrefix/index/series=7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a/startYear=2022/startMonth=02/startDay=03/index_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1643846400_GOOD`