Mapeamento de fluxos de dados industriais para propriedades de ativos

Você pode definir um alias de propriedade em qualquer tipo de propriedade do ativo para poder identificar facilmente uma propriedade do ativo ao ingerir ou recuperar dados do ativo. Se seu ativo tiver propriedades de medição, você poderá definir os aliases de propriedade para mapear seus fluxos de dados para essas propriedades de medição.

Esse processo requer que você saiba o alias da sua propriedade.

• Se você ingerir dados de servidores OPC-UA usando uma fonte de dados OPC-UA em um gateway, seu alias de propriedade é o caminho para uma variável no nó Objetos, começando com/. Por exemplo, se o caminho para a variável for company/windfarm/3/turbine/7/temperature, o alias da propriedade será /company/windfarm/3/turbine/7/temperature. Para obter mais informações sobre a arquitetura de informações OPC-UA, consulte o Information Model and Address Spacing mapping na Referência online do OPC UA.

  Observações

  • Se você configurar um prefixo do fluxo de dados para a origem do OPC-UA, será necessário incluir esse prefixo no alias da propriedade em todos os fluxos de dados dessa origem. Por exemplo, se você usar /RentonWA como prefixo, o alias anterior será /RentonWA/company/windfarm/3/turbine/7/temperature.

  • Os aliases de propriedade podem conter até 1.000 bytes. Os caminhos de variáveis OPC-UA podem conter até 4.096 bytes. Atualmente,AWS IoT SiteWise não suporta a ingestão de dados de variáveis OPC-UA com caminhos longos.

• Se você ingerir dados de servidores Modbus usando uma fonte de dados Modbus TCP em um gateway, seu alias de propriedade será Modbusregister set tag name. Você pode usar esse valor para enviar dados desse conjunto de registros para uma propriedade do ativo.

• Se você ingerir dados de outras fontes, por meio do uso de regras do AWS IoT ou da API, defina os aliases da propriedade. É possível definir um sistema de nomenclatura de alias de propriedade aplicável à configuração do seu dispositivo. Por exemplo, se você ingerir dados de coisas do AWS IoT, será possível incluir o nome da coisa nos aliases de propriedade para identificar os fluxos de dados de forma exclusiva. Para obter mais informações sobre este exemplo, consulte o tutorial Ingerir dados de coisas do AWS IoT.

Os aliases das propriedades devem ser exclusivos em uma região e conta da AWS. O AWS IoT SiteWise retornará um erro se você definir um alias de propriedade como um que já exista em outra propriedade de ativo.

Se você tiver várias fontes de OPC-UA com caminhos de fluxos de dados idênticos, será possível adicionar um prefixo aos caminhos de cada fonte para criar aliases exclusivos. Para obter mais informações, consulte Configurar fontes de dados.

nota

Esta seção descreve como definir aliases de propriedade para propriedades de medição. Para obter mais informações sobre como definir aliases de propriedade para propriedades de estado de alarme externas, consulteMapeando fluxos de estado de alarme externos.

Definir um alias de propriedade (console)

Você pode usar o console do AWS IoT SiteWise para definir um alias para uma propriedade de ativo.

Como definir um alias de propriedade (console)

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

2. No painel de navegação, selecione Ativos.

3. Escolha o ativo para o qual deseja definir um alias de propriedade.

   dica

   Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

   

4. Escolha Edit (Editar).

5. Localize a propriedade para a qual você deseja definir um alias e insira o alias da propriedade.

   

6. Escolha Save (Salvar).

Definir um alias de propriedade (CLI)

Você pode usar a AWS Command Line Interface (AWS CLI) para definir um alias para uma propriedade de ativo.

Para executar este procedimento, é necessário saber quais são o assetId do ativo e o propertyId da propriedade. Se você criou um ativo, mas não sabeassetId, use a ListAssetsoperação para visualizar todos os seus ativos para um modelo específico. Em seguida, use a DescribeAssetoperação para visualizar as propriedades do seu ativo, incluindo IDs de propriedade.

Para mapear um fluxo de dados para a propriedade do seu ativo, use a UpdateAssetPropertyoperação. Especifique os seguintes parâmetros:

• assetId— O ID do ativo.

• propertyId— O ID da propriedade do ativo.

• propertyAlias— O caminho do fluxo de dados até o alias para a propriedade.

• propertyNotificationState— O estado de notificação do valor da propriedade:ENABLED ouDISABLED. Especifique o estado de notificação existente da propriedade ao atualizar o alias da propriedade. Você pode recuperar o estado de notificação existente com a DescribeAssetPropertyoperação.

  Se você omitir esse parâmetro, o novo estado de notificação será DISABLED. Para obter mais informações sobre notificações de propriedade, consulte Interagir com outros serviços da AWS.

Como definir um alias de propriedade (CLI)

1. Execute o seguinte comando para recuperar o estado da notificação atual da propriedade. Substitua asset-id e property-id pelos IDs da propriedade do ativo.

   aws iotsitewise describe-asset-property \
     --asset-id asset-id \
     --property-id property-id

   A operação retorna uma resposta que contém os detalhes da propriedade do ativo no formato a seguir. O estado da notificação da propriedade está em assetProperty.notification.state no objeto JSON.

   {
     "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
     "assetName": "Wind Turbine 7",
     "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
     "assetProperty": {
       "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
       "name": "Wind Speed",
       "notification": {
         "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
         "state": "DISABLED | ENABLED"
       },
       "dataType": "DOUBLE",
       "unit": "m/s",
       "type": {
         "measurement": {}
       }
     }
   }

2. Execute o seguinte comando para definir o alias da propriedade do ativo. Substitua property-alias pelo alias da propriedade e notification-state pelo estado da notificação ou omita --property-notification-state para desabilitar as notificações. Opcionalmente, você pode atualizar a unidade do ativo com uma nova unidade--property-unit e.

   aws iotsitewise update-asset-property \
     --asset-id asset-id \
     --property-id property-id \
     --property-alias property-alias \
     --property-notification-state notification-state \
     --property-unit unit