Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Dateipfade und Schemas von Daten, die auf der kalten Ebene gespeichert wurden
<a name="file-path-and-schema"></a>

AWS IoT SiteWise speichert Ihre Daten auf der kalten Ebene, indem Zeitreihen repliziert werden, einschließlich Messungen, Metriken, Transformationen und Aggregaten sowie Definitionen von Anlagen und Anlagenmodellen. Im Folgenden werden die Dateipfade und Schemas der Daten beschrieben, die an die Cold-Tier gesendet werden.

**Topics**
+ [

## Gerätedaten (Messungen)
](#measurements-file-path-and-schema)
+ [

## Metriken, Transformationen und Aggregationen
](#metrics-file-path-and-schema)
+ [

## Asset-Metadaten
](#asset-metadata)
+ [

## Metadaten der Asset-Hierarchie
](#asset-hierarchy-metadata)
+ [

## Speicherdaten, Indexdateien
](#storage-data-index)

## Gerätedaten (Messungen)
<a name="measurements-file-path-and-schema"></a>

AWS IoT SiteWise exportiert alle sechs Stunden Gerätedaten (Messungen) in die Kühlzelle. Rohdaten werden im Cold-Tier im [Apache AVRO](https://avro.apache.org) (`.avro`) -Format gespeichert.

### Dateipfad
<a name="measurements-file-path"></a>

AWS IoT SiteWise speichert Gerätedaten (Messungen) im Cold-Tier unter Verwendung der folgenden Vorlage.

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

Jeder Dateipfad zu Rohdaten in Amazon S3 enthält die folgenden Komponenten.

#### Dateipfad
<a name="storage-paths-schemas-file-path"></a>


| Pfadkomponente | Description | 
| --- | --- | 
|  `keyPrefix`  |  Das Amazon S3 S3-Präfix, das Sie in der AWS IoT SiteWise Speicherkonfiguration angegeben haben. Amazon S3 verwendet das Präfix als Ordnernamen im Bucket.  | 
|  `raw`  |  Der Ordner, in dem Zeitreihendaten von Geräten (Messungen) gespeichert werden. Der `raw` Ordner wird im Präfixordner gespeichert.  | 
|  `seriesBucket`  |  Eine Hexadezimalzahl zwischen 00 und ff. Diese Zahl ist abgeleitet von. `timeSeriesId` Diese Partition wird verwendet, um den Durchsatz bei AWS IoT SiteWise Schreibvorgängen auf das Cold-Tier zu erhöhen. Wenn Sie Amazon Athena zum Ausführen von Abfragen verwenden, können Sie die Partition für eine detaillierte Partitionierung verwenden, um die Abfrageleistung zu verbessern. `seriesBucket`und `timeSeriesBucket` in den Asset-Metadaten steht dieselbe Zahl.  | 
|  `startYear`  |  Das Jahr der exklusiven Startzeit, die den Zeitreihendaten zugeordnet ist.  | 
|  `startMonth`  |  Der Monat der exklusiven Startzeit, die den Zeitreihendaten zugeordnet ist.  | 
|  `startDay`  |  Der Tag des Monats, an dem die exklusive Startzeit den Zeitreihendaten zugeordnet ist.  | 
|  `fileName`  |  Der Dateiname verwendet den Unterstrich (\$1) als Trennzeichen, um Folgendes zu trennen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/file-path-and-schema.html) Die Datei wird mithilfe der [Snappy-Komprimierung](https://github.com/google/snappy) in dem `.avro` Format gespeichert.  | 

**Example Dateipfad zu den Rohdaten in der kalten Ebene**  
`keyPrefix/raw/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/raw_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`

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

Das Schema der Rohdaten, die in die Cold-Tier exportiert werden, enthält die folgenden Felder.

 AWS IoT SiteWise rät Kunden, die Unterstützung für die Schemaentwicklung auf Systemen zu implementieren, die Rohdaten aus dem Cold-Tier lesen, da in future möglicherweise weitere Felder eingeführt werden.

 Nulldaten werden so dargestellt, dass alle Wertfelder Null sind. Kunden erhalten jedoch weiterhin den richtigen Datentyp, wenn sie eine Anfrage mit AWS IoT SiteWise APIs stellen. 

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


| Feldname | Unterstützte -Typen | -Standardtyp | Description | 
| --- | --- | --- | --- | 
|  `seriesId`  |  `string`  |  –  |  Die ID, die die Zeitreihendaten von Geräten identifiziert (Messungen). Sie können dieses Feld verwenden, um Rohdaten und Asset-Metadaten in Abfragen zu verknüpfen.  | 
|  `timeInSeconds`  |  `long`  |  –  |  Das Zeitstempeldatum in Sekunden im Unix-Epochenformat. Daten in Bruchteilen von Nanosekunden werden bereitgestellt von. `offsetInNanos`  | 
|  `offsetInNanos`  |  `long`  |  –  |  Der Nanosekunden-Offset von. `timeInSeconds`  | 
|  `quality`  |  `string`  |  –  |  Die Qualität des Zeitreihenwerts.  | 
|  `doubleValue`  |  `double` oder `null`  |  `null`  |  Zeitreihendaten vom Typ Double (Fließkommazahl).  | 
|  `stringValue`  |  `string` oder `null`  |  `null`  |  Zeitreihendaten vom Typ Zeichenfolge (Zeichenfolge).  | 
|  `integerValue`  |  `int` oder `null`  |  `null`  |  Zeitreihendaten vom Typ Integer (ganze Zahl).  | 
|  `booleanValue`  |  `boolean` oder `null`  |  `null`  |  Zeitreihendaten vom Typ Boolean (wahr oder falsch).  | 
|  `jsonValue`  |  `string` oder `null`  |  `null`  |  Zeitreihendaten des Typs JSON (komplexe Datentypen, die als Zeichenfolge gespeichert werden).  | 
|  `recordVersion`  |  `long` oder `null`  |  `null`  |  Die Versionsnummer für den Datensatz. Sie können die Versionsnummer verwenden, um den neuesten Datensatz auszuwählen. Neuere Datensätze haben größere Versionsnummern.  | 

**Example Rohdaten in der kalten Stufe**  

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

## Metriken, Transformationen und Aggregationen
<a name="metrics-file-path-and-schema"></a>

AWS IoT SiteWise exportiert alle sechs Stunden Metriken, Transformationen und Aggregationen in das Cold-Tier. Metriken, Transformationen und Aggregate werden im Cold-Tier im [Apache AVRO](https://avro.apache.org) () -Format gespeichert. `.avro`

### Dateipfad
<a name="metrics-file-path"></a>

AWS IoT SiteWise speichert Metriken, Transformationen und Aggregate im Cold-Tier mithilfe der folgenden Vorlage.

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

Jeder Dateipfad zu Metriken, Transformationen und Aggregationen in Amazon S3 enthält die folgenden Komponenten.

#### Dateipfad
<a name="metrics-file-path-subsection"></a>


| Pfadkomponente | Description | 
| --- | --- | 
|  `keyPrefix`  |  Das Amazon S3 S3-Präfix, das Sie in der AWS IoT SiteWise Speicherkonfiguration angegeben haben. Amazon S3 verwendet das Präfix als Ordnernamen im Bucket.  | 
|  `agg`  |  Der Ordner, in dem Zeitreihendaten aus Metriken gespeichert werden. Der `agg` Ordner wird im Präfixordner gespeichert.  | 
|  `seriesBucket`  |  Eine Hexadezimalzahl zwischen 00 und ff. Diese Zahl ist abgeleitet von. `timeSeriesId` Diese Partition wird verwendet, um den Durchsatz bei AWS IoT SiteWise Schreibvorgängen auf das Cold-Tier zu erhöhen. Wenn Sie Amazon Athena zum Ausführen von Abfragen verwenden, können Sie die Partition für eine detaillierte Partitionierung verwenden, um die Abfrageleistung zu verbessern. `seriesBucket`und `timeSeriesBucket` in den Asset-Metadaten steht dieselbe Zahl.  | 
|  `startYear`  |  Das Jahr der exklusiven Startzeit, die den Zeitreihendaten zugeordnet ist.  | 
|  `startMonth`  |  Der Monat der exklusiven Startzeit, die den Zeitreihendaten zugeordnet ist.  | 
|  `startDay`  |  Der Tag des Monats, an dem die exklusive Startzeit den Zeitreihendaten zugeordnet ist.  | 
|  `fileName`  |  Der Dateiname verwendet den Unterstrich (\$1) als Trennzeichen, um Folgendes zu trennen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/file-path-and-schema.html) Die Datei wird mithilfe der [Snappy-Komprimierung](https://github.com/google/snappy) in dem `.avro` Format gespeichert.  | 

**Example Dateipfad zu den Messwerten in der kalten Stufe**  
`keyPrefix/agg/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/agg_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`

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

Das Schema der Metriken, Transformationen und Aggregate, die in das Cold-Tier exportiert werden, enthält die folgenden Felder.

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


| Feldname | Unterstützte -Typen | -Standardtyp | Description | 
| --- | --- | --- | --- | 
|  `seriesId`  |  `string`  |  –  |  Die ID, die die Zeitreihendaten von Geräten, Metriken oder Transformationen identifiziert. Sie können dieses Feld verwenden, um Rohdaten und Asset-Metadaten in Abfragen zu verknüpfen.  | 
|  `timeInSeconds`  |  `long`  |  –  |  Das Zeitstempeldatum in Sekunden im Unix-Epochenformat. Daten in Bruchteilen von Nanosekunden werden bereitgestellt von. `offsetInNanos`  | 
|  `offsetInNanos`  |  `long`  |  –  |  Der Nanosekunden-Offset von. `timeInSeconds`  | 
|  `quality`  |  `string`  |  –  |  Die Qualität, nach der Anlagendaten gefiltert werden sollen.  | 
|  `resolution`  |  `string`  |  –  |  Das Zeitintervall, über das Daten aggregiert werden sollen.  | 
|  `count`  |  `double` oder `null`  |  `null`  |  Die Gesamtzahl der Datenpunkte für die angegebenen Variablen im aktuellen Zeitintervall.  | 
|  `average`  |  `double` oder `null`  |  `null`  |  Der Mittelwert der Werte der angegebenen Variablen im aktuellen Zeitintervall.  | 
|  `min`  |  `double` oder `null`  |  `null`  |  Das Minimum der Werte der angegebenen Variablen im aktuellen Zeitintervall.  | 
|  `max`  |  `boolean` oder `null`  |  `null`  |  Das Maximum der Werte der angegebenen Variablen im aktuellen Zeitintervall.  | 
|  `sum`  |  `string` oder `null`  |  `null`  |  Die Summe der Werte der angegebenen Variablen im aktuellen Zeitintervall.  | 
|  `recordVersion`  |  `long` oder `null`  |  `null`  |  Die Versionsnummer für den Datensatz. Sie können die Versionsnummer verwenden, um den neuesten Datensatz auszuwählen. Neuere Datensätze haben größere Versionsnummern.  | 

**Example Metrische Daten in der kalten Stufe**  

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

## Asset-Metadaten
<a name="asset-metadata"></a>

Wenn Sie AWS IoT SiteWise zum ersten Mal den Export von Daten in die kalte Ebene aktivieren, werden Asset-Metadaten in die kalte Ebene exportiert. AWS IoT SiteWise Exportiert nach der Erstkonfiguration Asset-Metadaten nur dann in die Ebene, wenn Sie Asset-Modelldefinitionen oder Asset-Definitionen ändern. Asset-Metadaten werden in der kalten Ebene im durch Zeilenumbrüche getrennten JSON () `.ndjson` -Format gespeichert.

### Dateipfad
<a name="asset-metadata-file-path"></a>

AWS IoT SiteWise speichert Asset-Metadaten unter Verwendung der folgenden Vorlage in der kalten Ebene.

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

Jeder Dateipfad zu Asset-Metadaten in der kalten Ebene enthält die folgenden Komponenten.

#### Dateipfad
<a name="asset-metadata-file-path-subsection"></a>


| Pfadkomponente | Description | 
| --- | --- | 
|  `keyPrefix`  |  Das Amazon S3 S3-Präfix, das Sie in der Speicherkonfiguration AWS IoT SiteWise s angegeben haben. Amazon S3 verwendet das Präfix als Ordnernamen im Bucket.  | 
|  `asset_metadata`  |  Der Ordner, der Asset-Metadaten speichert. Der `asset_metadata` Ordner wird im Präfixordner gespeichert.  | 
|  `fileName`  |  Der Dateiname verwendet den Unterstrich (\$1) als Trennzeichen, um Folgendes zu trennen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/file-path-and-schema.html) Die Datei wird im `.ndjson` Format gespeichert.  | 

**Example Dateipfad zu den Asset-Metadaten in der kälteren Ebene**  
`keyPrefix/asset_metadata/asset_35901915-d476-4dca-8637-d9ed4df939ed.ndjson`

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

Das Schema der Asset-Metadaten, das in die kalte Ebene exportiert wird, enthält die folgenden Felder.

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


| Feldname | Description | 
| --- | --- | 
|  `assetId`  |  Die ID der -Komponente.  | 
|  `assetName`  |  Der Name des Assets.  | 
|  `assetExternalId`  |  Die externe ID des Assets.  | 
|  `assetModelId`  |  Die ID des Asset-Modells, das zur Erstellung dieses Assets verwendet wurde.  | 
|  `assetModelName`  |  Der Name des Asset-Modells.  | 
|  `assetModelExternalId`  |  Die externe ID des Asset-Modells.  | 
|  `assetPropertyId`  |  Die ID der Asset-Eigenschaft.  | 
|  `assetPropertyName`  |  Der Name der Anlageeigenschaft.  | 
|  `assetPropertyExternalId`  |  Die externe ID der Anlageeigenschaft.  | 
|  `assetPropertyDataType`  |  Der Datentyp der Anlageneigenschaft.  | 
|  `assetPropertyUnit`  |  Die Einheit der Anlageeigenschaft (z. B. `Newtons` und`RPM`).  | 
|  `assetPropertyAlias`  |  Der Alias, der die Asset-Eigenschaft identifiziert, z. B. einen Datenstream-Pfad eines OPC UA-Servers (z. B.`/company/windfarm/3/turbine/7/temperature`).  | 
|  `timeSeriesId`  |  Die ID, die die Zeitreihendaten von Geräten, Metriken oder Transformationen identifiziert. Sie können dieses Feld verwenden, um Rohdaten und Asset-Metadaten in Abfragen zu verknüpfen.  | 
|  `timeSeriesBucket`  |  Eine Hexadezimalzahl zwischen 00 und ff. Diese Zahl ist abgeleitet von. `timeSeriesId` Diese Partition wird verwendet, um den Durchsatz bei AWS IoT SiteWise Schreibvorgängen auf das Cold-Tier zu erhöhen. Wenn Sie Amazon Athena zum Ausführen von Abfragen verwenden, können Sie die Partition für eine detaillierte Partitionierung verwenden, um die Abfrageleistung zu verbessern. `timeSeriesBucket`und `seriesBucket` im Dateipfad zu den Rohdaten stehen dieselben Zahlen.  | 
|  `assetCompositeModelId`  |  Die ID des zusammengesetzten Modells.  | 
|  `assetCompositeModelExternalId`  |  Die externe ID des zusammengesetzten Modells.  | 
|  `assetCompositeModelDescription`  |  Die Beschreibung des zusammengesetzten Modells.  | 
|  `assetCompositeModelName`  |  Der Name des zusammengesetzten Modells.  | 
|  `assetCompositeModelType`  |  Der Typ des zusammengesetzten Modells. Bei zusammengesetzten Alarmmodellen ist dieser Typ `AWS/ALARM`.  | 
|  `assetCreationDate`  |  Das Datum, an dem das Asset erstellt wurde, in Unix-Epochenzeit.  | 
|  `assetLastUpdateDate`  |  Das Datum, an dem das Asset zuletzt aktualisiert wurde, in Unix-Epochenzeit.  | 
|  `assetStatusErrorCode`  |  Der Fehlercode.  | 
|  `assetStatusErrorMessage`  |  Die Fehlermeldung.  | 
|  `assetStatusState`  |  Der aktuelle Status des Assets.  | 

**Example Asset-Metadaten auf der kalten Ebene**  

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

## Metadaten der Asset-Hierarchie
<a name="asset-hierarchy-metadata"></a>

Wenn Sie das Speichern von Daten AWS IoT SiteWise auf der kalten Ebene zum ersten Mal aktivieren, werden Metadaten der Asset-Hierarchie in die kalte Ebene exportiert. AWS IoT SiteWise Exportiert nach der Erstkonfiguration Metadaten der Asset-Hierarchie nur dann in die Cold-Tier, wenn Sie Änderungen am Asset-Modell oder an den Asset-Definitionen vornehmen. Metadaten der Asset-Hierarchie werden in der kalten Ebene im durch Zeilenumbrüche getrennten JSON () `.ndjson` -Format gespeichert.

Eine externe Kennung für die Hierarchie, das Ziel-Asset oder das Quell-Asset wird durch Aufrufen der API abgerufen. [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) 

### Dateipfad
<a name="asset-hierarchy-metadata-file-path"></a>

AWS IoT SiteWise speichert Metadaten der Asset-Hierarchie auf der kalten Ebene mithilfe der folgenden Vorlage.

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

Jeder Dateipfad zu den Metadaten der Asset-Hierarchie in der kalten Ebene enthält die folgenden Komponenten.

#### Dateipfad
<a name="asset-hierarchy-metadata-file-path-subsection"></a>


| Pfadkomponente | Description | 
| --- | --- | 
|  `keyPrefix`  |  Das Amazon S3 S3-Präfix, das Sie in der AWS IoT SiteWise Speicherkonfiguration angegeben haben. Amazon S3 verwendet das Präfix als Ordnernamen im Bucket.  | 
|  `asset_hierarchy_metadata`  |  Der Ordner, der Metadaten der Asset-Hierarchie speichert. Der `asset_hierarchy_metadata` Ordner wird im Präfixordner gespeichert.  | 
|  `fileName`  |  Der Dateiname verwendet den Unterstrich (\$1) als Trennzeichen, um Folgendes zu trennen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/file-path-and-schema.html) Die Datei wird im `.ndjson` Format gespeichert.  | 

**Example Dateipfad zu den Metadaten der Asset-Hierarchie in der kalten Ebene**  
`keyPrefix/asset_hierarchy_metadata/35901915-d476-4dca-8637-d9ed4df939ed_c5b3ced8-589a-48c7-9998-cdccfc9747a0.ndjson`

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

Das Schema der Metadaten der Asset-Hierarchie, das in die kalte Ebene exportiert wird, enthält die folgenden Felder.

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


| Feldname | Description | 
| --- | --- | 
|  `sourceAssetId`  |  Die ID des Quell-Assets in dieser Asset-Beziehung.  | 
|  `targetAssetId`  |  Die ID der Zielanlage in dieser Vermögensbeziehung.  | 
|  `hierarchyId`  |  Die ID der Hierarchie.  | 
|  `associationType`  |  Der Zuordnungstyp dieser Vermögensbeziehung.  Der Wert muss sein`CHILD`. Die Zielanlage ist eine untergeordnete Anlage der Quellanlage.  | 

**Example Metadaten der Asset-Hierarchie auf der kalten Ebene**  

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

**Um Ihre Daten auf der kalten Ebene anzuzeigen**

1. Navigieren Sie zur [Amazon S3 S3-Konsole](https://console.aws.amazon.com/s3/).

1. Wählen Sie im Navigationsbereich **Buckets** und dann Ihren Amazon S3 S3-Bucket aus.

1. Navigieren Sie zu dem Ordner, der die Rohdaten, Asset-Metadaten oder Asset-Hierarchie-Metadaten enthält.

1. Wählen Sie die Dateien aus, und klicken Sie dann unter **Aktionen** auf **Herunterladen**.

## Speicherdaten, Indexdateien
<a name="storage-data-index"></a>

AWS IoT SiteWise verwendet diese Dateien, um die Leistung von Datenabfragen zu optimieren. Sie werden in Ihrem Amazon S3 S3-Bucket angezeigt, aber Sie müssen sie nicht verwenden.

### Dateipfad
<a name="storage-data-index-file-path"></a>

AWS IoT SiteWise speichert Datenindexdateien mithilfe der folgenden Vorlage im Cold-Tier.

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

**Example Dateipfad zur Datenspeicher-Indexdatei**  
`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`