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

# 콜드 티어에 저장된 데이터의 파일 경로 및 스키마
<a name="file-path-and-schema"></a>

AWS IoT SiteWise 는 측정값, 지표, 변환 및 집계, 자산 및 자산 모델 정의를 포함하여 시계열을 복제하여 콜드 티어에 데이터를 저장합니다. 다음은 콜드 티어로 전송되는 데이터의 파일 경로와 스키마를 설명합니다.

**Topics**
+ [장비 데이터(측정값)](#measurements-file-path-and-schema)
+ [지표, 변환, 집계](#metrics-file-path-and-schema)
+ [자산 메타데이터](#asset-metadata)
+ [자산 계층 구조 메타데이터](#asset-hierarchy-metadata)
+ [스토리지 데이터 인덱스 파일](#storage-data-index)

## 장비 데이터(측정값)
<a name="measurements-file-path-and-schema"></a>

AWS IoT SiteWise 는 6시간마다 한 번씩 장비 데이터(측정값)를 콜드 티어로 내보냅니다. 원시 데이터는 [Apache AVRO](https://avro.apache.org)(`.avro`) 형식으로 콜드 티어에 저장됩니다.

### 파일 경로
<a name="measurements-file-path"></a>

AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 장비 데이터(측정값)를 저장합니다.

```
{keyPrefix}/raw/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/raw_{timeseriesId}_{startTimestamp}_{quality}.avro
```

Amazon S3의 원시 데이터에 대한 모든 파일 경로에는 다음과 같은 구성 요소가 포함되어 있습니다.

#### 파일 경로
<a name="storage-paths-schemas-file-path"></a>


| 경로 구성 요소 | 설명 | 
| --- | --- | 
|  `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`

### 필드
<a name="measurements-fields"></a>

콜드 티어로 내보내는 원시 데이터의 스키마에는 다음 필드가 포함됩니다.

 AWS IoT SiteWise 는 향후 추가 필드가 도입될 수 있으므로 콜드 티어에서 원시 데이터를 읽는 시스템에서 스키마 진화 지원을 구현하도록 고객에게 조언합니다.

 Null 데이터는 null인 모든 값 필드로 표시됩니다. 그러나 AWS IoT SiteWise APIs.

#### 필드
<a name="measurements-fields-subsection"></a>


| 필드 이름 | 지원되는 유형 | 기본 형식 | 설명 | 
| --- | --- | --- | --- | 
|  `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}
```

## 지표, 변환, 집계
<a name="metrics-file-path-and-schema"></a>

AWS IoT SiteWise 는 6시간마다 한 번씩 지표, 변환 및 집계를 콜드 티어로 내보냅니다. 지표, 변환 및 집계는 [Apache AVRO](https://avro.apache.org)(`.avro`) 형식으로 콜드 티어에 저장됩니다.

### 파일 경로
<a name="metrics-file-path"></a>

AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 지표, 변환 및 집계를 저장합니다.

```
{keyPrefix}/agg/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/agg_{timeseriesId}_{startTimestamp}_{quality}.avro
```

Amazon S3의 지표, 변환 및 집계에 대한 모든 파일 경로에는 다음 구성 요소가 포함되어 있습니다.

#### 파일 경로
<a name="metrics-file-path-subsection"></a>


| 경로 구성 요소 | 설명 | 
| --- | --- | 
|  `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`

### 필드
<a name="metrics-fields"></a>

콜드 티어로 내보내는 지표, 변환 및 집계의 스키마에는 다음 필드가 포함됩니다.

#### 필드
<a name="metrics-fields-subsection"></a>


| 필드 이름 | 지원되는 유형 | 기본 형식 | 설명 | 
| --- | --- | --- | --- | 
|  `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}
```

## 자산 메타데이터
<a name="asset-metadata"></a>

 AWS IoT SiteWise 가 처음으로 콜드 티어로 데이터를 내보내도록 활성화하면 자산 메타데이터가 콜드 티어로 내보내집니다. 초기 구성 후는 자산 모델 정의 또는 자산 정의를 변경할 때만 자산 메타데이터를 계층으로 내 AWS IoT SiteWise 보냅니다. 자산 메타데이터는 콜드 티어에 새 줄 구분 JSON(`.ndjson`) 형식으로 저장됩니다.

### 파일 경로
<a name="asset-metadata-file-path"></a>

AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 자산 메타데이터를 저장합니다.

```
{keyPrefix}/asset_metadata/asset_{assetId}.ndjson
```

콜드 티어의 자산 메타데이터에 대한 모든 파일 경로에는 다음 구성 요소가 포함됩니다.

#### 파일 경로
<a name="asset-metadata-file-path-subsection"></a>


| 경로 구성 요소 | 설명 | 
| --- | --- | 
|  `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`

### 필드
<a name="asset-metadata-fields"></a>

콜드 티어로 내보내는 자산 메타데이터의 스키마에는 다음 필드가 포함됩니다.

#### 필드
<a name="asset-metadata-fields-subsection"></a>


| 필드 이름 | 설명 | 
| --- | --- | 
|  `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"}
```

## 자산 계층 구조 메타데이터
<a name="asset-hierarchy-metadata"></a>

 AWS IoT SiteWise 가 처음으로 콜드 티어에 데이터를 저장하도록 활성화하면 자산 계층 메타데이터가 콜드 티어로 내보내집니다. 초기 구성 후는 자산 모델 또는 자산 정의를 변경할 때만 자산 계층 구조 메타데이터를 콜드 티어로 내 AWS IoT SiteWise 보냅니다. 자산 계층 구조 메타데이터는 콜드 티어에 새 줄 구분 JSON(`.ndjson`) 형식으로 저장됩니다.

계층 구조, 대상 자산 또는 소스 자산의 외부 식별자는 [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) API를 직접적으로 호출하여 검색됩니다.

### 파일 경로
<a name="asset-hierarchy-metadata-file-path"></a>

AWS IoT SiteWise 는 다음 템플릿을 사용하여 콜드 티어에 자산 계층 구조 메타데이터를 저장합니다.

```
{keyPrefix}/asset_hierarchy_metadata/{parentAssetId}_{hierarchyId}.ndjson
```

콜드 티어의 자산 계층 구조 메타데이터에 대한 모든 파일 경로에는 다음 구성 요소가 포함됩니다.

#### 파일 경로
<a name="asset-hierarchy-metadata-file-path-subsection"></a>


| 경로 구성 요소 | 설명 | 
| --- | --- | 
|  `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`

### 필드
<a name="asset-hierarchy-metadata-fields"></a>

콜드 티어로 내보내는 자산 계층 구조 메타데이터의 스키마에는 다음 필드가 포함됩니다.

#### 필드
<a name="asset-hierarchy-metadata-fields-subsection"></a>


| 필드 이름 | 설명 | 
| --- | --- | 
|  `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. 파일을 선택한 다음 **작업**에서 **다운로드**를 선택합니다.

## 스토리지 데이터 인덱스 파일
<a name="storage-data-index"></a>

AWS IoT SiteWise 는 이러한 파일을 사용하여 데이터 쿼리 성능을 최적화합니다. Amazon S3 버킷에 표시되지만 사용할 필요는 없습니다.

### 파일 경로
<a name="storage-data-index-file-path"></a>

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`