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
AWS IoT SiteWise almacena sus datos en la capa fría replicando 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.
Temas
Datos del equipo (mediciones)
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.avro).
Ruta de archivo
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.
| Componente de ruta | Descripción |
|---|---|
|
|
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. |
|
|
La carpeta que almacena los datos de serie temporal del equipo (mediciones). La carpeta |
|
|
Un número hexadecimal entre 00 y ff. Este número se deriva de
|
|
|
El año de la hora de inicio exclusiva asociada a los datos de serie temporal. |
|
|
El mes de la hora de inicio exclusiva asociada a los datos de serie temporal. |
|
|
El día del mes de la hora de inicio exclusiva asociada a los datos de serie temporal. |
|
|
El nombre del archivo utiliza el carácter de subrayado (_) como delimitador para separar lo siguiente:
El archivo se guarda en el formato |
ejemplo 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
Campos
El esquema de datos sin procesar que se exporta al nivel inactivo contiene los siguientes campos.
| Nombre del campo | Tipos admitidos | Tipo predeterminado | Descripción |
|---|---|---|---|
|
|
|
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. |
|
|
|
N/A |
La marca temporal, en segundos, en formato de tiempo Unix. Los datos fraccionarios de nanosegundos los proporciona |
|
|
|
N/A |
El desfase de nanosegundos procedente de |
|
|
|
N/A |
La calidad del valor de la serie temporal. |
|
|
|
|
Datos de serie temporal de tipo doble (número de punto flotante). |
|
|
|
|
Datos de serie temporal de tipo cadena (secuencia de caracteres). |
|
|
|
|
Datos de serie temporal de tipo entero (número entero). |
|
|
|
|
Datos de serie temporal de tipo booleano (verdadero o falso). |
|
|
|
|
Datos de serie temporal de tipo JSON (tipos de datos complejos almacenados como una cadena). |
|
|
|
|
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. |
ejemplo 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
AWS IoT SiteWise exporta métricas, transforma y agrega 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.avro).
Ruta de archivo
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.
| Componente de ruta | Descripción |
|---|---|
|
|
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. |
|
|
La carpeta que almacena los datos de serie temporal de las métricas. La carpeta |
|
|
Un número hexadecimal entre 00 y ff. Este número se deriva de
|
|
|
El año de la hora de inicio exclusiva asociada a los datos de serie temporal. |
|
|
El mes de la hora de inicio exclusiva asociada a los datos de serie temporal. |
|
|
El día del mes de la hora de inicio exclusiva asociada a los datos de serie temporal. |
|
|
El nombre del archivo utiliza el carácter de subrayado (_) como delimitador para separar lo siguiente:
El archivo se guarda en el formato |
ejemplo 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
Campos
El esquema de las métricas, las transformaciones y los agregados que se exportan al nivel inactivo contiene los siguientes campos.
| Nombre del campo | Tipos admitidos | Tipo predeterminado | Descripción |
|---|---|---|---|
|
|
|
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. |
|
|
|
N/A |
La marca temporal, en segundos, en formato de tiempo Unix. Los datos fraccionarios de nanosegundos los proporciona |
|
|
|
N/A |
El desfase de nanosegundos procedente de |
|
|
|
N/A |
La calidad con la que se filtran los datos de los activos. |
|
|
|
N/A |
El intervalo de tiempo durante el que se van a agregar los datos. |
|
|
|
|
El número total de puntos de datos para las variables dadas durante el intervalo de tiempo actual. |
|
|
|
|
La media de los valores de las variables dadas durante el intervalo de tiempo actual. |
|
|
|
|
El mínimo de los valores de las variables dadas durante el intervalo de tiempo actual. |
|
|
|
|
El máximo de los valores de las variables dadas durante el intervalo de tiempo actual. |
|
|
|
|
La suma de los valores de las variables dadas durante el intervalo de tiempo actual. |
|
|
|
|
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. |
ejemplo 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
Cuando habilitas 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 los activos se guardan en la capa fría en el formato JSON (.ndjson) delimitado por líneas nuevas.
Ruta de archivo
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.
| Componente de ruta | Descripción |
|---|---|
|
|
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. |
|
|
La carpeta que almacena los metadatos de los activos. La carpeta |
|
|
El nombre del archivo utiliza el carácter de subrayado (_) como delimitador para separar lo siguiente:
El archivo se guarda en el formato |
ejemplo ruta del archivo a los metadatos de los activos en el nivel inferior
keyPrefix/asset_metadata/asset_35901915-d476-4dca-8637-d9ed4df939ed.ndjson
Campos
El esquema de metadatos de activos que se exporta al nivel inactivo contiene los siguientes campos.
| Nombre del campo | Descripción |
|---|---|
|
|
El ID del activo. |
|
|
Nombre del activo. |
|
|
El ID externo del activo. |
|
|
Id. del modelo de activo usado para crear el activo. |
|
|
El nombre del modelo del activo. |
|
|
El identificador externo del modelo de activo. |
|
|
El ID de la propiedad del activo. |
|
|
El nombre de la propiedad del activo. |
|
|
El identificador externo de la propiedad del activo. |
|
|
El tipo de datos de la propiedad del activo. |
|
|
La unidad que usa la propiedad del activo (por ejemplo, |
|
|
El alias que identifica la propiedad del activo, como una ruta de flujo de datos del servidor OPC-UA (por ejemplo, |
|
|
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. |
|
|
Un número hexadecimal entre 00 y ff. Este número se deriva de
|
|
|
El ID del modelo compuesto. |
|
|
El identificador externo del modelo compuesto. |
|
|
La descripción del modelo compuesto. |
|
|
El nombre del modelo compuesto. |
|
|
El tipo del modelo compuesto. Para los modelos compuestos de alarma, este tipo es |
|
|
La fecha en que se creó el activo, en formato de tiempo UNIX. |
|
|
La fecha en que el activo se actualizó por última vez, en fecha de inicio Unix. |
|
|
Código de error. |
|
|
Mensaje de error. |
|
|
El estado actual del activo. |
ejemplo 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
Al AWS IoT SiteWise habilitar el almacenamiento de datos en la capa fría 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 la capa fría en el formato JSON (.ndjson) delimitado por líneas nuevas.
Al llamar a la API, se recupera un identificador externo de la jerarquía, el activo de destino o el DescribeAssetactivo de origen.
Ruta de archivo
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.
| Componente de ruta | Descripción |
|---|---|
|
|
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. |
|
|
La carpeta que almacena los metadatos de jerarquía de los activos. La carpeta |
|
|
El nombre del archivo utiliza el carácter de subrayado (_) como delimitador para separar lo siguiente:
El archivo se guarda en el formato |
ejemplo 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
Campos
El esquema de los metadatos de la jerarquía de activos que se exporta al nivel inactivo contiene los siguientes campos.
| Nombre del campo | Descripción |
|---|---|
|
|
El ID del activo de origen en esta relación de activos. |
|
|
El ID del activo de destino en esta relación de activos. |
|
|
El ID de la jerarquía. |
|
|
El tipo de asociación de esta relación de activos. El valor debe ser |
ejemplo 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
-
Vaya a la consola de Amazon S3
. -
En el panel de navegación, elija Buckets y, a continuación, elija el bucket de Amazon S3.
-
Navegue hasta la carpeta que contiene los datos sin procesar, los metadatos de los activos o los metadatos de jerarquía de los activos.
-
Seleccione los archivos y, a continuación, en Acciones, elija Descargar.
Almacenamiento de archivos índice de datos
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
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
ejemplo 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
