Pubblica aggiornamenti dei valori delle proprietà su Amazon DynamoDB

Questo tutorial introduce un modo pratico per archiviare i dati utilizzando Amazon 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

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.

Prerequisiti

Per completare questo tutorial, è necessario quanto segue:

• Un AWS account. Se non lo hai, consultare Configura un account AWS.

• Un computer di sviluppo che esegue Windows, macOS, Linux o Unix per accedere a. AWS Management Console Per ulteriori informazioni, vedi Cos'è il? AWS Management Console

• Un utente IAM con autorizzazioni da amministratore. Per istruzioni dettagliate, vedi Come AWS IoT SiteWise funziona con IAM.

• Una demo di un AWS IoT SiteWise parco eolico funzionante. Quando configuri la demo, definisce i modelli e gli asset AWS IoT SiteWise e trasmette loro i dati per rappresentare un parco eolico. Per ulteriori informazioni, consulta Usa la AWS IoT SiteWise demo.

Fase 1: Configurazione AWS IoT SiteWise per la pubblicazione degli 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 AWS IoT SiteWise console .

2. Controlla gli AWS IoT SiteWise endpoint e le quote dove AWS IoT SiteWise è supportato e cambia AWS regione, se necessario. Passa a una regione in cui stai eseguendo la AWS IoT SiteWise demo.

3. Nel riquadro di navigazione a sinistra, scegli Asset.

4. Scegliere la freccia accanto a Demo Wind Farm Asset per espandere la gerarchia dell'asset della centrale eolica.

5. Scegli una turbina demo e seleziona Modifica.

6. Scegliere Measurements (Misurazioni).

7. Aggiorna lo stato di notifica MQTT della Wind Speedproprietà su ATTIVO.

8. Scegli Save (Salva) nella parte inferiore della pagina.

9. Ripetere i passaggi da 5 a 7 per ogni risorsa della turbina demo.

10. Scegliere una turbina demo (ad esempio, Demo Turbine Asset 1).

11. Scegliere Measurements (Misurazioni).

12. 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.

2. Nel riquadro di navigazione a sinistra, scegli Routing dei messaggi, quindi scegli Regole.

3. Scegli Crea regola.

4. In Specificare le proprietà della regola, inserisci un nome e una descrizione per la regola.

5. 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 dopoassets/) 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

6. 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'

7. In Azioni relative alle regole, vai all'Azione 1.

8. Nella pagina Seleziona un'azione, scegli Dynamo DBv2. Questo divide il messaggio in più colonne di una tabella DynamoDB

9. In Nome tabella, scegli Crea nuova tabella. Crei una tabella Amazon DynamoDB per ricevere i dati sulla velocità del vento dall'azione della regola.

10. In Nome tabella nella console DynamoDB, inserisci un nome per la tabella.

11. Per la chiave di partizione, procedi come segue:

    1. Inserisci timestamp come chiave di partizione.

    2. Scegli il tipo Numero.

    3. Selezionare la casella di controlloAggiungi chiave di ordinamento).

    4. Immettere asset come chiave di ordinamento e lasciare il tipo di chiave di ordinamento predefinito String.

12. Scegliere Create table (Crea tabella).

13. Tornare alla scheda con la pagina Configura azione.

14. 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.

2. Inserisci il nome di un ruolo, WindSpeedDataRole ad esempio. Scegliere Crea ruolo.

3. Scegli Next (Successivo).

4. 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.

2. 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).

3. In una riga nella tabella, scegliere l'icona di modifica per espandere i dati.

4. 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.

Ora che hai completato il tutorial, disabilita o elimina la regola ed elimina la tabella DynamoDB per evitare di incorrere in costi aggiuntivi. Per ripulire le risorse, consulta. Passaggio 5: Pulisci le risorse dopo il tutorial

Passaggio 5: Pulisci le risorse dopo il tutorial

Dopo aver completato questo tutorial, puoi pulire le risorse per evitare di incorrere in costi aggiuntivi. Gli asset dimostrativi del parco eolico vengono eliminati al termine della durata scelta al momento della creazione della demo. Puoi anche eliminare la demo manualmente.

La AWS IoT SiteWise demo si elimina automaticamente dopo una settimana o dopo il numero di giorni che hai scelto se hai creato lo stack demo dalla AWS CloudFormation console. Puoi eliminare la demo prima se hai finito di utilizzare le risorse della demo. Inoltre puoi eliminare la demo se la demo non viene creata. Attieniti alla seguente procedura per eliminare manualmente la demo.

(opzionale) Per eliminare la AWS IoT SiteWise demo

1. Passare alla console AWS CloudFormation.

2. Scegli Io TSite WiseDemoAssets dall'elenco degli Stack.

3. Scegliere Delete (Elimina).

   Quando si elimina lo stack, tutte le risorse create per la demo vengono eliminate.

4. Nella finestra di dialogo di conferma scegliere Delete stack (Elimina stack).

   L'eliminazione dello stack richiede circa 15 minuti. Se la demo non riuscisse a finalizzare l'eliminazione, seleziona nuovamente Delete (Elimina) nell'angolo in alto a destra. Se la demo non riesce a eliminare nuovamente, segui i passaggi nella AWS CloudFormation console per saltare le risorse che non sono state eliminate e riprova.

Per ulteriori informazioni, consulta Eliminare la AWS IoT SiteWise 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.

2. Nel riquadro di navigazione a sinistra, scegli Asset.

3. Scegliere la freccia accanto a Demo Wind Farm Asset per espandere la gerarchia dell'asset della centrale eolica.

4. Scegli una turbina demo e seleziona Modifica.

5. Aggiorna lo stato di notifica della Wind Speedproprietà su INACTIVE.

6. Scegli Salva risorsa nella parte inferiore della pagina.

7. 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.

2. Nel riquadro di navigazione a sinistra, scegli Routing dei messaggi, quindi scegli Regole.

3. Seleziona la tua regola e scegli Elimina.

4. Nella finestra di dialogo di conferma, inserisci il nome della regola, quindi scegli Elimina.

Per eliminare una tabella DynamoDB

1. Accedere alla console DynamoDB.

2. Nel riquadro di navigazione a sinistra, selezionare Tables (Tabelle).

3. Scegli la tabella che hai creato in precedenza, ad esempio. WindSpeedData

4. Scegliere Delete (Elimina).

5. Nella finestra di dialogo di conferma, immettete confirm per eliminare la tabella.