Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Gérez le stockage des données dans AWS IoT SiteWise
Vous pouvez configurer AWS IoT SiteWise pour enregistrer vos données dans les niveaux de stockage suivants :
**Niveau chaud**
Le niveau de stockage à chaud est un stockage de séries chronologiques AWS IoT SiteWise géré. Le mode Hot Tier est particulièrement efficace pour les données fréquemment consultées, avec une faible write-to-read latence. Les données stockées dans le hot tier sont utilisées par les applications industrielles qui ont besoin d'un accès rapide aux dernières valeurs de mesure de votre équipement. Cela inclut les applications qui visualisent les métriques en temps réel à l'aide d'un tableau de bord interactif, ou les applications qui surveillent les opérations et lancent des alarmes pour identifier les problèmes de performance.
Par défaut, les données ingérées sont AWS IoT SiteWise stockées dans le hot tier. Vous pouvez définir une période de conservation pour le niveau chaud, après quoi les AWS IoT SiteWise données du niveau chaud sont transférées vers le niveau de stockage chaud ou froid, en fonction de votre configuration. Pour optimiser les performances et la rentabilité, définissez la période de rétention de votre hot tier de manière à ce qu'elle soit plus longue que le temps nécessaire pour récupérer souvent les données. Ceci est utilisé pour les métriques en temps réel, les alarmes et les scénarios de surveillance. Si aucune période de conservation n'est définie, vos données sont stockées indéfiniment dans le hot tier.
**Niveau chaud**
Le niveau de stockage à chaud est un niveau AWS IoT SiteWise géré efficace pour le stockage rentable des données historiques. Il est préférable de l'utiliser pour récupérer de gros volumes de données présentant des caractéristiques de write-to-read latence moyenne. Utilisez le niveau chaud pour stocker les données historiques nécessaires aux charges de travail importantes. Par exemple, il est utilisé pour la récupération de données pour les analyses, les applications de business intelligence (BI), les outils de reporting et la formation de modèles d'apprentissage automatique (ML). Si vous activez le niveau de stockage à froid, vous pouvez définir une période de rétention du niveau chaud. Une fois la période de conservation terminée, AWS IoT SiteWise les données sont supprimées du niveau chaud.
**Niveau froid**
Le niveau de stockage à froid utilise un compartiment Amazon S3 pour stocker des données rarement utilisées. Lorsque le niveau froid est activé, AWS IoT SiteWise reproduit les séries chronologiques, y compris les mesures, les métriques, les transformations et les agrégats, ainsi que les définitions des modèles d'actifs toutes les 6 heures. Le niveau froid est utilisé pour stocker des données qui tolèrent une latence de lecture élevée pour les rapports historiques et les sauvegardes.
**Topics**
+ [Configurer les paramètres de stockage dans AWS IoT SiteWise](configure-storage.md)
+ [Résoudre les problèmes liés aux paramètres de stockage pour AWS IoT SiteWise](troubleshoot-storage-configuration.md)
+ [Chemins de fichiers et schémas de données enregistrés dans le niveau froid](file-path-and-schema.md)
# Configurer les paramètres de stockage dans AWS IoT SiteWise
Vous pouvez configurer les paramètres de stockage pour opter pour le stockage de niveau chaud géré par service et également pour répliquer les données vers le niveau froid. Pour en savoir plus sur la durée de conservation des niveaux chaud et chaud, consultez[Impact sur la conservation des données](#retention-period). Lors de la configuration des paramètres de stockage, procédez comme suit :
+ **Rétention de niveau chaud** : définissez une période de conservation pour la durée pendant laquelle vos données sont stockées dans le niveau chaud avant d'être supprimées, puis transférées vers le stockage de niveau chaud ou le stockage de niveau froid géré par le service en fonction de vos paramètres de stockage. AWS IoT SiteWise supprimera toutes les données du hot tier qui existaient avant la fin de la période de conservation. Si vous ne définissez pas de période de conservation, vos données sont stockées indéfiniment dans le hot tier.
+ **Rétention au niveau chaud** : définissez une période de conservation pour la durée pendant laquelle vos données sont stockées dans le niveau chaud avant qu'elles ne soient supprimées du AWS IoT SiteWise stockage et transférées vers le stockage à froid géré par le client. AWS IoT SiteWise supprime toutes les données du niveau chaud qui existaient avant la fin de la période de rétention. Si aucune période de conservation n'est définie, vos données sont stockées indéfiniment dans le niveau chaud.
**Note**
Pour améliorer les performances des requêtes, définissez une période de rétention de niveau chaud avec un stockage de niveau chaud.
## Impact de la conservation des données dans les systèmes de stockage à chaud et à chaud
+ Lorsque vous réduisez la durée de conservation du niveau de stockage chaud, les données sont définitivement déplacées du niveau chaud vers le niveau chaud ou froid. Lorsque vous réduisez la durée de conservation du niveau chaud, les données sont déplacées vers le niveau froid et définitivement supprimées du niveau chaud.
+ Lorsque vous augmentez la durée de conservation du niveau de stockage chaud ou chaud, la modification affecte les données qui sont ensuite envoyées AWS IoT SiteWise . AWS IoT SiteWise ne récupère pas les données du stockage chaud ou froid pour alimenter le niveau chaud. Par exemple, si la période de conservation du stockage de niveau chaud est initialement fixée à 30 jours, puis portée à 60 jours, il faut 30 jours pour que le stockage de niveau chaud contienne 60 jours de données.
**Topics**
+ [Impact de la conservation des données dans les systèmes de stockage à chaud et à chaud](#retention-period)
+ [Configurer les paramètres de stockage pour Warm Tier (console)](#configure-storage-console-warm)
+ [Configurer les paramètres de stockage pour Warm Tier (AWS CLI)](#configure-storage-cli-warm)
+ [Configuration des paramètres de stockage pour le niveau froid (console)](#configure-storage-console)
+ [Configurer les paramètres de stockage pour Cold Tier (AWS CLI)](#configure-storage-cli)
## Configurer les paramètres de stockage pour Warm Tier (console)
La procédure suivante explique comment configurer les paramètres de stockage pour répliquer les données vers le niveau chaud de la AWS IoT SiteWise console.
**Pour configurer les paramètres de stockage dans la console**
1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation, sous **Paramètres**, choisissez **Stockage**.
1. Dans le coin supérieur droit, choisissez **Modifier**.
1. Sur la page **Modifier le stockage**, procédez comme suit :
1. Pour les **paramètres Hot Tier**, procédez comme suit :
+ Si vous souhaitez définir une période de conservation correspondant à la durée pendant laquelle vos données sont stockées dans le niveau chaud avant leur suppression et leur transfert vers le stockage à chaud géré par le service, choisissez **Activer la période de conservation**.
+ Pour configurer une période de rétention, entrez un nombre entier et choisissez une unité. La durée de conservation doit être supérieure ou égale à 30 jours.
AWS IoT SiteWise supprime toutes les données du hot tier qui sont antérieures à la période de conservation. Si vous ne définissez pas de période de conservation, vos données sont stockées indéfiniment.
1. (Recommandé) Pour les **paramètres du niveau Warm**, procédez comme suit :
+ Pour opter pour le stockage à niveau chaud, sélectionnez **Je confirme pour activer le stockage à niveau chaud** pour opter pour le stockage à niveau chaud.
+ (Facultatif) Pour configurer une période de rétention, entrez un nombre entier et choisissez une unité. La durée de conservation doit être supérieure ou égale à 365 jours.
AWS IoT SiteWise supprime les données du niveau chaud qui existaient avant la période de rétention. Si vous ne définissez pas de période de conservation, vos données sont stockées indéfiniment.
**Note**
Lorsque vous optez pour le niveau chaud, la configuration ne s'affiche qu'une seule fois.
Pour définir le niveau de rétention à chaud, vous devez disposer d'un niveau de stockage à chaud ou à froid. Pour des raisons de rentabilité et de récupération des données historiques, il est AWS IoT SiteWise recommandé de stocker les données à long terme dans le niveau chaud.
Pour définir le niveau de rétention à chaud, vous devez disposer d'un niveau de stockage à froid.
1. Choisissez **Enregistrer** pour enregistrer vos paramètres de stockage.
Dans la section **AWS IoT SiteWise stockage**, le **stockage de niveau Warm** se trouve dans l'un des états suivants :
+ **Activé** : si vos données existaient avant la période de rétention du niveau chaud, AWS IoT SiteWise déplacez-les vers le niveau chaud. »
+ **Désactivé** : le stockage à chaud est désactivé.
## Configurer les paramètres de stockage pour Warm Tier (AWS CLI)
Vous pouvez configurer les paramètres de stockage pour déplacer les données vers le niveau chaud à l' AWS CLI aide des commandes suivantes.
Pour éviter de remplacer la configuration existante, récupérez les informations de configuration de stockage actuelles en exécutant la commande suivante :
```
aws iotsitewise describe-storage-configuration
```
**Example réponse sans configuration de niveau froid existante**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-10-14T15:53:35-07:00",
"warmTier": "DISABLED"
}
```
**Example réponse avec la configuration de niveau froid existante**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": retention-in-days
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2023-10-25T15:59:46-07:00",
"warmTier": "DISABLED"
}
```
### Configurez les paramètres de stockage pour le niveau chaud avec AWS CLI
Exécutez la commande suivante pour configurer les paramètres de stockage. Remplacez `file-name` par le nom du fichier contenant la configuration AWS IoT SiteWise de stockage.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuration avec niveau chaud et niveau chaud**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"warmTier": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
}
}
```
`hot-tier-retention-in-days`doit être un nombre entier supérieur ou égal à 30 jours.
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
Si le stockage à froid est activé, consultez[Configuration des paramètres de stockage avec un AWS CLI niveau froid existant](#configure-storage-cli-existing-cold).
### Configuration des paramètres de stockage avec un AWS CLI niveau froid existant
**Configuration des paramètres de stockage à l' AWS CLI aide du stockage à froid existant**
+ Exécutez la commande suivante pour configurer les paramètres de stockage. Remplacez *file-name* par le nom du fichier contenant la configuration AWS IoT SiteWise de stockage.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuration de stockage**
+ *amzn-s3-demo-bucket*Remplacez-le par le nom de votre compartiment Amazon S3.
+ *prefix*Remplacez-le par votre préfixe Amazon S3.
+ Remplacez *aws-account-id* par votre identifiant de AWS compte.
+ Remplacez *role-name* par le nom du rôle d'accès Amazon S3 qui permet AWS IoT SiteWise d'envoyer des données à Amazon S3.
+ Remplacez *hot-tier-retention-in-days* par un nombre entier supérieur ou égal à 30 jours.
+ Remplacez *warm-tier-retention-in-days* par un nombre entier supérieur ou égal à 365 jours.
**Note**
AWS IoT SiteWise supprimera toutes les données du niveau chaud qui sont antérieures à la période de conservation du niveau froid. Si vous ne définissez pas de période de conservation, vos données sont stockées indéfiniment.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
},
"warmTier": "ENABLED",
"warmTierRetentionPeriod": {
"numberOfDays": warm-tier-retention-in-days
}
}
```
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
## Configuration des paramètres de stockage pour le niveau froid (console)
La procédure suivante explique comment configurer les paramètres de stockage pour répliquer les données vers le niveau froid de la AWS IoT SiteWise console.
**Pour configurer les paramètres de stockage dans la console**
1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation, sous **Paramètres**, choisissez **Stockage**.
1. Dans le coin supérieur droit, choisissez **Modifier**.
1. Sur la page **Modifier le stockage**, procédez comme suit :
1. Pour les **paramètres de stockage**, choisissez **Activer le stockage à froid**. Le stockage à froid est désactivé par défaut.
1. Pour l'**emplacement du compartiment S3**, entrez le nom d'un compartiment Amazon S3 existant et un préfixe.
**Note**
Amazon S3 utilise le préfixe comme nom de dossier dans le compartiment Amazon S3. Le préfixe doit comporter de 1 à 255 caractères et se terminer par une barre oblique (/). Vos AWS IoT SiteWise données sont enregistrées dans ce dossier.
Si vous n'avez pas de compartiment Amazon S3, choisissez **View**, puis créez-en un dans la console Amazon S3. Pour plus d'informations, consultez la section [Création de votre premier compartiment S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) dans le *guide de l'utilisateur Amazon S3*.
1. Pour le **rôle d'accès S3**, effectuez l'une des opérations suivantes :
+ Choisissez **Create a role from an AWS managed template**, puis créez AWS automatiquement un rôle IAM qui permet d' AWS IoT SiteWise envoyer des données à Amazon S3.
+ Choisissez **Utiliser un rôle existant**, puis choisissez le rôle que vous avez créé dans la liste.
**Note**
Vous devez utiliser le même nom de compartiment Amazon S3 pour l'**emplacement du compartiment S3** que celui que vous avez utilisé à l'étape précédente et dans votre politique IAM.
Assurez-vous que votre rôle dispose des autorisations indiquées dans l'exemple suivant.
**Example politique d'autorisations :**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
Remplacez amzn-s3-demo-bucket par le nom de votre compartiment Amazon S3.
Si le compartiment Amazon S3 est chiffré à l'aide d'une clé KMS gérée par le client, la clé KMS doit avoir une politique d'accès avec un rôle IAM pour les `kms:GenerateDataKey` opérations `kms:Decrypt` et les opérations.
1. Pour configurer le hot tier, reportez-vous à l'étape 5 de[Configurer les paramètres de stockage pour Warm Tier (console)](#configure-storage-console-warm).
1. (Facultatif) Pour **AWS IoT Analytics l'intégration**, procédez comme suit.
**Note**
Avis de fin de support : le 15 décembre 2025, AWS le support de AWS IoT Analytics. Après le 15 décembre 2025, vous ne pourrez plus accéder à la AWS IoT Analytics console ni aux AWS IoT Analytics ressources. Pour plus d'informations, voir [AWS IoT Analytics fin du support](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
1. Si vous souhaitez l'utiliser AWS IoT Analytics pour interroger vos données, choisissez **Enabled AWS IoT Analytics data store**.
1. AWS IoT SiteWise génère un nom pour votre banque de données ou vous pouvez saisir un autre nom.
AWS IoT SiteWise crée automatiquement un magasin de données AWS IoT Analytics pour enregistrer vos données. Pour interroger les données, vous pouvez AWS IoT Analytics créer des ensembles de données. Pour plus d'informations, consultez la section [Utilisation des AWS IoT SiteWise données](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) dans le *Guide de AWS IoT Analytics l'utilisateur*.
1. Choisissez **Enregistrer**.
Dans la section **AWS IoT SiteWise de stockage**, le **stockage à froid** peut prendre l'une des valeurs suivantes :
+ **Activé** : AWS IoT SiteWise réplique vos données dans le compartiment Amazon S3 spécifié.
+ **Activation** : AWS IoT SiteWise traite votre demande pour activer le stockage à froid. Ce processus peut prendre plusieurs minutes.
+ **Enable\$1Failed** : AWS IoT SiteWise impossible de traiter votre demande d'activation du stockage à froid. Si vous avez activé AWS IoT SiteWise l'envoi de journaux vers Amazon CloudWatch Logs, vous pouvez utiliser ces journaux pour résoudre les problèmes. Pour de plus amples informations, veuillez consulter [Surveillez avec Amazon CloudWatch Logs](monitor-cloudwatch-logs.md).
+ **Désactivé** : le stockage à froid est désactivé.
## Configurer les paramètres de stockage pour Cold Tier (AWS CLI)
La procédure suivante explique comment configurer les paramètres de stockage pour répliquer les données vers le niveau froid à l'aide AWS CLI de.
**Pour configurer les paramètres de stockage à l'aide de AWS CLI**
1. Pour exporter des données vers un compartiment Amazon S3 de votre compte, exécutez la commande suivante pour configurer les paramètres de stockage. Remplacez *file-name* par le nom du fichier contenant la configuration AWS IoT SiteWise de stockage.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuration de stockage**
+ *amzn-s3-demo-bucket*Remplacez-le par le nom de votre compartiment Amazon S3.
+ *prefix*Remplacez-le par votre préfixe Amazon S3.
+ Remplacez *aws-account-id* par votre identifiant de AWS compte.
+ Remplacez *role-name* par le nom du rôle d'accès Amazon S3 qui permet AWS IoT SiteWise d'envoyer des données à Amazon S3.
+ Remplacez *retention-in-days* par un nombre entier supérieur ou égal à 30 jours.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"retentionPeriod": {
"numberOfDays": retention-in-days,
"unlimited": false
}
}
```
**Note**
Vous devez utiliser le même nom de compartiment Amazon S3 dans la configuration de AWS IoT SiteWise stockage et dans la politique IAM.
Assurez-vous que votre rôle dispose des autorisations indiquées dans l'exemple suivant.
**Example politique d'autorisations :**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
Remplacez amzn-s3-demo-bucket par le nom de votre compartiment Amazon S3.
Si le compartiment Amazon S3 est chiffré à l'aide d'une clé KMS gérée par le client, la clé KMS doit avoir une politique d'accès avec un rôle IAM pour les `kms:GenerateDataKey` opérations `kms:Decrypt` et les opérations.
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
**Note**
La mise à jour de la configuration AWS IoT SiteWise de stockage peut prendre quelques minutes.
1. Pour récupérer les informations de configuration du stockage, exécutez la commande suivante.
```
aws iotsitewise describe-storage-configuration
```
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/torque/",
"roleArn": "arn:aws:iam::123456789012:role/SWAccessS3Role"
}
},
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:54:14-07:00"
}
```
1. Pour arrêter d'exporter des données vers le compartiment Amazon S3, exécutez la commande suivante pour configurer les paramètres de stockage.
```
aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
```
**Note**
Par défaut, vos données ne sont stockées que dans le niveau chaud de AWS IoT SiteWise.
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
1. Pour récupérer les informations de configuration du stockage, exécutez la commande suivante.
```
aws iotsitewise describe-storage-configuration
```
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:57:14-07:00"
}
```
### (Facultatif) Créez un magasin de AWS IoT Analytics données (AWS CLI)
**Note**
Avis de fin de support : le 15 décembre 2025, AWS le support de AWS IoT Analytics. Après le 15 décembre 2025, vous ne pourrez plus accéder à la AWS IoT Analytics console ni aux AWS IoT Analytics ressources. Pour plus d'informations, voir [AWS IoT Analytics fin du support](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
Un magasin de AWS IoT Analytics données est un référentiel évolutif et interrogeable qui reçoit et stocke des données. Vous pouvez utiliser la AWS IoT SiteWise console ou AWS IoT Analytics APIs créer un magasin de AWS IoT Analytics données pour enregistrer vos AWS IoT SiteWise données. Pour interroger les données, vous créez des ensembles de données à l'aide AWS IoT Analytics de. Pour plus d'informations, consultez la section [Utilisation des AWS IoT SiteWise données](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) dans le *Guide de AWS IoT Analytics l'utilisateur*.
Les étapes suivantes permettent AWS CLI de créer un magasin de données dans AWS IoT Analytics.
Pour créer un magasin de données, exécutez la commande suivante. Remplacez *file-name* par le nom du fichier contenant la configuration du magasin de données.
```
aws iotanalytics create-datastore --cli-input-json file://file-name.json
```
**Note**
Vous devez spécifier le nom d'un compartiment Amazon S3 existant. Si vous n'avez pas de compartiment Amazon S3, créez-en un d'abord. Pour plus d'informations, consultez la section [Création de votre premier compartiment S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) dans le *guide de l'utilisateur Amazon S3*.
Vous devez utiliser le même nom de compartiment Amazon S3 dans la configuration du AWS IoT SiteWise stockage, la politique IAM et la configuration du magasin de AWS IoT Analytics données.
**Example AWS IoT Analytics configuration du magasin de données**
Remplacez *data-store-name* et *amzn-s3-demo-bucket* par le nom de votre banque de AWS IoT Analytics données et le nom du compartiment Amazon S3.
```
{
"datastoreName": "data-store-name",
"datastoreStorage": {
"iotSiteWiseMultiLayerStorage": {
"customerManagedS3Storage": {
"bucket": "amzn-s3-demo-bucket"
}
}
},
"retentionPeriod": {
"numberOfDays": 90
}
}
```
**Example response**
```
{
"datastoreName": "datastore_IoTSiteWise_demo",
"datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
"retentionPeriod": {
"numberOfDays": 90,
"unlimited": false
}
}
```
# Résoudre les problèmes liés aux paramètres de stockage pour AWS IoT SiteWise
Utilisez les informations suivantes pour résoudre les problèmes liés à la configuration du stockage.
**Topics**
+ [Erreur : le compartiment n'existe pas](#no-s3-bucket)
+ [Erreur : accès refusé au chemin Amazon S3](#iam-permissions)
+ [Erreur : l'ARN du rôle ne peut pas être assumé](#iam-trust-relationship)
+ [Erreur : Impossible d'accéder au compartiment Amazon S3 interrégional](#cross-region-s3-bucket)
## Erreur : le compartiment n'existe pas
**Solution :** AWS IoT SiteWise impossible de trouver votre compartiment Amazon S3. Assurez-vous de saisir le nom d'un compartiment Amazon S3 existant dans la région actuelle.
## Erreur : accès refusé au chemin Amazon S3
**Solution :** AWS IoT SiteWise impossible d'accéder à votre compartiment Amazon S3. Procédez comme suit :
+ Assurez-vous d'utiliser le même compartiment Amazon S3 que celui que vous avez spécifié dans la politique IAM.
+ Assurez-vous que votre rôle dispose des autorisations indiquées dans l'exemple suivant.
**Example stratégie d'autorisation**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
------
Remplacez amzn-s3-demo-bucket par le nom de votre compartiment Amazon S3.
## Erreur : l'ARN du rôle ne peut pas être assumé
**Solution :** AWS IoT SiteWise je n'ai pas pu assumer le rôle IAM en votre nom. Assurez-vous que votre rôle fait confiance au service suivant :`iotsitewise.amazonaws.com`. Pour plus d'informations, voir [Je ne peux pas assumer un rôle, voir le](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_cant-assume-role) *guide de l'utilisateur IAM*.
## Erreur : Impossible d'accéder au compartiment Amazon S3 interrégional
**Solution :** Le compartiment Amazon S3 que vous avez spécifié se trouve dans une autre AWS région. Assurez-vous que votre compartiment Amazon S3 et vos AWS IoT SiteWise actifs se trouvent dans la même région.
# Chemins de fichiers et schémas de données enregistrés dans le niveau froid
AWS IoT SiteWise stocke vos données dans la couche froide en répliquant des séries chronologiques, notamment des mesures, des métriques, des transformations et des agrégats, ainsi que des définitions d'actifs et de modèles d'actifs. Ce qui suit décrit les chemins de fichiers et les schémas de données envoyés au niveau froid.
**Topics**
+ [Données relatives à l'équipement (mesures)](#measurements-file-path-and-schema)
+ [Métriques, transformations et agrégats](#metrics-file-path-and-schema)
+ [Métadonnées des actifs](#asset-metadata)
+ [Métadonnées de hiérarchie des actifs](#asset-hierarchy-metadata)
+ [Fichiers d'index des données de stockage](#storage-data-index)
## Données relatives à l'équipement (mesures)
AWS IoT SiteWise exporte les données de l'équipement (mesures) vers le niveau froid une fois toutes les six heures. Les données brutes sont enregistrées dans le niveau froid au format [Apache AVRO](https://avro.apache.org) (`.avro`).
### Chemin d'accès du fichier
AWS IoT SiteWise stocke les données de l'équipement (mesures) dans le niveau froid à l'aide du modèle suivant.
```
{keyPrefix}/raw/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/raw_{timeseriesId}_{startTimestamp}_{quality}.avro
```
Chaque chemin de fichier vers les données brutes dans Amazon S3 contient les composants suivants.
#### Chemin d'accès du fichier
| Composant Path | Description |
| --- | --- |
| `keyPrefix` | Le préfixe Amazon S3 que vous avez spécifié dans la configuration AWS IoT SiteWise de stockage. Amazon S3 utilise le préfixe comme nom de dossier dans le compartiment. |
| `raw` | Le dossier qui stocke les séries chronologiques des équipements (mesures). Le `raw` dossier est enregistré dans le dossier des préfixes. |
| `seriesBucket` | Nombre hexadécimal compris entre 00 et ff. Ce numéro est dérivé de`timeSeriesId`. Cette partition est utilisée pour augmenter le débit lors des AWS IoT SiteWise écritures sur le niveau froid. Lorsque vous utilisez Amazon Athena pour exécuter des requêtes, vous pouvez utiliser la partition pour un partitionnement précis afin d'améliorer les performances des requêtes. `seriesBucket`et `timeSeriesBucket` dans les métadonnées des actifs figurent le même numéro. |
| `startYear` | Année de début exclusive associée aux données de la série chronologique. |
| `startMonth` | Le mois de l'heure de début exclusive associée aux données de la série chronologique. |
| `startDay` | Le jour du mois de l'heure de début exclusive associée aux données de la série chronologique. |
| `fileName` | Le nom du fichier utilise le trait de soulignement (\$1) comme séparateur pour séparer les éléments suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/file-path-and-schema.html) Le fichier est enregistré au `.avro` format à l'aide de la compression [Snappy](https://github.com/google/snappy). |
**Example chemin du fichier vers les données brutes dans le niveau froid**
`keyPrefix/raw/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/raw_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`
### Champs
Le schéma des données brutes exportées vers le niveau froid contient les champs suivants.
AWS IoT SiteWise conseille aux clients de mettre en œuvre le support pour l'évolution des schémas sur les systèmes qui lisent les données brutes depuis le niveau froid, car des champs supplémentaires pourraient être introduits à l'avenir.
Les données nulles sont représentées par le fait que tous les champs de valeur sont nuls. Toutefois, les clients recevront toujours le type de données correct lorsqu'ils effectueront des AWS IoT SiteWise APIs requêtes.
#### Champs
| Nom de champ | Types pris en charge | Type par défaut | Description |
| --- | --- | --- | --- |
| `seriesId` | `string` | N/A | ID identifiant les séries chronologiques de l'équipement (mesures). Vous pouvez utiliser ce champ pour joindre des données brutes et des métadonnées d'actifs dans des requêtes. |
| `timeInSeconds` | `long` | N/A | Date d'horodatage, en secondes, au format Unix Epoch. Les données de nanosecondes fractionnaires sont fournies par. `offsetInNanos` |
| `offsetInNanos` | `long` | N/A | Le décalage de nanosecondes par rapport à. `timeInSeconds` |
| `quality` | `string` | N/A | Qualité de la valeur de la série chronologique. |
| `doubleValue` | `double` ou `null` | `null` | Données de séries chronologiques de type double (nombre à virgule flottante). |
| `stringValue` | `string` ou `null` | `null` | Données de séries chronologiques de type chaîne (séquence de caractères). |
| `integerValue` | `int` ou `null` | `null` | Données de séries chronologiques de type entier (nombre entier). |
| `booleanValue` | `boolean` ou `null` | `null` | Données de séries chronologiques de type booléen (vrai ou faux). |
| `jsonValue` | `string` ou `null` | `null` | Données de séries chronologiques de type JSON (types de données complexes stockés sous forme de chaîne). |
| `recordVersion` | `long` ou `null` | `null` | Le numéro de version de l'enregistrement. Vous pouvez utiliser le numéro de version pour sélectionner le dernier enregistrement. Les nouveaux enregistrements ont des numéros de version plus grands. |
**Example données brutes dans la couche froide**
```
{"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étriques, transformations et agrégats
AWS IoT SiteWise exporte les métriques, les transformations et les agrège vers le niveau froid une fois toutes les six heures. Les métriques, les transformations et les agrégats sont enregistrés dans le niveau froid au format [Apache AVRO](https://avro.apache.org) (`.avro`).
### Chemin d'accès du fichier
AWS IoT SiteWise stocke les métriques, les transformations et les agrégats dans le niveau froid à l'aide du modèle suivant.
```
{keyPrefix}/agg/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/agg_{timeseriesId}_{startTimestamp}_{quality}.avro
```
Chaque chemin de fichier vers les métriques, les transformations et les agrégats dans Amazon S3 contient les composants suivants.
#### Chemin d'accès du fichier
| Composant Path | Description |
| --- | --- |
| `keyPrefix` | Le préfixe Amazon S3 que vous avez spécifié dans la configuration AWS IoT SiteWise de stockage. Amazon S3 utilise le préfixe comme nom de dossier dans le compartiment. |
| `agg` | Le dossier qui stocke les données de séries chronologiques issues des métriques. Le `agg` dossier est enregistré dans le dossier des préfixes. |
| `seriesBucket` | Nombre hexadécimal compris entre 00 et ff. Ce numéro est dérivé de`timeSeriesId`. Cette partition est utilisée pour augmenter le débit lors des AWS IoT SiteWise écritures sur le niveau froid. Lorsque vous utilisez Amazon Athena pour exécuter des requêtes, vous pouvez utiliser la partition pour un partitionnement précis afin d'améliorer les performances des requêtes. `seriesBucket`et `timeSeriesBucket` dans les métadonnées des actifs figurent le même numéro. |
| `startYear` | Année de début exclusive associée aux données de la série chronologique. |
| `startMonth` | Le mois de l'heure de début exclusive associée aux données de la série chronologique. |
| `startDay` | Le jour du mois de l'heure de début exclusive associée aux données de la série chronologique. |
| `fileName` | Le nom du fichier utilise le trait de soulignement (\$1) comme séparateur pour séparer les éléments suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/file-path-and-schema.html) Le fichier est enregistré au `.avro` format à l'aide de la compression [Snappy](https://github.com/google/snappy). |
**Example chemin du fichier vers les métriques dans le niveau froid**
`keyPrefix/agg/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/agg_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`
### Champs
Le schéma des métriques, des transformations et des agrégats exportés vers le niveau froid contient les champs suivants.
#### Champs
| Nom de champ | Types pris en charge | Type par défaut | Description |
| --- | --- | --- | --- |
| `seriesId` | `string` | N/A | ID identifiant les séries chronologiques issues de l'équipement, des métriques ou des transformations. Vous pouvez utiliser ce champ pour joindre des données brutes et des métadonnées d'actifs dans des requêtes. |
| `timeInSeconds` | `long` | N/A | Date d'horodatage, en secondes, au format Unix Epoch. Les données de nanosecondes fractionnaires sont fournies par. `offsetInNanos` |
| `offsetInNanos` | `long` | N/A | Le décalage de nanosecondes par rapport à. `timeInSeconds` |
| `quality` | `string` | N/A | La qualité selon laquelle les données relatives aux actifs doivent être filtrées. |
| `resolution` | `string` | N/A | Intervalle de temps pendant lequel les données doivent être agrégées. |
| `count` | `double` ou `null` | `null` | Le nombre total de points de données pour les variables données sur l'intervalle de temps actuel. |
| `average` | `double` ou `null` | `null` | La moyenne des valeurs des variables données sur l'intervalle de temps actuel. |
| `min` | `double` ou `null` | `null` | Le minimum des valeurs des variables données sur l'intervalle de temps actuel. |
| `max` | `boolean` ou `null` | `null` | Le maximum des valeurs des variables données sur l'intervalle de temps actuel. |
| `sum` | `string` ou `null` | `null` | Somme des valeurs des variables données sur l'intervalle de temps actuel. |
| `recordVersion` | `long` ou `null` | `null` | Le numéro de version de l'enregistrement. Vous pouvez utiliser le numéro de version pour sélectionner le dernier enregistrement. Les nouveaux enregistrements ont des numéros de version plus grands. |
**Example Données métriques dans la couche froide**
```
{"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}
```
## Métadonnées des actifs
Lorsque vous activez l'exportation de données AWS IoT SiteWise vers le niveau froid pour la première fois, les métadonnées des actifs sont exportées vers le niveau froid. Après la configuration initiale, AWS IoT SiteWise exporte les métadonnées des actifs vers le niveau uniquement lorsque vous modifiez les définitions des modèles d'actifs ou les définitions des actifs. Les métadonnées des actifs sont enregistrées dans le niveau froid au format JSON (`.ndjson`) délimité par une nouvelle ligne.
### Chemin d'accès du fichier
AWS IoT SiteWise stocke les métadonnées des actifs dans le niveau froid à l'aide du modèle suivant.
```
{keyPrefix}/asset_metadata/asset_{assetId}.ndjson
```
Chaque chemin de fichier vers les métadonnées des actifs du niveau froid contient les composants suivants.
#### Chemin d'accès du fichier
| Composant Path | Description |
| --- | --- |
| `keyPrefix` | Le préfixe Amazon S3 que vous avez spécifié dans la configuration de stockage AWS IoT SiteWise s. Amazon S3 utilise le préfixe comme nom de dossier dans le compartiment. |
| `asset_metadata` | Le dossier qui stocke les métadonnées des actifs. Le `asset_metadata` dossier est enregistré dans le dossier des préfixes. |
| `fileName` | Le nom du fichier utilise le trait de soulignement (\$1) comme séparateur pour séparer les éléments suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/file-path-and-schema.html) Le fichier est enregistré au `.ndjson` format. |
**Example chemin du fichier vers les métadonnées des actifs dans le niveau le plus froid**
`keyPrefix/asset_metadata/asset_35901915-d476-4dca-8637-d9ed4df939ed.ndjson`
### Champs
Le schéma des métadonnées des actifs exportées vers le niveau froid contient les champs suivants.
#### Champs
| Nom de champ | Description |
| --- | --- |
| `assetId` | ID de la ressource . |
| `assetName` | Le nom de l'actif. |
| `assetExternalId` | L'ID externe de la ressource. |
| `assetModelId` | ID du modèle d'actif utilisé pour créer cet actif. |
| `assetModelName` | Nom du modèle d'actif. |
| `assetModelExternalId` | ID externe du modèle d'actif. |
| `assetPropertyId` | ID de la propriété de ressource. |
| `assetPropertyName` | Nom de la propriété de l'actif. |
| `assetPropertyExternalId` | ID externe de la propriété de l'actif. |
| `assetPropertyDataType` | Type de données de la propriété de l'actif. |
| `assetPropertyUnit` | Unité de la propriété de l'actif (par exemple, `Newtons` et`RPM`). |
| `assetPropertyAlias` | Alias qui identifie la propriété de l'actif, tel que le chemin de flux de données d'un serveur OPC UA (par exemple,`/company/windfarm/3/turbine/7/temperature`). |
| `timeSeriesId` | ID identifiant les séries chronologiques issues de l'équipement, des métriques ou des transformations. Vous pouvez utiliser ce champ pour joindre des données brutes et des métadonnées d'actifs dans des requêtes. |
| `timeSeriesBucket` | Nombre hexadécimal compris entre 00 et ff. Ce numéro est dérivé de`timeSeriesId`. Cette partition est utilisée pour augmenter le débit lors des AWS IoT SiteWise écritures sur le niveau froid. Lorsque vous utilisez Amazon Athena pour exécuter des requêtes, vous pouvez utiliser la partition pour un partitionnement précis afin d'améliorer les performances des requêtes. `timeSeriesBucket`et `seriesBucket` le chemin du fichier vers les données brutes contient le même numéro. |
| `assetCompositeModelId` | ID du modèle composite. |
| `assetCompositeModelExternalId` | ID externe du modèle composite. |
| `assetCompositeModelDescription` | Description du modèle composite. |
| `assetCompositeModelName` | Nom du modèle composite. |
| `assetCompositeModelType` | Type du modèle composite. Pour les modèles composites d'alarme, ce type est `AWS/ALARM`. |
| `assetCreationDate` | Date de création de la ressource, à l'époque Unix. |
| `assetLastUpdateDate` | Date à laquelle la ressource a été mise à jour pour la dernière fois, à l'époque Unix. |
| `assetStatusErrorCode` | Code de l’erreur. |
| `assetStatusErrorMessage` | Message d’erreur. |
| `assetStatusState` | État actuel de l'actif. |
**Example métadonnées des actifs dans le niveau froid**
```
{"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"}
```
## Métadonnées de hiérarchie des actifs
Lorsque vous activez AWS IoT SiteWise l'enregistrement des données dans le niveau froid pour la première fois, les métadonnées de la hiérarchie des actifs sont exportées vers le niveau froid. Après la configuration initiale, AWS IoT SiteWise exporte les métadonnées de la hiérarchie des actifs vers le niveau froid uniquement lorsque vous modifiez le modèle d'actif ou les définitions des actifs. Les métadonnées de la hiérarchie des actifs sont enregistrées dans le niveau froid au format JSON (`.ndjson`) délimité par une nouvelle ligne.
Un identifiant externe pour la hiérarchie, la ressource cible ou la ressource source est récupéré en appelant l'[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)API.
### Chemin d'accès du fichier
AWS IoT SiteWise stocke les métadonnées de la hiérarchie des actifs dans le niveau froid à l'aide du modèle suivant.
```
{keyPrefix}/asset_hierarchy_metadata/{parentAssetId}_{hierarchyId}.ndjson
```
Chaque chemin de fichier vers les métadonnées de la hiérarchie des actifs dans le niveau froid contient les composants suivants.
#### Chemin d'accès du fichier
| Composant Path | Description |
| --- | --- |
| `keyPrefix` | Le préfixe Amazon S3 que vous avez spécifié dans la configuration AWS IoT SiteWise de stockage. Amazon S3 utilise le préfixe comme nom de dossier dans le compartiment. |
| `asset_hierarchy_metadata` | Le dossier qui stocke les métadonnées de la hiérarchie des actifs. Le `asset_hierarchy_metadata` dossier est enregistré dans le dossier des préfixes. |
| `fileName` | Le nom du fichier utilise le trait de soulignement (\$1) comme séparateur pour séparer les éléments suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/file-path-and-schema.html) Le fichier est enregistré au `.ndjson` format. |
**Example chemin du fichier vers les métadonnées de la hiérarchie des actifs dans le niveau froid**
`keyPrefix/asset_hierarchy_metadata/35901915-d476-4dca-8637-d9ed4df939ed_c5b3ced8-589a-48c7-9998-cdccfc9747a0.ndjson`
### Champs
Le schéma des métadonnées de hiérarchie des actifs exportées vers le niveau froid contient les champs suivants.
#### Champs
| Nom de champ | Description |
| --- | --- |
| `sourceAssetId` | L'ID de l'actif source dans cette relation d'actif. |
| `targetAssetId` | L'ID de l'actif cible dans cette relation d'actif. |
| `hierarchyId` | ID de la hiérarchie. |
| `associationType` | Type d'association de cette relation patrimoniale. La valeur doit être `CHILD`. L'actif cible est un actif enfant de l'actif source. |
**Example métadonnées de hiérarchie des actifs dans le niveau froid**
```
{"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"}
```
**Pour consulter vos données en mode froid**
1. Accédez à la [console Amazon S3](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation, choisissez **Buckets**, puis choisissez votre compartiment Amazon S3.
1. Accédez au dossier contenant les données brutes, les métadonnées des actifs ou les métadonnées de la hiérarchie des actifs.
1. Sélectionnez les fichiers, puis dans **Actions**, choisissez **Télécharger**.
## Fichiers d'index des données de stockage
AWS IoT SiteWise utilise ces fichiers pour optimiser les performances des requêtes de données. Ils apparaissent dans votre compartiment Amazon S3, mais vous n'avez pas besoin de les utiliser.
### Chemin d'accès du fichier
AWS IoT SiteWise stocke les fichiers d'index de données dans le niveau froid en utilisant le modèle suivant.
```
keyPrefix/index/series=timeseriesId/startYear=startYear/startMonth=startMonth/startDay=startDay/index_timeseriesId_startTimestamp_quality
```
**Example chemin du fichier vers le fichier d'index de stockage des données**
`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`