Publicar atualizações de valores de propriedade no Amazon DynamoDB

Este tutorial apresenta uma forma conveniente de armazenar seus dados usando o Amazon DynamoDB, facilitando o acesso a dados históricos de ativos sem consultar repetidamente a API. AWS IoT SiteWise Depois de concluir este tutorial, você poderá criar software personalizado que consome os dados de ativos, como um mapa em tempo real de velocidade e direção do vento em um parque eólico inteiro. Se você quiser monitorar e visualizar os dados sem implementar uma solução de software personalizada, consulte Monitore dados com AWS IoT SiteWise Monitor.

Neste tutorial, você se baseia na AWS IoT SiteWise demonstração que fornece um conjunto de dados de amostra para um parque eólico. Você configura as atualizações de valor de propriedade da demonstração do parque de energia eólica para enviar dados pelas regras Core do AWS IoT a uma tabela do DynamoDB criada por você. Quando você ativa as atualizações do valor da propriedade, AWS IoT SiteWise envia seus dados para as AWS IoT Core mensagens do MQTT. Em seguida, defina as regras AWS IoT principais que executam ações, como a ação do DynamoDB, dependendo do conteúdo dessas mensagens. Para obter mais informações, consulte Interaja com outros AWS serviços.

Pré-requisitos

Para concluir este tutorial, você precisará do seguinte:

• Uma AWS conta. Se você não tiver uma, consulte Configurar uma AWS conta.

• Um computador de desenvolvimento executando Windows, macOS, Linux ou Unix para acessar o. AWS Management Console Para ter mais informações, consulte What is the AWS Management Console?.

• Um usuário do IAM com permissões de administrador. Para obter instruções detalhadas, consulte Como AWS IoT SiteWise funciona com o IAM.

• Uma demonstração em funcionamento de um parque AWS IoT SiteWise eólico. Quando você configura a demonstração, ela define modelos e ativos AWS IoT SiteWise e transmite dados para eles para representar um parque eólico. Para obter mais informações, consulte Use a AWS IoT SiteWise demonstração.

Etapa 1: Configurar AWS IoT SiteWise para publicar atualizações de valores de propriedades

Neste procedimento, habilite as notificações de valor de propriedade das propriedades Wind Speed dos ativos da turbina de demonstração. Depois de ativar as notificações de valor da propriedade, AWS IoT SiteWise publica cada atualização de valor em uma mensagem MQTT no Core. AWS IoT

Como habilitar notificações de atualização de valor de propriedade nas propriedades do ativo

1. Faça login no console do AWS IoT SiteWise.

2. Revise os AWS IoT SiteWise endpoints e as cotas em que AWS IoT SiteWise há suporte e troque de AWS região, se necessário. Mude para uma região em que você está executando a AWS IoT SiteWise demonstração.

3. No painel de navegação à esquerda, escolha Ativos.

4. Selecione a seta ao lado de Demo Wind Farm Asset para expandir a hierarquia do ativo do parque de energia eólica.

5. Escolha uma turbina de demonstração e escolha Edit (Editar).

6. Selecione Measurements (Medidas).

7. Atualize o status da Notificação MQTT da Wind Speedpropriedade para ATIVO.

8. Escolha Salvar na parte inferior da página.

9. Repita as etapas 5 a 7 para cada ativo da turbina de demonstração.

10. Escolha uma turbina de demonstração (por exemplo, Demo Turbine Asset 1).

11. Selecione Measurements (Medidas).

12. Selecione o ícone de cópia ao lado da propriedade Wind Speed para copiar o tópico de notificação para a área de transferência. Salve o tópico de notificação para usar mais adiante neste tutorial. Você só precisa registrar o tópico de notificação de uma turbina.

    O tópico de notificação deve ser semelhante ao exemplo a seguir.

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

Etapa 2: criar uma regra no AWS IoT Core

Nesta etapa, crie uma regra no AWS IoT Core que analise as mensagens de notificação do valor da propriedade e insira dados em uma tabela do Amazon DynamoDB. AWS IoT As regras básicas analisam as mensagens do MQTT e executam ações com base no conteúdo e no tópico de cada mensagem. Depois, você pode criar uma regra com uma ação do DynamoDB para inserir dados em uma tabela do DynamoDB criada como parte deste tutorial.

Como criar uma regra com uma ação do DynamoDB

1. Navegue até o console do AWS IoT.

2. No painel de navegação esquerdo, escolha Roteamento de mensagens e, em seguida, escolha Regras.

3. Escolha Criar regra.

4. Em Especificar propriedades da regra, insira um nome e uma descrição para a regra.

5. Encontre o tópico de notificação que você salvou anteriormente neste tutorial.

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

   Substitua o ID de ativo (o ID depois de assets/) no tópico por um +. Isso seleciona a propriedade de velocidade do vento para todos os ativos de turbina eólica da demonstração. O filtro de tópico + aceita todos os nós de um único nível em um tópico. Seu tópico deve ser semelhante ao exemplo a seguir.

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

6. Insira a instrução de consulta de regra a seguir. Substitua o tópico na seção FROM pelo tópico de notificação.

   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. Em Ações da regra, navegue até a Ação 1.

8. Na página Selecionar uma ação, escolha Dynamo. DBv2 Isso divide a mensagem em várias colunas de uma tabela do DynamoDB

9. Em Nome da tabela, escolha Criar nova tabela. Você cria uma tabela do Amazon DynamoDB para receber dados de velocidade do vento da ação da regra.

10. Em Nome da tabela no console do DynamoDB, insira um nome para sua tabela.

11. Para chave de partição, faça o seguinte:

    1. Digite timestamp como a chave de partição.

    2. Escolha o tipo Number (Número).

    3. Marque a caixa de seleção Add sort key (Adicionar chave de classificação).

    4. Digite asset como a chave de classificação e deixe o tipo de chave de classificação padrão String.

12. Escolha Create table.

13. Retorne à guia com a página Configure action (Configurar ação).

14. Na página de ação Anexar regra, atualize a lista de nomes da tabela e escolha a nova tabela do DynamoDB que você criou na etapa anterior.

Etapa 3: Configurar a ação da regra do DynamoDB

Nesta etapa, configure a ação de regra do Amazon DynamoDB para inserir dados de atualizações de valores de propriedades em sua nova tabela do DynamoDB.

Como configurar a ação de regra do DynamoDB

1. Escolha Criar função para criar uma função do IAM que conceda acesso AWS IoT principal para realizar a ação da regra.

2. Insira um nome de função, por exemplo,WindSpeedDataRole. Selecione Criar perfil.

3. Escolha Próximo.

4. Escolha Criar na parte inferior da página para concluir a criação da regra.

   Os dados de ativo de demonstração devem começar a aparecer na tabela do DynamoDB.

Etapa 4: Explore os dados no DynamoDB

Nesta etapa, explore os dados de velocidade do vento dos ativos de demonstração em sua nova tabela do Amazon DynamoDB.

Como explorar dados de ativo no DynamoDB

1. Retorne à guia com a tabela do DynamoDB aberta.

2. Na tabela que você criou anteriormente, escolha a guia Explorar itens da tabela para visualizar os dados na tabela. Atualize a página se você não vir linhas na tabela. Se as linhas não aparecerem após alguns minutos, consulte Solucionar problemas em uma regra (DynamoDB).

3. Em uma linha na tabela, escolha o ícone de edição para expandir os dados.

4. Escolha a seta ao lado da estrutura windspeed para expandir a lista de pontos de dados de velocidade do vento. Cada lista reflete um lote de pontos de dados de velocidade do vento enviados AWS IoT SiteWise pela demonstração do parque eólico. Talvez você queira um formato de dados diferente se configurar uma ação de regra para seu próprio uso. Para obter mais informações, consulte Consulte notificações de propriedades de ativos em AWS IoT SiteWise.

Agora que você concluiu o tutorial, desabilite ou exclua a regra e exclua a tabela do DynamoDB para evitar incorrer em cobranças adicionais. Para limpar os recursos, consulte Etapa 5: limpar os recursos após o tutorial.

Etapa 5: limpar os recursos após o tutorial

Depois de concluir o tutorial, limpe os recursos para evitar a geração de cobranças adicionais. Os ativos de demonstração do parque eólico são excluídos no final da duração que você escolheu ao criar a demonstração. Também é possível excluir a demonstração manualmente.

A AWS IoT SiteWise demonstração é excluída após uma semana ou o número de dias que você escolheu se criou a pilha de demonstração no AWS CloudFormation console. Você pode excluir a demonstração antes se terminar de usar os recursos de demonstração. Você também pode excluir a demonstração se houver falha na criação. Use as etapas a seguir para excluir a demonstração manualmente.

(opcional) Para excluir a AWS IoT SiteWise demonstração

1. Navegue até o console do AWS CloudFormation.

2. Escolha TSiteWiseDemoAssetsIo na lista de pilhas.

3. Escolha Excluir.

   Quando você exclui a pilha, todos os recursos criados para a demonstração são excluídos.

4. Na caixa de diálogo de confirmação, escolha Excluir pilha.

   A pilha leva cerca de 15 minutos para ser excluída. Se houver falha na exclusão, escolha Excluir no canto superior direito novamente. Se a demonstração não for excluída novamente, siga as etapas no AWS CloudFormation console para ignorar os recursos que não foram excluídos e tente novamente.

Para obter mais informações, consulte Exclua a AWS IoT SiteWise demonstração.

Use os procedimentos a seguir para desativar as notificações de atualização do valor da propriedade (se você não excluiu a demonstração), desativar ou excluir sua AWS IoT regra e excluir sua tabela do DynamoDB.

Como desabilitar notificações de atualização de valor de propriedade nas propriedades do ativo

1. Navegue até o console do AWS IoT SiteWise.

2. No painel de navegação à esquerda, escolha Ativos.

3. Selecione a seta ao lado de Demo Wind Farm Asset para expandir a hierarquia do ativo do parque de energia eólica.

4. Escolha uma turbina de demonstração e escolha Edit (Editar).

5. Atualize o status de notificação da Wind Speedpropriedade para INATIVO.

6. Escolha Save asset (Salvar ativo) na parte inferior da página.

7. Repita as etapas de 4 a 6 para cada ativo da turbina de demonstração.

Para desativar ou excluir uma regra no AWS IoT Core

1. Navegue até o console do AWS IoT.

2. No painel de navegação à esquerda, escolha Roteamento de mensagens e Regras.

3. Selecione sua regra e escolha Excluir.

4. Na caixa de diálogo de confirmação, insira o nome da regra e selecione Delete.

Como excluir uma tabela do DynamoDB

1. Navegue até o console do DynamoDB.

2. No painel de navegação à esquerda, selecione Tables (Tabelas).

3. Escolha a tabela que você criou anteriormente, por exemplo,WindSpeedData.

4. Escolha Excluir.

5. Na caixa de diálogo de confirmação, insira confirm para excluir a tabela.