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à.
# Pubblica aggiornamenti dei valori delle proprietà su Amazon DynamoDB
Questo tutorial introduce un modo pratico per archiviare i dati utilizzando [Amazon](https://aws.amazon.com/dynamodb/) DynamoDB, semplificando l'accesso ai dati storici degli asset senza dover interrogare ripetutamente l'API. AWS IoT SiteWise Dopo aver completato questo tutorial, puoi creare un software personalizzato che utilizza i dati degli asset, ad esempio una mappa in tempo reale della velocità e della direzione del vento su un intero parco eolico. Se desideri monitorare e visualizzare i tuoi dati senza implementare una soluzione software personalizzata, consulta. [Monitora i dati con AWS IoT SiteWise Monitor](monitor-data.md)
In questo tutorial, ti baserai sulla AWS IoT SiteWise demo che fornisce un set di dati di esempio per un parco eolico. Puoi configurare gli aggiornamenti dei valori delle proprietà dalla demo del parco eolico per inviare dati, tramite le regole AWS IoT Core, a una tabella DynamoDB che crei. Quando abiliti gli aggiornamenti dei valori delle proprietà, AWS IoT SiteWise invia i dati AWS IoT Core nei messaggi MQTT. Quindi, definisci le regole di AWS IoT base che eseguono azioni, come l'azione DynamoDB, a seconda del contenuto di tali messaggi. Per ulteriori informazioni, consulta [Interagisci con altri AWS servizi](interact-with-other-services.md).
**Topics**
+ [Prerequisiti](#dynamodb-tutorial-prerequisites)
+ [Fase 1: Configurare la pubblicazione degli AWS IoT SiteWise aggiornamenti dei valori delle proprietà](#dynamodb-tutorial-enable-value-notifications)
+ [Fase 2: Creare una regola in Core AWS IoT](#dynamodb-tutorial-create-iot-rule)
+ [Fase 3: Configurare l'azione della regola DynamoDB](#dynamodb-tutorial-configure-rule-action)
+ [Fase 4: Esplora i dati in DynamoDB](#dynamodb-tutorial-explore-dynamodb-data)
+ [Eseguire la pulizia delle risorse](#dynamodb-tutorial-clean-up-resources)
+ [Risorse aggiuntive](#dynamodb-tutorial-additional-resources)
## Prerequisiti
Per completare questo tutorial, è necessario quanto segue:
+ Un. Account AWS Se non lo hai, consultare [Configura un account AWS](getting-started.md#set-up-aws-account).
+ Un computer di sviluppo che esegue Windows, macOS, Linux o Unix per accedere a. Console di gestione AWS Per ulteriori informazioni, vedi [Cos'è il? Console di gestione AWS](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/what-is.html)
+ Un utente AWS Identity and Access Management (IAM) con autorizzazioni di amministratore. Per istruzioni dettagliate, vedi [Come AWS IoT SiteWise funziona con IAM](security_iam_service-with-iam.md).
+ Una AWS IoT SiteWise demo in esecuzione. Per ulteriori informazioni, consulta [Usa la AWS IoT SiteWise demo](getting-started-demo.md).
**Nota**
Questo tutorial richiede l'uso di risorse create in[Usa la AWS IoT SiteWise demo](getting-started-demo.md). È necessario completarlo prima di procedere con questo tutorial.
**Importante**
Conserva tutte le risorse dimostrative fino al completamento di questo tutorial. L'eliminazione di qualsiasi componente potrebbe compromettere la funzionalità della demo e influire sulla capacità di completare il tutorial.
## Fase 1: Configurare la pubblicazione degli AWS IoT SiteWise aggiornamenti dei valori delle proprietà
In questa procedura, è possibile abilitare le notifiche del valore della proprietà per le proprietà **Wind Speed** degli asset turbine della demo. Dopo aver abilitato le notifiche sui valori delle proprietà, AWS IoT SiteWise pubblica ogni aggiornamento dei valori in un messaggio MQTT su AWS IoT Core.
**Per abilitare le notifiche di aggiornamento del valore della proprietà sulle proprietà degli asset**
1. Accedi alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Controlla gli [AWS IoT SiteWise endpoint e le quote](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) dove AWS IoT SiteWise è supportato e cambia AWS regione, se necessario. Passa a una regione in cui stai eseguendo la AWS IoT SiteWise demo.
1. Nel riquadro di navigazione a sinistra, scegli **Asset**.
1. Scegliere la freccia accanto a **Demo Wind Farm Asset** per espandere la gerarchia dell'asset della centrale eolica.
1. Scegli una turbina demo e seleziona **Modifica**.
1. Scegliere **Measurements (Misurazioni)**.
1. Aggiorna lo **stato di notifica MQTT della **Wind Speed****proprietà su **ATTIVO**.
1. Scegli **Save** (Salva) nella parte inferiore della pagina.
1. Ripetere i passaggi da 5 a 7 per ogni risorsa della turbina demo.
1. Scegliere una turbina demo (ad esempio, **Demo Turbine Asset 1**).
1. Scegliere **Measurements (Misurazioni)**.
1. Scegliere l'icona di copia accanto alla proprietà **Wind Speed** per copiare l'argomento di notifica negli Appunti. Salvare l'argomento di notifica da utilizzare più avanti in questo tutorial. È sufficiente registrare l'argomento di notifica da una turbina.
L'argomento di notifica dovrebbe essere simile all'esempio seguente.
```
$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
## Fase 2: Creare una regola in Core AWS IoT
In questo passaggio, crea una regola in AWS IoT Core che analizzi i messaggi di notifica del valore della proprietà e inserisca i dati in una tabella Amazon DynamoDB. AWS IoT Le regole di base analizzano i messaggi MQTT ed eseguono azioni in base al contenuto e all'argomento di ciascun messaggio. Quindi, crei una regola con un'azione DynamoDB per inserire dati in una tabella DynamoDB che crei come parte di questo tutorial.
**Per creare una regola con un'azione DynamoDB**
1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot/).
1. **Nel riquadro di navigazione a sinistra, scegli **Routing dei messaggi**, quindi scegli Regole.**
1. Scegli **Crea regola**.
1. In **Specificare le proprietà della regola**, inserisci un nome e una descrizione per la regola.
1. Individuare l'argomento di notifica salvato in precedenza in questo tutorial.
```
$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
Sostituisci l'ID della risorsa (l'ID dopo`assets/`) nell'argomento con un`+`. Questo seleziona la proprietà della velocità del vento per tutte le turbine eoliche dimostrative. Il filtro dell’argomento `+` accetta tutti i nodi da un singolo livello in un argomento. L'argomento dovrebbe essere simile all'esempio seguente.
```
$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
1. Immettere la seguente istruzione di query per la regola. Sostituire l'argomento nella sezione `FROM` con l'argomento di notifica.
```
SELECT
payload.assetId AS asset,
(SELECT VALUE (value.doubleValue) FROM payload.values) AS windspeed,
timestamp() AS timestamp
FROM
'$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE'
WHERE
type = 'PropertyValueUpdate'
```
1. In **Azioni relative alle regole**, vai all'**Azione 1**.
1. Nella pagina **Seleziona un'azione**, scegli **Dynamo DBv2**. Questo divide il messaggio in più colonne di una tabella DynamoDB
1. In **Nome tabella**, scegli **Crea** nuova tabella. Crei una tabella Amazon DynamoDB per ricevere i dati sulla velocità del vento dall'azione della regola.
1. In **Nome tabella** nella console [DynamoDB](https://console.aws.amazon.com/dynamodb/), inserisci un nome per la tabella.
1. Per la **chiave di partizione, procedi** come segue:
1. Inserisci **timestamp** come chiave di partizione.
1. Scegli il tipo **Numero**.
1. Selezionare la casella di controllo**Aggiungi chiave di ordinamento)**.
1. Immettere **asset** come chiave di ordinamento e lasciare il tipo di chiave di ordinamento predefinito **String**.
1. Scegliere **Create table (Crea tabella)**.
1. Tornare alla scheda con la pagina **Configura azione**.
1. Nella pagina di **azione Allega regola**, aggiorna l'elenco dei **nomi delle tabelle** e scegli la nuova tabella DynamoDB creata nel passaggio precedente.
## Fase 3: Configurare l'azione della regola DynamoDB
In questo passaggio, configura l'azione della regola di Amazon DynamoDB per inserire i dati dagli aggiornamenti dei valori delle proprietà nella tua nuova tabella DynamoDB.
**Per configurare l'azione della regola DynamoDB**
1. Scegli **Crea ruolo** per creare un ruolo IAM che conceda l'accesso AWS IoT Core per eseguire l'azione della regola.
1. Inserisci il nome di un ruolo, `WindSpeedDataRole` ad esempio. Scegli **Crea ruolo**.
1. Scegli **Next (Successivo)**.
1. Scegli **Crea** nella parte inferiore della pagina per completare la creazione della regola.
I dati degli asset dimostrativi dovrebbero iniziare a comparire nella tabella DynamoDB.
## Fase 4: Esplora i dati in DynamoDB
In questa fase, esplora i dati sulla velocità del vento degli asset dimostrativi nella tua nuova tabella Amazon DynamoDB.
**Per esplorare i dati degli asset in DynamoDB**
1. Tornate alla scheda con la tabella DynamoDB aperta.
1. Nella tabella creata in precedenza, scegli la scheda **Esplora gli elementi della tabella** per visualizzare i dati contenuti nella tabella. Aggiorna la pagina se non vedi righe nella tabella. Se le righe non vengono visualizzate dopo alcuni minuti, consulta [Risoluzione dei problemi relativi a una regola (DynamoDB)](troubleshoot-rule.md#dynamodb-tutorial-troubleshoot-rule).
1. In una riga nella tabella, scegliere l'icona di modifica per espandere i dati.
1. Scegliere la freccia accanto alla struttura della **windspeed** per espandere l'elenco dei punti dati della velocità del vento. Ogni elenco riflette un batch di punti dati sulla velocità del vento inviati AWS IoT SiteWise dalla demo del parco eolico. Se si imposta un'azione regola per uso personale, è possibile che si desideri un formato di dati diverso. Per ulteriori informazioni, consulta [Interroga le notifiche relative alle proprietà degli asset in AWS IoT SiteWise](query-notification-messages.md).
Ora che hai completato il tutorial, puoi disabilitare o eliminare la regola ed eliminare la tabella DynamoDB per evitare di incorrere in costi aggiuntivi. Per ripulire le risorse, consulta. [Eseguire la pulizia delle risorse](#dynamodb-tutorial-clean-up-resources)
Puoi anche imparare a creare applicazioni personalizzate per utilizzare e visualizzare questi dati. Per un tutorial guidato sulla visualizzazione AWS IoT SiteWise dei dati, consulta. [Visualizza e condividi dati in Grafana](visualize-with-grafana.md)
## Eseguire la pulizia delle risorse
Dopo aver completato questo tutorial, puoi pulire le risorse per evitare di incorrere in costi aggiuntivi.
**Per eliminare la demo AWS IoT SiteWise **
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. **Nell'angolo in alto a destra della pagina, scegli Elimina demo.**
1. Nella finestra di dialogo di conferma immettere **DELETE** e quindi scegliere **Delete (Elimina)**.
Per ulteriori informazioni, consulta [Eliminare la AWS IoT SiteWise demo](getting-started-demo.md#delete-getting-started-demo).
Utilizza le seguenti procedure per disabilitare le notifiche di aggiornamento dei valori delle proprietà (se non hai eliminato la demo), disabilitare o eliminare la AWS IoT regola ed eliminare la tabella DynamoDB.
**Per disabilitare le notifiche di aggiornamento del valore della proprietà sulle proprietà degli asset**
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione a sinistra, scegli **Asset**.
1. Scegliere la freccia accanto a **Demo Wind Farm Asset** per espandere la gerarchia dell'asset della centrale eolica.
1. Scegli una turbina demo e seleziona **Modifica**.
1. **Aggiorna lo **stato di notifica** della **Wind Speed**proprietà su INACTIVE.**
1. Scegli **Salva risorsa** nella parte inferiore della pagina.
1. Ripetere i passaggi da 4 a 6 per ogni asset turbina demo.
**Per disabilitare o eliminare una regola in AWS IoT Core**
1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot/).
1. Nel riquadro di navigazione a sinistra, scegli **Routing dei messaggi**, quindi scegli **Regole**.
1. Seleziona la tua regola e scegli **Elimina**.
1. Nella finestra di dialogo di conferma, inserisci il nome della regola, quindi scegli Elimina.
**Per eliminare una tabella DynamoDB**
1. Accedere alla console [DynamoDB](https://console.aws.amazon.com/dynamodb/).
1. Nel riquadro di navigazione a sinistra, selezionare **Tables (Tabelle)**.
1. Scegli la tabella che hai creato in precedenza, ad esempio. `WindSpeedData`
1. Scegli **Elimina**.
1. Nella finestra di dialogo di conferma, immettete **confirm** per eliminare la tabella.
## Risorse aggiuntive
Per ulteriori informazioni sull'utilizzo di DynamoDB e sul monitoraggio dei dati, consulta le seguenti risorse:
+ [Monitoraggio delle metriche all'interno della CloudWatch ](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Monitoring-metrics-with-Amazon-CloudWatch.html) *DynamoDB* Developer Guide
+ [Le migliori pratiche per progettare e utilizzare in modo efficace le chiavi di partizione nella](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html) *DynamoDB* Developer Guide
+ [Regole contenute AWS IoT nella Guida per gli](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) *sviluppatori AWS IoT *
+ [Visualizza e condividi dati in Grafana](visualize-with-grafana.md)