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. # Ajouter une destination AWS IoT SiteWise mise en mémoire tampon à l'aide d'Amazon S3 Le type de destination mise en mémoire tampon vous permet de réduire les coûts d'ingestion AWS IoT SiteWise si vous n'avez pas besoin des données en temps réel. Il vous permet de stocker temporairement vos données IoT dans un compartiment Amazon S3 avant de les importer dans AWS IoT SiteWise. Vous pouvez également simplement télécharger vos données dans S3 pour les stocker, que vous envisagiez de les importer ou non AWS IoT SiteWise. Cela est utile pour regrouper et mettre en mémoire tampon les données de vos appareils et de vos passerelles avant de les ingérer. AWS IoT SiteWise Avec cette option, les données sont téléchargées dans le compartiment S3 spécifié au format Parquet à une fréquence configurée. Vous pouvez ensuite importer ces données dans le AWS IoT SiteWise stockage pour une analyse et un traitement plus approfondis. **Pour ajouter une destination mise en mémoire tampon à l'aide d'Amazon S3** Utilisez la AWS IoT SiteWise console ou AWS CLI pour ajouter une destination qui met en mémoire tampon les données à l'aide d'Amazon S3 sur votre passerelle SiteWise Edge. ------ #### [ Console ] Utilisez le AWS Management Console pour ajouter une AWS IoT SiteWise destination mise en mémoire tampon à l'aide d'Amazon S3. 1. Ouvrez la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/). 1. Dans le volet de navigation, choisissez **Edge gateways**. 1. Sélectionnez la passerelle à laquelle vous souhaitez ajouter une destination. 1. Dans la section **Destinations**, choisissez **Ajouter une destination**. 1. Sur la page **Ajouter une destination**, entrez les **détails de la destination** : 1. Le nom de votre destination dans le champ **Nom de la destination**. 1. Sélectionnez le **AWS IoT SiteWise type de **destination** mis en mémoire tampon à l'aide d'Amazon S3**. AWS IoT SiteWise mis en mémoire tampon à l'aide d'Amazon S3 envoie des données à Amazon Simple Storage Service par lots, au format Parquet, puis les importe dans AWS IoT SiteWise le stockage. 1. Entrez l'URL Amazon S3 correspondant à l'emplacement où vous souhaitez stocker les données de votre passerelle. Vous pouvez rechercher le chemin en choisissant **Parcourir S3**. Une fois qu'un bucket est ajouté, vous pouvez également le consulter en choisissant **View**. 1. Spécifiez la fréquence à laquelle votre passerelle doit télécharger des données vers Amazon S3 en saisissant un intervalle de temps et en sélectionnant un intervalle de temps pour la **fréquence de téléchargement des données**. La valeur de fréquence doit être supérieure à 0 et inférieure ou égale à 30 jours. 1. Dans **Paramètres de stockage des données**, déterminez ce que vous devez faire avec les données de votre passerelle après les avoir importées dans AWS IoT SiteWise. Il y a deux décisions à prendre concernant le stockage des données : + Si vous souhaitez copier les données importées dans le AWS IoT SiteWise stockage, cochez la case **Copier les données dans le stockage**. Cette option duplique les données importées depuis votre compartiment Amazon S3 configuré vers AWS IoT SiteWise le stockage. + Si vous choisissez d'importer vos données depuis votre compartiment Amazon S3 vers le AWS IoT SiteWise stockage, vous pouvez également spécifier si les données importées doivent être supprimées une fois l'importation terminée. Cochez la case **Supprimer les données d'Amazon S3** pour supprimer la date importée du compartiment Amazon S3 configuré après l'avoir importée dans le AWS IoT SiteWise stockage. 1. Ajoutez des filtres de chemin à votre destination. Pour plus d'informations, voir,[Ajouter des filtres de chemin aux destinations AWS IoT SiteWise Edge](destinations-add-path-filters.md). ------ #### [ AWS CLI ] **Example : Création d'une nouvelle AWS IoT SiteWise destination mise en mémoire tampon à l'aide d'Amazon S3** Utilisez l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API pour configurer l'éditeur. Définissez le paramètre `capabilityNamespace` sur `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "type": "SITEWISE_BUFFERED", "name": "your-s3-destination-name", "config": { "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder", "publishPolicy": { "publishFrequency": "15m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true, "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name" } }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` **Example : Mettre à jour une AWS IoT SiteWise destination mise en mémoire tampon à l'aide d'Amazon S3** Pour mettre à jour une destination AWS IoT SiteWise en temps réel existante, utilisez d'abord l'`DescribeGatewayCapabilityConfiguration`API pour trouver le`destinationId`. L'espace de noms de l'éditeur : `iotsitewise:publisher:3` ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "id": "your-existing-destination-id", "type": "SITEWISE_BUFFERED", "name": "your-s3-destination-name", "config": { "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder", "publishPolicy": { "publishFrequency": "15m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true, "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name" } }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Les options de configuration suivantes sont spécifiques aux passerelles compatibles MQTT utilisant l'espace de noms. `iotsitewise:publisher:3` `sources` Définit les sources de données vers lesquelles transférer les données de votre équipement industriel AWS IoT SiteWise. Pour les passerelles compatibles MQTT, utilisez. `MQTT` Type : tableau d’objets Obligatoire : oui `destinations` Définit où envoyer les données. Les destinations sont soit en temps réel, soit mises en mémoire tampon à l'aide d'Amazon S3. Au moins un objet de destination est requis, mais vous pouvez ajouter un tableau vide. Vous pouvez avoir une destination en temps réel pour chaque passerelle. Pour de plus amples informations, veuillez consulter [Comprendre les destinations AWS IoT SiteWise Edge](gw-destinations.md#source-destination). Type : tableau d’objets Obligatoire : oui `id` Identifiant unique de la destination. Vous pouvez soit fournir un identifiant de destination existant, soit le laisser vide pour qu'un nouvel identifiant soit automatiquement généré pour la destination. Type : chaîne Obligatoire : non `type` Type de destination. Les options incluent : `SITEWISE_REALTIME` et`SITEWISE_BUFFERED`. Sélectionnez `SITEWISE_BUFFERED`. + `SITEWISE_REALTIME`(par défaut) : envoyez les données directement au AWS IoT SiteWise stockage en temps réel. Pour de plus amples informations, veuillez consulter [Ajouter une destination AWS IoT SiteWise Edge en temps réel](destinations-real-time.md). + `SITEWISE_BUFFERED`— Envoyez des données à Amazon S3 par lots au format Parquet, puis importez-les dans le AWS IoT SiteWise stockage. Type : Chaîne Obligatoire : oui `name` Nom unique pour la destination. Type : Chaîne Obligatoire : oui `config` Configuration spécifique au type de destination au format JSON. La configuration varie entre les destinations en temps réel et les destinations mises en mémoire tampon. Type : objet Obligatoire : oui `targetBucketArn` Le compartiment ARN dans lequel publier. Choisissez la même option Région AWS pour les deux AWS IoT SiteWise et pour Amazon S3. Si un préfixe est choisi, il doit comporter entre 1 et 255 caractères. AWS IoT SiteWise, y compris la passerelle, auront accès à l'intégralité du compartiment S3 spécifié. Nous vous recommandons d'utiliser un bucket dédié pour l'ingestion de données en mémoire tampon. Type : Chaîne Obligatoire : oui `publishPolicy` Détails de la politique de publication. Type : objet Obligatoire : oui `publishFrequency` Fréquence à laquelle la passerelle SiteWise Edge publie dans le compartiment Amazon S3. La fréquence de chargement des données vers Amazon S3 doit être supérieure à 0 minute et inférieure ou égale à 30 jours. Vous pouvez utiliser `m``h`, et `d` quand vous spécifiez une fréquence de publication, un âge. Notez que cela `m` `h` représente les minutes, les heures et les `d` jours. La valeur par défaut est de 15 minutes. Type : Chaîne Obligatoire : oui `localSizeLimitGB` Taille maximale des fichiers écrits sur le disque local en Go. Si ce seuil est dépassé, l'éditeur publie toutes les données mises en mémoire tampon vers leur destination. Type : Integer Obligatoire : oui `siteWiseImportPolicy` Détails de la politique d'importation pour l'importation de données vers AWS IoT SiteWise. Type : objet Obligatoire : oui `enableSiteWiseStorageImport` Définissez ce paramètre sur `true` pour importer les données d'un compartiment Amazon S3 vers le AWS IoT SiteWise stockage. Il effectue initialement une copie des données dans AWS IoT SiteWise. Ensuite, si vous définissez `enableDeleteAfterImport` ce paramètre sur true, les données de S3 sont supprimées après avoir été copiées vers AWS IoT SiteWise. Les implications tarifaires s'appliquent. La valeur par défaut est `true`. Type : Boolean Obligatoire : oui `enableDeleteAfterImport` Définissez cette option `true` pour supprimer le fichier dans le compartiment Amazon S3 après son ingestion dans le AWS IoT SiteWise stockage. La valeur par défaut est `true`. Type : Boolean Obligatoire : oui `bulkImportJobRoleArn` L'ARN du rôle IAM qui AWS IoT SiteWise suppose de lire les données mises en mémoire tampon depuis Amazon S3 lors de l'ingestion des données. Ce rôle est utilisé lorsqu'un appareil Edge appelle AWS IoT SiteWise APIs pour lancer le processus d'importation en bloc. S'`enableSiteWiseStorageImport`il est défini sur`true`, ce paramètre est obligatoire. Type : chaîne Obligatoire : non ------ Ajoutez des filtres de chemin pour votre destination. Pour de plus amples informations, veuillez consulter [Ajouter des filtres de chemin aux destinations AWS IoT SiteWise Edge](destinations-add-path-filters.md).