Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Aggiungi una destinazione AWS IoT SiteWise con buffer utilizzando Amazon S3 Il tipo di destinazione memorizzata nel buffer consente di risparmiare sui costi di importazione AWS IoT SiteWise se non sono necessari i dati in tempo reale. Consente di archiviare temporaneamente i dati IoT in un bucket Amazon S3 prima di importarli. AWS IoT SiteWise In alternativa, puoi semplicemente caricare i tuoi dati su S3 per l'archiviazione, indipendentemente dal fatto che tu abbia intenzione di importarli in. AWS IoT SiteWise Ciò è utile per raggruppare e memorizzare i dati dai dispositivi e dai gateway prima di inserirli. AWS IoT SiteWise Con questa opzione, i dati vengono caricati nel bucket S3 specificato in formato Parquet a una frequenza configurata. È quindi possibile importare questi dati in un AWS IoT SiteWise archivio per ulteriori analisi ed elaborazioni. **Per aggiungere una destinazione bufferizzata utilizzando Amazon S3** Usa la AWS IoT SiteWise console o AWS CLI aggiungi una destinazione che bufferizza i dati utilizzando Amazon S3 al SiteWise tuo gateway Edge. ------ #### [ Console ] Usa Console di gestione AWS per aggiungere una AWS IoT SiteWise destinazione bufferizzata utilizzando Amazon S3. 1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/). 1. Nel riquadro di navigazione, scegli **Edge** gateway. 1. Seleziona il gateway a cui desideri aggiungere una destinazione. 1. Nella sezione **Destinazioni**, scegli **Aggiungi destinazione**. 1. Nella pagina **Aggiungi destinazione**, inserisci **i dettagli della destinazione**: 1. Un nome per la destinazione nel campo **Nome destinazione**. 1. Seleziona **AWS IoT SiteWise bufferizzato utilizzando Amazon** S3 **per** il tipo di destinazione. AWS IoT SiteWise memorizzato nel buffer con Amazon S3 invia i dati ad Amazon Simple Storage Service in batch, in formato Parquet, quindi li importa nello storage. AWS IoT SiteWise 1. Inserisci l'URL di Amazon S3 per la posizione in cui desideri archiviare i dati del gateway. Puoi cercare il percorso scegliendo **Browse S3**. **Una volta aggiunto un bucket, puoi anche visualizzarlo scegliendo Visualizza.** 1. Specificate la frequenza con cui il gateway deve caricare i dati su Amazon S3 inserendo un intervallo di tempo e selezionando un incremento di tempo per la frequenza di caricamento **dei dati**. Il valore della frequenza deve essere maggiore di 0 e minore o uguale a 30 giorni. 1. Nelle **impostazioni di archiviazione dei dati**, stabilisci cosa fare con i dati del gateway dopo averli importati in AWS IoT SiteWise. Esistono due decisioni da prendere in merito all'archiviazione dei dati: + Se desideri copiare i dati importati nell' AWS IoT SiteWise archivio, seleziona la casella di controllo **Copia i dati nell'archivio**. Questa opzione duplica i dati importati dal AWS IoT SiteWise bucket Amazon S3 configurato nello storage. + Se scegli di importare i dati dal tuo bucket Amazon S3 nello AWS IoT SiteWise storage, puoi anche specificare se i dati importati devono essere eliminati una volta completata l'importazione. Seleziona la casella di controllo **Elimina dati da Amazon S3** per eliminare la data importata dal bucket Amazon S3 configurato dopo averla importata nello storage. AWS IoT SiteWise 1. Aggiungi filtri di percorso alla tua destinazione. Per ulteriori informazioni, consultare [Aggiungi filtri di percorso alle destinazioni AWS IoT SiteWise Edge](destinations-add-path-filters.md). ------ #### [ AWS CLI ] **Example : creazione di una nuova AWS IoT SiteWise destinazione con buffer utilizzando Amazon S3** Utilizza l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API per configurare l'editore. Imposta il parametro `capabilityNamespace` su `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 : aggiorna una AWS IoT SiteWise destinazione con buffer utilizzando Amazon S3** Per aggiornare una destinazione esistente AWS IoT SiteWise in tempo reale, utilizza innanzitutto l'`DescribeGatewayCapabilityConfiguration`API per trovare la. `destinationId` Lo spazio dei nomi dell'editore: `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": [ "#" ] } } ] } ] } ``` Le seguenti opzioni di configurazione sono specifiche per i gateway abilitati per MQTT che utilizzano lo spazio dei nomi. `iotsitewise:publisher:3` `sources` Definisce le fonti di dati a cui trasferire i dati dalle apparecchiature industriali. AWS IoT SiteWise Per i gateway compatibili con MQTT, utilizzare. `MQTT` Tipo: matrice di oggetti Obbligatorio: sì `destinations` Definisce dove inviare i dati. Le destinazioni sono in tempo reale o memorizzate nel buffer utilizzando Amazon S3. È richiesto almeno un oggetto di destinazione, ma puoi aggiungere un array vuoto. È possibile avere una destinazione in tempo reale per ogni gateway. Per ulteriori informazioni, consulta [Comprendi le destinazioni Edge AWS IoT SiteWise](gw-destinations.md#source-destination). Tipo: matrice di oggetti Obbligatorio: sì `id` L'identificatore univoco della destinazione. Puoi fornire un ID di destinazione esistente o lasciarlo vuoto per generare automaticamente un nuovo ID per la destinazione. ▬Tipo: stringa Obbligatorio: no `type` Tipo di destinazione. Le opzioni includono: `SITEWISE_REALTIME` e`SITEWISE_BUFFERED`. Scegli `SITEWISE_BUFFERED`. + `SITEWISE_REALTIME`(impostazione predefinita): invia i dati direttamente allo AWS IoT SiteWise storage in tempo reale. Per ulteriori informazioni, consulta [Aggiungi una AWS IoT SiteWise destinazione Edge in tempo reale](destinations-real-time.md). + `SITEWISE_BUFFERED`— Invia dati ad Amazon S3 in batch in formato Parquet, quindi importali nello storage. AWS IoT SiteWise Tipo: stringa Obbligatorio: sì `name` Un nome univoco per la destinazione. Tipo: stringa Obbligatorio: sì `config` Configurazione specifica per il tipo di destinazione in formato JSON. La configurazione varia tra destinazioni in tempo reale e destinazioni con buffer. Tipo: oggetto Obbligatorio: sì `targetBucketArn` Il bucket in ARN cui pubblicare. Scegli lo stesso Regione AWS per entrambi AWS IoT SiteWise e per Amazon S3. Se viene scelto un prefisso, deve avere tra 1 e 255 caratteri. AWS IoT SiteWise, incluso il gateway, avrà accesso all'intero bucket S3 specificato. Ti consigliamo di utilizzare un bucket dedicato per l'inserimento di dati nel buffer. Tipo: stringa Obbligatorio: sì `publishPolicy` Dettagli della politica di pubblicazione. Tipo: oggetto Obbligatorio: sì `publishFrequency` La frequenza con cui il gateway SiteWise Edge pubblica nel bucket Amazon S3. La frequenza di caricamento dei dati su Amazon S3 deve essere superiore a 0 minuti e inferiore o uguale a 30 giorni. È possibile utilizzare `m``h`, e `d` quando si specifica una frequenza di pubblicazione. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni. Il valore predefinito è 15 minuti. Tipo: stringa Obbligatorio: sì `localSizeLimitGB` La dimensione massima dei file scritti sul disco locale in GB. Se questa soglia viene superata, l'editore pubblica tutti i dati memorizzati nel buffer nella relativa destinazione. Tipo: numero intero Obbligatorio: sì `siteWiseImportPolicy` Dettagli della politica di importazione per l'importazione dei dati in. AWS IoT SiteWise Tipo: oggetto Obbligatorio: sì `enableSiteWiseStorageImport` Imposta questa opzione `true` su per importare i dati da un bucket Amazon S3 allo storage. AWS IoT SiteWise Inizialmente crea una copia dei dati in. AWS IoT SiteWise Quindi, se imposti su `enableDeleteAfterImport` true, i dati in S3 vengono eliminati dopo la copia su. AWS IoT SiteWise Si applicano le implicazioni relative ai prezzi. Il valore predefinito è `true`. Tipo: Booleano Obbligatorio: sì `enableDeleteAfterImport` Imposta questa opzione `true` su per eliminare il file nel bucket Amazon S3 dopo l'ingestione nello storage. AWS IoT SiteWise Il valore predefinito è `true`. Tipo: Booleano Obbligatorio: sì `bulkImportJobRoleArn` L'ARN del ruolo IAM che AWS IoT SiteWise presuppone la lettura dei dati bufferizzati da Amazon S3 durante l'ingestione dei dati. Questo ruolo viene utilizzato quando un dispositivo periferico chiama per avviare il processo di importazione in blocco AWS IoT SiteWise APIs . Se `enableSiteWiseStorageImport` impostato su`true`, questo parametro è obbligatorio. ▬Tipo: stringa Obbligatorio: no ------ Aggiungi filtri di percorso per la tua destinazione. Per ulteriori informazioni, consulta [Aggiungi filtri di percorso alle destinazioni AWS IoT SiteWise Edge](destinations-add-path-filters.md).