As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Publicar atualizações de valores de propriedade no Amazon DynamoDB
Este tutorial apresenta uma forma conveniente de armazenar seus dados usando o [Amazon](https://aws.amazon.com/dynamodb/) 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](monitor-data.md).
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](interact-with-other-services.md).
**Topics**
+ [Pré-requisitos](#dynamodb-tutorial-prerequisites)
+ [Etapa 1: Configurar AWS IoT SiteWise para publicar atualizações de valores de propriedades](#dynamodb-tutorial-enable-value-notifications)
+ [Etapa 2: criar uma regra no AWS IoT Core](#dynamodb-tutorial-create-iot-rule)
+ [Etapa 3: Configurar a ação da regra do DynamoDB](#dynamodb-tutorial-configure-rule-action)
+ [Etapa 4: Explore os dados no DynamoDB](#dynamodb-tutorial-explore-dynamodb-data)
+ [Limpar os recursos](#dynamodb-tutorial-clean-up-resources)
+ [Recursos adicionais do](#dynamodb-tutorial-additional-resources)
## Pré-requisitos
Para concluir este tutorial, você precisará do seguinte:
+ Um Conta da AWS. Se você não tiver uma, consulte [Configurar uma AWS conta](getting-started.md#set-up-aws-account).
+ Um computador de desenvolvimento executando Windows, macOS, Linux ou Unix para acessar o. Console de gerenciamento da AWS Para ter mais informações, consulte [What is the Console de gerenciamento da AWS?](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/what-is.html).
+ Um usuário AWS Identity and Access Management (IAM) com permissões de administrador. Para obter instruções detalhadas, consulte [Como AWS IoT SiteWise funciona com o IAM](security_iam_service-with-iam.md).
+ Uma AWS IoT SiteWise demonstração em execução. Para obter mais informações, consulte [Use a AWS IoT SiteWise demonstração](getting-started-demo.md).
**nota**
Este tutorial requer o uso de recursos criados no[Use a AWS IoT SiteWise demonstração](getting-started-demo.md). Você deve concluí-lo antes de continuar com este tutorial.
**Importante**
Guarde todos os recursos de demonstração até concluir este tutorial. A exclusão de qualquer componente pode interromper a funcionalidade da demonstração e afetar sua capacidade de concluir o tutorial.
## 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](https://console.aws.amazon.com/iotsitewise/).
1. Revise os [AWS IoT SiteWise endpoints e as cotas](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) em que AWS IoT SiteWise há suporte e troque de AWS região, se necessário. Mude para uma região onde você está executando a AWS IoT SiteWise demonstração.
1. No painel de navegação à esquerda, escolha **Ativos**.
1. Selecione a seta ao lado de **Demo Wind Farm Asset** para expandir a hierarquia do ativo do parque de energia eólica.
1. Escolha uma turbina de demonstração e escolha **Edit (Editar)**.
1. Selecione **Measurements (Medidas)**.
1. Atualize o **status da Notificação MQTT** da **Wind Speed**propriedade para **ATIVO**.
1. Escolha **Salvar** na parte inferior da página.
1. Repita as etapas 5 a 7 para cada ativo da turbina de demonstração.
1. Escolha uma turbina de demonstração (por exemplo, **Demo Turbine Asset 1**).
1. Selecione **Measurements (Medidas)**.
1. 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](https://console.aws.amazon.com/iot/).
1. **No painel de navegação esquerdo, escolha **Roteamento de mensagens e, em** seguida, escolha Regras.**
1. Escolha **Criar regra**.
1. Em **Especificar propriedades da regra**, insira um nome e uma descrição para a regra.
1. 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
```
1. 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'
```
1. Em **Ações da regra**, navegue até a **Ação 1**.
1. Na página **Selecionar uma ação**, escolha **Dynamo. DBv2** Isso divide a mensagem em várias colunas de uma tabela do DynamoDB.
1. 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.
1. Em **Nome da tabela** no console do [DynamoDB](https://console.aws.amazon.com/dynamodb/), insira um nome para sua tabela.
1. Para **chave de partição**, faça o seguinte:
1. Digite **timestamp** como a chave de partição.
1. Escolha o tipo **Number (Número)**.
1. Marque a caixa de seleção **Add sort key (Adicionar chave de classificação)**.
1. Digite **asset** como a chave de classificação e deixe o tipo de chave de classificação padrão **String**.
1. Escolha **Criar tabela**.
1. Retorne à guia com a página **Configure action (Configurar ação)**.
1. 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.
1. Insira um nome de função, por exemplo,`WindSpeedDataRole`. Selecione **Criar perfil**.
1. Escolha **Próximo**.
1. 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.
1. 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)](troubleshoot-rule.md#dynamodb-tutorial-troubleshoot-rule).
1. Em uma linha na tabela, escolha o ícone de edição para expandir os dados.
1. 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](query-notification-messages.md).
Agora que você concluiu o tutorial, você pode desativar ou excluir a regra e excluir sua tabela do DynamoDB para evitar cobranças adicionais. Para limpar os recursos, consulte [Limpar os recursos](#dynamodb-tutorial-clean-up-resources).
Você também pode aprender a criar aplicativos personalizados para consumir e visualizar esses dados. Para obter um tutorial guiado sobre visualização de AWS IoT SiteWise dados, consulte[Visualize e compartilhe dados na Grafana](visualize-with-grafana.md).
## Limpar os recursos
Depois de concluir o tutorial, limpe os recursos para evitar a geração de cobranças adicionais.
**Para excluir a AWS IoT SiteWise demonstração**
1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. No canto superior direito da página, escolha **Excluir** demonstração.
1. Na caixa de diálogo de confirmação, insira **DELETE** e selecione **Delete (Excluir)**.
Para obter mais informações, consulte [Exclua a AWS IoT SiteWise demonstração](getting-started-demo.md#delete-getting-started-demo).
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](https://console.aws.amazon.com/iotsitewise/).
1. No painel de navegação à esquerda, escolha **Ativos**.
1. Selecione a seta ao lado de **Demo Wind Farm Asset** para expandir a hierarquia do ativo do parque de energia eólica.
1. Escolha uma turbina de demonstração e escolha **Edit (Editar)**.
1. Atualize o **status de notificação** da **Wind Speed**propriedade para **INATIVO**.
1. Escolha **Save asset (Salvar ativo)** na parte inferior da página.
1. 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](https://console.aws.amazon.com/iot/).
1. No painel de navegação à esquerda, escolha **Roteamento de mensagens** e **Regras**.
1. Selecione sua regra e escolha **Excluir**.
1. 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](https://console.aws.amazon.com/dynamodb/).
1. No painel de navegação à esquerda, selecione **Tables (Tabelas)**.
1. Escolha a tabela que você criou anteriormente, por exemplo,`WindSpeedData`.
1. Escolha **Excluir**.
1. Na caixa de diálogo de confirmação, insira **confirm** para excluir a tabela.
## Recursos adicionais do
Para obter mais informações sobre como trabalhar com o DynamoDB e monitorar seus dados, consulte os seguintes recursos:
+ [Monitoramento de métricas no](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Monitoring-metrics-with-Amazon-CloudWatch.html) *DynamoDB Developer Guide CloudWatch *
+ [As melhores práticas para projetar e usar chaves de partição de forma eficaz no](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html) *DynamoDB Developer Guide*
+ [Regras do AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) *Guia do AWS IoT Desenvolvedor*
+ [Visualize e compartilhe dados na Grafana](visualize-with-grafana.md)