Publicar actualizaciones de valor de propiedad en Amazon DynamoDB

En este tutorial, se presenta una forma práctica de almacenar los datos mediante Amazon DynamoDB, lo que facilita el acceso a los datos históricos de los activos sin tener que consultar repetidamente la API. AWS IoT SiteWise Después de completar este tutorial, puede crear software personalizado que consuma los datos de sus activos, como un mapa en vivo de la velocidad y la dirección del viento en todo un parque eólico. Si desea supervisar y visualizar los datos sin implementar una solución de software personalizada, consulte Supervise los datos con AWS IoT SiteWise Monitor.

En este tutorial, se basa en la AWS IoT SiteWise demostración que proporciona un conjunto de datos de muestra para un parque eólico. Puede configurar actualizaciones de valores de propiedad desde la demostración del parque eólico para enviar datos, a través de las reglas de AWS IoT Core, a una tabla de DynamoDB que cree. Cuando habilita las actualizaciones del valor de la propiedad, AWS IoT SiteWise envía sus datos a AWS IoT Core mensajes MQTT. A continuación, defina las reglas AWS IoT principales que realicen acciones, como la acción de DynamoDB, en función del contenido de esos mensajes. Para obtener más información, consulte Interactúa con otros AWS servicios.

Requisitos previos

Necesitará lo siguiente para completar este tutorial:

• Una AWS cuenta. Si no dispone de una, consulte Configura una AWS cuenta.

• Un ordenador de desarrollo que ejecute Windows, macOS, Linux o Unix para acceder al AWS Management Console. Para obtener más información, consulte ¿Qué es AWS Management Console?

• Un usuario de IAM con permisos de administrador.

• Una demostración de un AWS IoT SiteWise parque eólico en funcionamiento. Al configurar la demostración, esta define los modelos y los activos AWS IoT SiteWise y les transmite datos para representar un parque eólico. Para obtener más información, consulte Usa la AWS IoT SiteWise demo.

Paso 1: AWS IoT SiteWise Configúrelo para publicar las actualizaciones del valor de la propiedad

En este procedimiento, habilita las notificaciones del valor de las propiedades en los activos de su turbina de demostración Wind Speedpropiedades. Tras activar las notificaciones del valor de las propiedades, AWS IoT SiteWise publica cada actualización de valores en un mensaje MQTT en AWS IoT Core.

Para habilitar las notificaciones de actualización de valores de propiedad en propiedades de activos

1. Inicie sesión en la consola de AWS IoT SiteWise.

2. Revise los AWS IoT SiteWise puntos finales y las cuotas compatibles y cambie de AWS región si AWS IoT SiteWise es necesario. Cambie a la región en la que esté realizando la AWS IoT SiteWise demostración.

3. En el panel de navegación izquierdo, elija Assets (activos).

   

4. Selecciona la flecha situada junto a Demo Wind Farm Assetpara ampliar la jerarquía de los activos del parque eólico.

   

5. Elija una turbina de demostración y elija Edit (Editar).

   

6. Actualizar el Wind Speedel estado de notificación de la propiedad es ACTIVADO.

   

7. Elija Save asset (Guardar activo) en la parte inferior de la página.

8. Repita los pasos 5 a 7 para cada activo de turbina de demostración.

9. Elija una turbina de demostración (por ejemplo, Demo Turbine Asset 1).

10. Elija Measurements (Medidas).

11. Seleccione el icono de copia situado junto a Wind Speedpropiedad para copiar el tema de la notificación al portapapeles. Guarde el tema de notificación para utilizarlo más adelante en este tutorial. Solo necesita registrar el tema de notificación desde una turbina.

    

    El tema de notificación debe ser similar al siguiente ejemplo.

    $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE

Paso 2: creación de una regla en AWS IoT Core

En este procedimiento, se crea una regla en AWS IoT Core que analiza los mensajes de notificación del valor de la propiedad e inserta los datos en una tabla de Amazon DynamoDB. AWS IoT Las reglas básicas analizan los mensajes de MQTT y realizan acciones en función del contenido y el tema de cada mensaje. A continuación, cree una regla con una acción de DynamoDB para insertar datos en una tabla de DynamoDB que cree como parte de este tutorial.

Para crear una regla con una acción de DynamoDB

1. Vaya a la consola de AWS IoT. Si aparece un botón Get started (Empezar), elíjalo.

2. En el panel de navegación izquierdo, elija Act (Acción) y, a continuación, elija Rules (Reglas).

   

3. Si aparece el cuadro de diálogo You don't have any rules yet (Aún no tiene ninguna regla), elija Create a rule (Crear una regla). De lo contrario, seleccione Crear.

4. Escriba un nombre y una descripción para la regla.

   

5. Busque el tema de notificación que guardó anteriormente en este tutorial.

   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE

   Sustituya el ID del activo (el ID después de assets/) del tema por un +. Esto selecciona la propiedad de velocidad del viento para todos los activos de aerogeneradores de demostración. El filtro de temas + acepta todos los nodos de un solo nivel de un tema. El tema debe ser similar al siguiente ejemplo.

   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE

6. Introduzca la siguiente instrucción de consulta de reglas. Reemplace el tema de la sección FROM por el tema de notificación.

   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. En Set one or more actions (Definir una o varias acciones), elija Add action (Añadir acción).

   

8. En la página Seleccione una acción, elija Dividir el mensaje en varias columnas de una tabla de DynamoDB (Dynamo). DBv2

   

9. Seleccione Configure action (Configurar acción) en la parte inferior de la página.

10. En la página Configure action, seleccione Create a new resource.

    La consola de DynamoDB se abre en una pestaña nueva. Mantenga abierta la pestaña de acción de regla mientras realiza los siguientes procedimientos.

Paso 3: creación de una tabla de DynamoDB

En este procedimiento, creará una tabla Amazon DynamoDB para recibir datos de velocidad del viento de la acción de regla.

Para crear una tabla de DynamoDB

1. En el panel de la consola de DynamoDB, elija Crear tabla.

2. Introduzca un nombre para la tabla.

   

3. En Primary key (Clave principal), haga lo siguiente:

   1. Escriba timestamp como clave de partición.

   2. Seleccione el tipo Number (Número) .

   3. Marque la casilla Add sort key (Añadir clave de ordenación).

   4. Escriba asset como clave de ordenación y deje el tipo de clave de ordenación predeterminado de String (Cadena).

4. Seleccione Crear.

   Cuando desaparece el aviso de creación de la tabla la tabla está lista.

5. Vuelva a la pestaña con la página Configure action (Configurar acción) . Mantenga la pestaña de DynamoDB abierta mientras realiza los siguientes procedimientos.

Paso 4: configuración de la acción de regla de DynamoDB

En este procedimiento, configure la acción de la regla de Amazon DynamoDB para insertar datos desde actualizaciones de valores de propiedad en la nueva tabla DynamoDB.

Para configurar la acción de regla de DynamoDB

1. En la página Configurar acción, actualice la lista Nombre de la tabla y elija la nueva tabla de DynamoDB.

   

2. Elija Crear rol para crear un rol de IAM que otorgue a AWS IoT Core acceso para realizar la acción de regla.

3. Introduzca un nombre de rol y elija Create Role (Crear rol).

   

4. Seleccione Agregar acción.

5. Seleccione Create rule (Crear regla) en la parte inferior de la página para terminar de crear la regla.

   Los datos de los activos de demostración deberían comenzar a aparecer en la tabla de DynamoDB.

Paso 5: exploración de datos en DynamoDB

En este procedimiento, explorará los datos de velocidad del viento de los activos de demostración en su nueva tabla de Amazon DynamoDB.

Para explorar datos de activos en DynamoDB.

1. Vuelva a la pestaña con la tabla de DynamoDB abierta.

2. En la tabla que creó anteriormente, elija la ficha Items (Elementos) para ver los datos de la tabla. Actualice la página si no ve filas en la tabla. Si las filas no aparecen después de unos minutos, consulte Solución de problemas de una regla (DynamoDB).

   

3. En una fila de la tabla, elija el icono de edición para expandir los datos.

   

4. Selecciona la flecha situada junto a windspeedestructura para ampliar la lista de puntos de datos de velocidad del viento. Cada lista refleja un lote de puntos de datos de velocidad del viento enviados AWS IoT SiteWise por la demostración del parque eólico. Es posible que desee un formato de datos diferente si configura una acción de regla para su propio uso. Para obtener más información, consulte Consulte las notificaciones de propiedades de activos en AWS IoT SiteWise.

   

Ahora que ha completado el tutorial, deshabilite o elimine la regla y elimine la tabla de DynamoDB para evitar incurrir en cargos adicionales. Para limpiar los recursos, consulte Paso 6: limpieza de los recursos después del tutorial.

Paso 6: limpieza de los recursos después del tutorial

Después de completar el tutorial, limpie los recursos para evitar incurrir en cargos adicionales. Sus activos de parque eólico de demostración se eliminan al final de la duración que eligió al crear la demostración. También puede eliminar la demostración de forma manual. Para obtener más información, consulte Elimine la AWS IoT SiteWise demostración.

Utilice los siguientes procedimientos para deshabilitar las notificaciones de actualización del valor de las propiedades (si no ha eliminado la demostración), deshabilitar o eliminar la AWS IoT regla y eliminar la tabla de DynamoDB.

Para deshabilitar las notificaciones de actualización de valores de propiedad en propiedades de activos

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación izquierdo, elija Assets (activos).

   

3. Selecciona la flecha situada junto a Demo Wind Farm Assetpara ampliar la jerarquía de los activos del parque eólico.

   

4. Elija una turbina de demostración y elija Edit (Editar).

   

5. Actualizar el Wind SpeedEl estado de notificación de la propiedad es DESACTIVADO.

   

6. Elija Save asset (Guardar activo) en la parte inferior de la página.

7. Repita los pasos 4 a 6 para cada activo de turbina de demostración.

Para deshabilitar o eliminar una regla en AWS IoT Core

1. Vaya a la consola de AWS IoT.

2. En el panel de navegación izquierdo, elija Act (Acción) y, a continuación, elija Rules (Reglas).

3. Elija el menú de su regla y elija Disable (Desactivar) o Delete (Eliminar).

   

Para eliminar una tabla de DynamoDB

1. Navegue hasta la consola de DynamoDB.

2. En el panel de navegación izquierdo, elija Tables (Tablas).

3. Elige la tabla que creaste anteriormente, WindSpeedData.

4. Elija Delete table (Eliminar tabla).

   

5. En el cuadro de diálogo Delete table (Eliminar tabla), elija Delete (Eliminar).