本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 儲存在冷層中的資料檔案路徑和結構描述
<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 每六小時將設備資料 （測量） 匯出至冷方案一次。原始資料會以 [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>


| 路徑元件 | Description | 
| --- | --- | 
| `keyPrefix` | 您在 AWS IoT SiteWise 儲存組態中指定的 Amazon S3 字首。Amazon S3 使用 字首做為儲存貯體中的資料夾名稱。 | 
| `raw` | 存放來自設備的時間序列資料的資料夾 （度量）。`raw` 資料夾會儲存在字首資料夾中。 | 
| `seriesBucket` | 介於 00 和 ff 之間的十六進位數字。此數字衍生自 `timeSeriesId`。此分割區用於在 AWS IoT SiteWise 寫入冷層時增加輸送量。當您使用 Amazon Athena 執行查詢時，您可以使用 分割區進行精細分割，以改善查詢效能。<br />`seriesBucket` 資產中繼資料`timeSeriesBucket`中的 和 是相同的數字。 | 
| `startYear` | 與時間序列資料相關聯的專屬開始時間年份。 | 
| `startMonth` | 與時間序列資料相關聯的專屬開始時間月份。 | 
| `startDay` | 與時間序列資料相關聯的專屬開始時間當月日期。 | 
| `fileName` | 檔案名稱使用底線 (\_) 字元做為分隔符號來分隔下列項目：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/iot-sitewise/latest/userguide/file-path-and-schema.html)<br />檔案會使用 [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>


| 欄位名稱 | 支援的 類型 | 預設 類型 | Description | 
| --- | --- | --- | --- | 
| `seriesId` | `string` | N/A | 識別來自設備的時間序列資料的 ID （度量）。您可以使用此欄位在查詢中加入原始資料和資產中繼資料。 | 
| `timeInSeconds` | `long` | N/A | 時間戳記日期，以秒為單位，以 Unix epoch 格式顯示。分數奈秒資料由 提供`offsetInNanos`。 | 
| `offsetInNanos` | `long` | N/A | 與 的奈秒位移`timeInSeconds`。 | 
| `quality` | `string` | N/A | 時間序列值的品質。 | 
| `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 每六小時匯出一次指標、轉換和彙總至冷層。指標、轉換和彙總會以 [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>


| 路徑元件 | Description | 
| --- | --- | 
| `keyPrefix` | 您在 AWS IoT SiteWise 儲存組態中指定的 Amazon S3 字首。Amazon S3 使用 字首做為儲存貯體中的資料夾名稱。 | 
| `agg` | 存放來自 指標的時間序列資料的資料夾。`agg` 資料夾會儲存在字首資料夾中。 | 
| `seriesBucket` | 介於 00 和 ff 之間的十六進位數字。此數字衍生自 `timeSeriesId`。此分割區用於在 AWS IoT SiteWise 寫入冷層時增加輸送量。當您使用 Amazon Athena 執行查詢時，您可以使用 分割區進行精細分割，以改善查詢效能。<br />`seriesBucket` 資產中繼資料`timeSeriesBucket`中的 和 是相同的數字。 | 
| `startYear` | 與時間序列資料相關聯的專屬開始時間年份。 | 
| `startMonth` | 與時間序列資料相關聯的專屬開始時間月份。 | 
| `startDay` | 與時間序列資料相關聯的專屬開始時間當月日期。 | 
| `fileName` | 檔案名稱使用底線 (\_) 字元做為分隔符號來分隔下列項目：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/iot-sitewise/latest/userguide/file-path-and-schema.html)<br />檔案會使用 [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>


| 欄位名稱 | 支援的 類型 | 預設 類型 | Description | 
| --- | --- | --- | --- | 
| `seriesId` | `string` | N/A | 識別來自設備、指標或轉換的時間序列資料的 ID。您可以使用此欄位在查詢中加入原始資料和資產中繼資料。 | 
| `timeInSeconds` | `long` | N/A | 時間戳記日期，以秒為單位，以 Unix epoch 格式顯示。分數奈秒資料由 提供`offsetInNanos`。 | 
| `offsetInNanos` | `long` | N/A | 與 的奈秒位移`timeInSeconds`。 | 
| `quality` | `string` | N/A | 篩選資產資料的品質。 | 
| `resolution` | `string` | N/A | 要彙總資料的時間間隔。 | 
| `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>


| 路徑元件 | Description | 
| --- | --- | 
| `keyPrefix` | 您在 儲存組態中指定的 Amazon S3 AWS IoT SiteWise字首。Amazon S3 使用 字首做為儲存貯體中的資料夾名稱。 | 
| `asset_metadata` | 存放資產中繼資料的資料夾。`asset_metadata` 資料夾會儲存在字首資料夾中。 | 
| `fileName` | 檔案名稱使用底線 (\_) 字元做為分隔符號來分隔下列項目：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/iot-sitewise/latest/userguide/file-path-and-schema.html)<br />檔案會以 `.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>


| 欄位名稱 | Description | 
| --- | --- | 
| `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 和 ff 之間的十六進位數字。此數字衍生自 `timeSeriesId`。此分割區用於在 AWS IoT SiteWise 寫入冷層時增加輸送量。當您使用 Amazon Athena 執行查詢時，您可以使用分割區進行精細分割，以改善查詢效能。<br />`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>


| 路徑元件 | Description | 
| --- | --- | 
| `keyPrefix` | 您在 AWS IoT SiteWise 儲存組態中指定的 Amazon S3 字首。Amazon S3 使用 字首做為儲存貯體中的資料夾名稱。 | 
| `asset_hierarchy_metadata` | 存放資產階層中繼資料的資料夾。`asset_hierarchy_metadata` 資料夾會儲存在字首資料夾中。 | 
| `fileName` | 檔案名稱使用底線 (\_) 字元做為分隔符號來分隔下列項目：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/iot-sitewise/latest/userguide/file-path-and-schema.html)<br />檔案會以 `.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>


| 欄位名稱 | Description | 
| --- | --- | 
| `sourceAssetId` | 此資產關係中來源資產的 ID。 | 
| `targetAssetId` | 此資產關係中目標資產的 ID。 | 
| `hierarchyId` | 階層的 ID。 | 
| `associationType` | 此資產關係的關聯類型。<br />值必須為 `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`