

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Rutas de archivos y esquemas de datos guardados en el nivel inactivo
<a name="file-path-and-schema"></a>

AWS IoT SiteWise almacena los datos en la capa fría mediante la replicación de series temporales, incluidas las mediciones, las métricas, las transformaciones y los agregados, así como las definiciones de activos y modelos de activos. A continuación se describen las rutas de los archivos y los esquemas de datos que se envían al nivel inactivo.

**Topics**
+ [Datos del equipo (mediciones)](#measurements-file-path-and-schema)
+ [Métricas, transformaciones y agregados](#metrics-file-path-and-schema)
+ [Metadatos de los activos](#asset-metadata)
+ [Metadatos de jerarquía de los activos](#asset-hierarchy-metadata)
+ [Almacenamiento de archivos índice de datos](#storage-data-index)

## Datos del equipo (mediciones)
<a name="measurements-file-path-and-schema"></a>

AWS IoT SiteWise exporta los datos del equipo (mediciones) a la capa fría una vez cada seis horas. Los datos sin procesar se guardan en el nivel inactivo en formato [Apache AVRO](https://avro.apache.org) (`.avro`).

### Ruta de archivo
<a name="measurements-file-path"></a>

AWS IoT SiteWise almacena los datos del equipo (mediciones) en la capa fría mediante la siguiente plantilla.

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

Cada ruta de archivo a datos sin procesar en Amazon S3 contiene los siguientes componentes.

#### Ruta de archivo
<a name="storage-paths-schemas-file-path"></a>


| Componente de ruta | Description (Descripción) | 
| --- | --- | 
|  `keyPrefix`  |  El prefijo de Amazon S3 que especificó en la configuración AWS IoT SiteWise de almacenamiento. Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket.  | 
|  `raw`  |  La carpeta que almacena los datos de serie temporal del equipo (mediciones). La carpeta `raw` se guarda en la carpeta de prefijos.  | 
|  `seriesBucket`  |  Un número hexadecimal entre 00 y ff. Este número se deriva de `timeSeriesId`. Esta partición se utiliza para aumentar el rendimiento cuando se AWS IoT SiteWise escribe en la capa fría. Cuando se utiliza Amazon Athena para ejecutar consultas, la partición puede servir para realizar particiones refinadas a fin de mejorar la precisión de las consultas. `seriesBucket` y `timeSeriesBucket` son el mismo número en los metadatos del activo.  | 
|  `startYear`  |  El año de la hora de inicio exclusiva asociada a los datos de serie temporal.  | 
|  `startMonth`  |  El mes de la hora de inicio exclusiva asociada a los datos de serie temporal.  | 
|  `startDay`  |  El día del mes de la hora de inicio exclusiva asociada a los datos de serie temporal.  | 
|  `fileName`  |  El nombre del archivo utiliza el carácter de subrayado (\$1) como delimitador para separar lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/file-path-and-schema.html) El archivo se guarda en el formato `.avro` mediante la compresión [Snappy](https://github.com/google/snappy).  | 

**Example ruta del archivo a los datos sin procesar en el nivel inactivo**  
`keyPrefix/raw/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/raw_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`

### Fields
<a name="measurements-fields"></a>

El esquema de datos sin procesar que se exporta al nivel inactivo contiene los siguientes campos.

 AWS IoT SiteWise aconseja a los clientes que implementen el soporte para la evolución de esquemas en los sistemas que leen datos sin procesar de la capa fría, ya que es posible que se introduzcan campos adicionales en el futuro.

 Los datos nulos se representan cuando todos los campos de valores son nulos. Sin embargo, los clientes seguirán recibiendo el tipo de datos correcto cuando realicen consultas. AWS IoT SiteWise APIs 

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


| Nombre del campo | Tipos admitidos | Tipo predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | 
|  `seriesId`  |  `string`  |  N/A  |  El identificador que identifica los datos de serie temporal del equipo (mediciones). Puede usar este campo para unir datos sin procesar y metadatos de activos en las consultas.  | 
|  `timeInSeconds`  |  `long`  |  N/A  |  La marca temporal, en segundos, en formato de tiempo Unix. Los datos fraccionarios de nanosegundos los proporciona `offsetInNanos`.  | 
|  `offsetInNanos`  |  `long`  |  N/A  |  El desfase de nanosegundos procedente de `timeInSeconds`.  | 
|  `quality`  |  `string`  |  N/A  |  La calidad del valor de la serie temporal.  | 
|  `doubleValue`  |  `double` o `null`  |  `null`  |  Datos de serie temporal de tipo doble (número de punto flotante).  | 
|  `stringValue`  |  `string` o `null`  |  `null`  |  Datos de serie temporal de tipo cadena (secuencia de caracteres).  | 
|  `integerValue`  |  `int` o `null`  |  `null`  |  Datos de serie temporal de tipo entero (número entero).  | 
|  `booleanValue`  |  `boolean` o `null`  |  `null`  |  Datos de serie temporal de tipo booleano (verdadero o falso).  | 
|  `jsonValue`  |  `string` o `null`  |  `null`  |  Datos de serie temporal de tipo JSON (tipos de datos complejos almacenados como una cadena).  | 
|  `recordVersion`  |  `long` o `null`  |  `null`  |  El número de versión para el registro. Puede usar el número de versión para seleccionar el registro más reciente. Los registros más recientes tienen números de versión más grandes.  | 

**Example datos sin procesar en el nivel inactivo**  

```
  {"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}
```

## Métricas, transformaciones y agregados
<a name="metrics-file-path-and-schema"></a>

AWS IoT SiteWise exporta métricas, transformaciones y agregados a la capa fría una vez cada seis horas. Las métricas, las transformaciones y los agregados se guardan en el nivel inactivo en el formato [Apache AVRO](https://avro.apache.org) (`.avro`).

### Ruta de archivo
<a name="metrics-file-path"></a>

AWS IoT SiteWise almacena las métricas, las transformaciones y los agregados en la capa fría mediante la siguiente plantilla.

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

Cada ruta de archivo a las métricas, las transformaciones y los agregados en Amazon S3 contiene los siguientes componentes.

#### Ruta de archivo
<a name="metrics-file-path-subsection"></a>


| Componente de ruta | Description (Descripción) | 
| --- | --- | 
|  `keyPrefix`  |  El prefijo de Amazon S3 que especificó en la configuración AWS IoT SiteWise de almacenamiento. Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket.  | 
|  `agg`  |  La carpeta que almacena los datos de serie temporal de las métricas. La carpeta `agg` se guarda en la carpeta de prefijos.  | 
|  `seriesBucket`  |  Un número hexadecimal entre 00 y ff. Este número se deriva de `timeSeriesId`. Esta partición se utiliza para aumentar el rendimiento cuando se AWS IoT SiteWise escribe en la capa fría. Cuando se utiliza Amazon Athena para ejecutar consultas, la partición puede servir para realizar particiones refinadas a fin de mejorar la precisión de las consultas. `seriesBucket` y `timeSeriesBucket` son el mismo número en los metadatos del activo.  | 
|  `startYear`  |  El año de la hora de inicio exclusiva asociada a los datos de serie temporal.  | 
|  `startMonth`  |  El mes de la hora de inicio exclusiva asociada a los datos de serie temporal.  | 
|  `startDay`  |  El día del mes de la hora de inicio exclusiva asociada a los datos de serie temporal.  | 
|  `fileName`  |  El nombre del archivo utiliza el carácter de subrayado (\$1) como delimitador para separar lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/file-path-and-schema.html) El archivo se guarda en el formato `.avro` mediante la compresión [Snappy](https://github.com/google/snappy).  | 

**Example ruta del archivo a las métricas en el nivel inactivo**  
`keyPrefix/agg/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/agg_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`

### Fields
<a name="metrics-fields"></a>

El esquema de las métricas, las transformaciones y los agregados que se exportan al nivel inactivo contiene los siguientes campos.

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


| Nombre del campo | Tipos admitidos | Tipo predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | 
|  `seriesId`  |  `string`  |  N/A  |  El ID que identifica los datos de serie temporal procedentes del equipo, de las métricas o de las transformaciones. Puede usar este campo para unir datos sin procesar y metadatos de activos en las consultas.  | 
|  `timeInSeconds`  |  `long`  |  N/A  |  La marca temporal, en segundos, en formato de tiempo Unix. Los datos fraccionarios de nanosegundos los proporciona `offsetInNanos`.  | 
|  `offsetInNanos`  |  `long`  |  N/A  |  El desfase de nanosegundos procedente de `timeInSeconds`.  | 
|  `quality`  |  `string`  |  N/A  |  La calidad con la que se filtran los datos de los activos.  | 
|  `resolution`  |  `string`  |  N/A  |  El intervalo de tiempo durante el que se van a agregar los datos.  | 
|  `count`  |  `double` o `null`  |  `null`  |  El número total de puntos de datos para las variables dadas durante el intervalo de tiempo actual.  | 
|  `average`  |  `double` o `null`  |  `null`  |  La media de los valores de las variables dadas durante el intervalo de tiempo actual.  | 
|  `min`  |  `double` o `null`  |  `null`  |  El mínimo de los valores de las variables dadas durante el intervalo de tiempo actual.  | 
|  `max`  |  `boolean` o `null`  |  `null`  |  El máximo de los valores de las variables dadas durante el intervalo de tiempo actual.  | 
|  `sum`  |  `string` o `null`  |  `null`  |  La suma de los valores de las variables dadas durante el intervalo de tiempo actual.  | 
|  `recordVersion`  |  `long` o `null`  |  `null`  |  El número de versión para el registro. Puede usar el número de versión para seleccionar el registro más reciente. Los registros más recientes tienen números de versión más grandes.  | 

**Example Datos métricos en el nivel inactivo**  

```
{"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}
```

## Metadatos de los activos
<a name="asset-metadata"></a>

Al habilitar AWS IoT SiteWise la exportación de datos a la capa fría por primera vez, los metadatos de los activos se exportan a la capa fría. Tras la configuración inicial, AWS IoT SiteWise exporta los metadatos de los activos al nivel solo cuando se cambian las definiciones del modelo de activos o las definiciones de activos. Los metadatos de activos se guardan en el nivel de acceso inactivo en el formato JSON delimitado por nuevas líneas (`.ndjson`).

### Ruta de archivo
<a name="asset-metadata-file-path"></a>

AWS IoT SiteWise almacena los metadatos de los activos en la capa fría mediante la siguiente plantilla.

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

Cada ruta de archivo a los metadatos de los activos en el nivel inactivo contiene los siguientes componentes.

#### Ruta de archivo
<a name="asset-metadata-file-path-subsection"></a>


| Componente de ruta | Description (Descripción) | 
| --- | --- | 
|  `keyPrefix`  |  El prefijo de Amazon S3 que especificó en la configuración de almacenamiento AWS IoT SiteWise s. Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket.  | 
|  `asset_metadata`  |  La carpeta que almacena los metadatos de los activos. La carpeta `asset_metadata` se guarda en la carpeta de prefijos.  | 
|  `fileName`  |  El nombre del archivo utiliza el carácter de subrayado (\$1) como delimitador para separar lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/file-path-and-schema.html) El archivo se guarda en el formato `.ndjson`.  | 

**Example ruta del archivo a los metadatos de los activos en el nivel inferior**  
`keyPrefix/asset_metadata/asset_35901915-d476-4dca-8637-d9ed4df939ed.ndjson`

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

El esquema de metadatos de activos que se exporta al nivel inactivo contiene los siguientes campos.

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


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `assetId`  |  El ID del activo.  | 
|  `assetName`  |  Nombre del activo.  | 
|  `assetExternalId`  |  El ID externo del recurso.  | 
|  `assetModelId`  |  Id. del modelo de activos usado para crear el activo.  | 
|  `assetModelName`  |  El nombre del modelo del activo.  | 
|  `assetModelExternalId`  |  ID externo del modelo de activos.  | 
|  `assetPropertyId`  |  El ID de la propiedad del activo.  | 
|  `assetPropertyName`  |  El nombre de la propiedad del activo.  | 
|  `assetPropertyExternalId`  |  ID externo de la propiedad del activo.  | 
|  `assetPropertyDataType`  |  El tipo de datos de la propiedad del activo.  | 
|  `assetPropertyUnit`  |  La unidad que usa la propiedad del activo (por ejemplo, `Newtons` y `RPM`).  | 
|  `assetPropertyAlias`  |  El alias que identifica la propiedad del activo, como una ruta de flujo de datos del servidor OPC UA (por ejemplo, `/company/windfarm/3/turbine/7/temperature`).  | 
|  `timeSeriesId`  |  El ID que identifica los datos de serie temporal procedentes del equipo, de las métricas o de las transformaciones. Puede usar este campo para unir datos sin procesar y metadatos de activos en las consultas.  | 
|  `timeSeriesBucket`  |  Un número hexadecimal entre 00 y ff. Este número se deriva de `timeSeriesId`. Esta partición se utiliza para aumentar el rendimiento cuando se AWS IoT SiteWise escribe en la capa fría. Cuando se utiliza Amazon Athena para ejecutar consultas, la partición puede servir para realizar particiones refinadas a fin de mejorar la precisión de las consultas. `timeSeriesBucket` y `seriesBucket` son el mismo número en la ruta del archivo a los datos sin procesar.  | 
|  `assetCompositeModelId`  |  ID del modelo compuesto.  | 
|  `assetCompositeModelExternalId`  |  ID externo del modelo compuesto.  | 
|  `assetCompositeModelDescription`  |  La descripción del modelo compuesto.  | 
|  `assetCompositeModelName`  |  El nombre del modelo compuesto.  | 
|  `assetCompositeModelType`  |  El tipo del modelo compuesto. Para los modelos compuestos de alarma, este tipo es `AWS/ALARM`.  | 
|  `assetCreationDate`  |  La fecha en que se creó el activo, en formato de tiempo UNIX.  | 
|  `assetLastUpdateDate`  |  La fecha en que el activo se actualizó por última vez, en fecha de inicio Unix.  | 
|  `assetStatusErrorCode`  |  Código de error.  | 
|  `assetStatusErrorMessage`  |  Mensaje de error.  | 
|  `assetStatusState`  |  El estado actual del activo.  | 

**Example metadatos de activos en el nivel inactivo**  

```
  {"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"}
```

## Metadatos de jerarquía de los activos
<a name="asset-hierarchy-metadata"></a>

Cuando habilita AWS IoT SiteWise guardar datos en la capa inactiva por primera vez, los metadatos de la jerarquía de activos se exportan a la capa fría. Tras la configuración inicial, AWS IoT SiteWise exporta los metadatos de la jerarquía de activos a la capa fría solo cuando se realizan cambios en el modelo de activos o en las definiciones de activos. Los metadatos de la jerarquía de activos se guardan en el nivel inactivo en el formato JSON delimitado por nuevas líneas (`.ndjson`).

Al llamar a la [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)API, se recupera un identificador externo de la jerarquía, el activo de destino o el activo de origen. 

### Ruta de archivo
<a name="asset-hierarchy-metadata-file-path"></a>

AWS IoT SiteWise almacena los metadatos de la jerarquía de activos en la capa fría mediante la siguiente plantilla.

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

Cada ruta de archivo a los metadatos de jerarquía de los activos en el nivel inactivo contiene los siguientes componentes.

#### Ruta de archivo
<a name="asset-hierarchy-metadata-file-path-subsection"></a>


| Componente de ruta | Description (Descripción) | 
| --- | --- | 
|  `keyPrefix`  |  El prefijo de Amazon S3 que especificó en la configuración AWS IoT SiteWise de almacenamiento. Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket.  | 
|  `asset_hierarchy_metadata`  |  La carpeta que almacena los metadatos de jerarquía de los activos. La carpeta `asset_hierarchy_metadata` se guarda en la carpeta de prefijos.  | 
|  `fileName`  |  El nombre del archivo utiliza el carácter de subrayado (\$1) como delimitador para separar lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/file-path-and-schema.html) El archivo se guarda en el formato `.ndjson`.  | 

**Example ruta del archivo a los metadatos de la jerarquía de activos en el nivel inactivo**  
`keyPrefix/asset_hierarchy_metadata/35901915-d476-4dca-8637-d9ed4df939ed_c5b3ced8-589a-48c7-9998-cdccfc9747a0.ndjson`

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

El esquema de los metadatos de la jerarquía de activos que se exporta al nivel inactivo contiene los siguientes campos.

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


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `sourceAssetId`  |  El ID del activo de origen en esta relación de activos.  | 
|  `targetAssetId`  |  El ID del activo de destino en esta relación de activos.  | 
|  `hierarchyId`  |  El ID de la jerarquía.  | 
|  `associationType`  |  El tipo de asociación de esta relación de activos.  El valor debe ser `CHILD`. El activo de destino es una entidad secundaria del activo de origen.  | 

**Example los metadatos de jerarquía de los activos en el nivel inactivo**  

```
{"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"}
```

**Para ver los datos en el nivel inactivo**

1. Vaya a la [consola de Amazon S3](https://console.aws.amazon.com/s3/).

1. En el panel de navegación, elija **Buckets** y, a continuación, elija el bucket de Amazon S3.

1. Navegue hasta la carpeta que contiene los datos sin procesar, los metadatos de los activos o los metadatos de jerarquía de los activos.

1. Seleccione los archivos y, a continuación, en **Acciones**, elija **Descargar**.

## Almacenamiento de archivos índice de datos
<a name="storage-data-index"></a>

AWS IoT SiteWise utiliza estos archivos para optimizar el rendimiento de las consultas de datos. Aparecen en u bucket de Amazon S3, pero no es necesario que los utilice.

### Ruta de archivo
<a name="storage-data-index-file-path"></a>

AWS IoT SiteWise almacena los archivos de índice de datos en la capa fría mediante la siguiente plantilla.

```
keyPrefix/index/series=timeseriesId/startYear=startYear/startMonth=startMonth/startDay=startDay/index_timeseriesId_startTimestamp_quality
```

**Example ruta del archivo al archivo índice de almacenamiento de datos**  
`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`