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á. # Gerencie fluxos de dados para AWS IoT SiteWise Um fluxo de dados é o recurso que contém dados históricos de séries temporais. Cada fluxo de dados é identificado por um alias exclusivo, facilitando o controle da origem de cada dado. Os fluxos de dados são criados automaticamente AWS IoT SiteWise quando os primeiros dados da série temporal são recebidos. Se os primeiros dados da série temporal forem identificados com um alias, AWS IoT SiteWise criará um novo fluxo de dados com esse alias, desde que nenhuma propriedade do ativo já tenha sido atribuída a esse alias. Como alternativa, se os primeiros dados da série temporal forem identificados com uma ID de ativo e uma ID de propriedade, AWS IoT SiteWise criará um novo fluxo de dados e associará esse fluxo de dados à propriedade do ativo. Há duas maneiras de atribuir um alias a uma propriedade do ativo. O método usado depende se os dados são enviados AWS IoT SiteWise primeiro ou se um ativo é criado primeiro. + Se os dados forem enviados AWS IoT SiteWise primeiro, isso criará automaticamente um fluxo de dados com o alias atribuído. Quando o ativo for criado posteriormente, use a [ AssociateTimeSeriesToAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssociateTimeSeriesToAssetProperty.html)API para associar o fluxo de dados e seu alias à propriedade do ativo. + Se um ativo for criado primeiro, use a [ UpdateAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html)API para atribuir um alias a uma propriedade do ativo. Quando os dados são enviados posteriormente AWS IoT SiteWise, o fluxo de dados é criado automaticamente e associado à propriedade do ativo. No momento, só é possível associar fluxos de dados a medições. *Medições* são um tipo de propriedade de ativo que representa os fluxos de dados brutos do sensor de um dispositivo, como valores de temperatura com marcação de data/hora ou valores de rotação por minuto (RPM) com marcação de data/hora. Quando essas medições definem métricas ou transformações, os dados recebidos acionam cálculos específicos. É importante observar que uma propriedade de ativo só pode ser vinculada a um fluxo de dados por vez. AWS IoT SiteWise usa `TimeSeries` o recurso Amazon Resource Name (ARN) para determinar suas cobranças de armazenamento. Para obter mais informações, consulte [AWS IoT SiteWise Preço](https://aws.amazon.com/iot-sitewise/pricing/). As seções a seguir mostram como usar o AWS IoT SiteWise console ou a API para gerenciar fluxos de dados. **Topics** + [Definir permissões e configurações](manage-data-streams-configuration.md) + [Associar um fluxo de dados a uma propriedade do ativo](manage-data-streams-method.md) + [Desassociar um fluxo de dados de uma propriedade do ativo](disassociate-data-streams-method.md) + [Criar um fluxo de dados](delete-data-streams-method.md) + [Atualizar um alias de propriedade do ativo](update-data-streams-method.md) + [Cenários comuns](data-ingestion-scenarios.md) # Definir permissões e configurações Os fluxos de dados são criados automaticamente AWS IoT SiteWise quando os primeiros dados da série temporal são recebidos. Se os dados ingeridos não estiverem associados a uma propriedade do ativo, AWS IoT SiteWise criará um novo fluxo de dados desassociado que pode ser configurado para ser associado a uma propriedade do ativo. Configure o controle de acesso do gateway para o qual os dados são enviados AWS IoT SiteWise, usando políticas do IAM para especificar o tipo de dados a serem ingeridos. A política do IAM a seguir desativa a ingestão de dados dissociados do gateway, ao mesmo tempo em que permite a ingestão de dados em fluxos de dados associados a uma propriedade do ativo: **Example Política de usuário do IAM que desativa a ingestão de dados dissociados do gateway** **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowPutAssetPropertyValuesUsingAssetIdAndPropertyId", "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "arn:aws:iotsitewise:*:*:asset/*" }, { "Sid": "AllowPutAssetPropertyValuesUsingAliasWithAssociatedAssetProperty", "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "arn:aws:iotsitewise:*:*:time-series/*", "Condition": { "StringLikeIfExists": { "iotsitewise:isAssociatedWithAssetProperty": "true" } } }, { "Sid": "DenyPutAssetPropertyValuesUsingAliasWithNoAssociatedAssetProperty", "Effect": "Deny", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "arn:aws:iotsitewise:*:*:time-series/*", "Condition": { "StringLikeIfExists": { "iotsitewise:isAssociatedWithAssetProperty": "false" } } } ] } ``` **Example Política de usuário do IAM que desativa toda a ingestão de dados do gateway** **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "DenyPutAssetPropertyValues", "Effect": "Deny", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": [ "arn:aws:iotsitewise:*:*:asset/*", "arn:aws:iotsitewise:*:*:time-series/*" ] } ] } ``` # Associar um fluxo de dados a uma propriedade do ativo Gerencie seus fluxos de dados usando o Console do AWS IoT SiteWise ou AWS CLI. ------ #### [ Console ] Use o AWS IoT SiteWise console para gerenciar seus fluxos de dados. **Para gerenciar fluxos de dados (console)** 1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação, selecione **Fluxos de dados**. 1. Escolha um fluxo de dados filtrando pelo alias do fluxo de dados ou selecionando **fluxos de dados desassociados** no menu suspenso do filtro. 1. Selecione o fluxo de dados a ser atualizado. Você pode selecionar vários fluxos de dados. Clique em **Gerenciar fluxos de dados** no canto superior direito. 1. Selecione o fluxo de dados a ser associado em **Atualizar associações de fluxo de dados** e clique no botão **Escolher medição**. 1. Na seção **Escolher medida**, encontre a propriedade de medição do ativo correspondente. Selecione a medida e clique em **Escolher**. 1. Execute as etapas 4 e 5 para outros fluxos de dados selecionados na etapa 3. Atribua propriedades de ativos a todos os fluxos de dados. 1. Escolha **Atualizar** para confirmar as alterações. Um banner de confirmação bem-sucedido é exibido para confirmar a atualização. ------ #### [ AWS CLI ] Para associar um fluxo de dados (identificado por seu alias) a uma propriedade do ativo (identificada por seu IDs), execute o seguinte comando: ``` aws iotsitewise associate-time-series-to-asset-property \ --alias \ --assetId \ --propertyId ``` ------ # Desassociar um fluxo de dados de uma propriedade do ativo ------ #### [ Console ] Use o AWS IoT SiteWise console para desassociar seu fluxo de dados de uma propriedade do ativo. **Para desassociar fluxos de dados de uma propriedade do ativo (console)** 1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação, selecione **Fluxos de dados**. 1. Escolha um fluxo de dados filtrando pelo alias do fluxo de dados ou selecionando **fluxos de dados associados** no menu suspenso do filtro. 1. Selecione o fluxo de dados a ser desassociado. A coluna de **alias do fluxo de dados** deve conter um alias. As colunas **Nome do ativo** **e Nome da propriedade** do ativo devem conter os valores da propriedade do ativo à qual o fluxo de dados está associado. Você pode selecionar vários fluxos de dados. 1. Clique em **Gerenciar fluxos de dados** no canto superior direito. 1. Na seção **Atualizar associações de fluxo de dados**, clique em **X** na coluna **Nome da medida**. Um `submitted` status deve aparecer na coluna **Status**. 1. Escolha **Atualizar** para confirmar as alterações. O fluxo de dados agora está desassociado da propriedade do ativo e o alias agora é usado para identificar o fluxo de dados. ------ #### [ AWS CLI ] Para desassociar um fluxo de dados de uma propriedade do ativo (identificada por seu `ID` s e seu alias), execute o seguinte comando: ``` aws iotsitewise disassociate-time-series-from-asset-property \ --alias \ --assetId \ --propertyId ``` O fluxo de dados agora está desassociado da propriedade do ativo e o alias é usado para identificar o fluxo de dados. O alias não está mais associado à propriedade do ativo, pois agora está associado ao fluxo de dados. ------ # Criar um fluxo de dados Quando uma propriedade é removida de um modelo de ativo, AWS IoT SiteWise exclui as propriedades e seus fluxos de dados de todos os ativos gerenciados pelo modelo de ativo. Ele também exclui todas as propriedades e seus fluxos de dados de um ativo quando o ativo é excluído. Se os dados de um fluxo de dados precisarem ser preservados, eles deverão ser desassociados da propriedade do ativo antes de serem excluídos. **Atenção** Quando uma propriedade é excluída de um ativo, o fluxo de dados associado também é excluído. Para preservar o fluxo de dados, desassocie-o primeiro da propriedade do ativo, antes de excluir a propriedade do modelo do ativo ou excluir o ativo. ------ #### [ Console ] Use o AWS IoT SiteWise console para desassociar seu fluxo de dados de uma propriedade do ativo. **Para excluir um fluxo de dados (console)** 1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação, selecione **Fluxos de dados**. 1. Escolha um fluxo de dados filtrando pelo alias do fluxo de dados. 1. Selecione o fluxo de dados a ser excluído. Você pode selecionar vários fluxos de dados. 1. Escolha o botão **Excluir** para excluir o fluxo de dados. ------ #### [ AWS CLI ] Use a [ DeleteTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteTimeSeries.html)API para excluir um fluxo de dados específico, usando seu alias. ``` aws iotsitewise delete-time-series \ --alias ``` ------ # Atualizar um alias de propriedade do ativo Os aliases devem ser exclusivos em uma AWS região. Isso inclui aliases de propriedades de ativos e fluxos de dados. Não atribua um alias a uma propriedade do ativo, se outra propriedade ou fluxo de dados estiver usando esse alias. ------ #### [ Console ] Use o AWS IoT SiteWise console para atualizar um alias de propriedade do ativo. **Para atualizar um alias de propriedade do ativo (console)** 1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação, selecione **Ativos**. 1. Selecione o ativo na tabela. 1. Clique no botão **Edit (Editar)**. 1. Selecione o **tipo de propriedade** na tabela **Propriedades**. 1. Encontre a propriedade e digite o novo alias no campo de texto do alias da propriedade. 1. Clique no botão **Salvar** para salvar as alterações. ------ #### [ AWS CLI ] Para atualizar um alias em uma propriedade do ativo, execute o seguinte comando: ``` aws iotsitewise update-asset-property \ --asset-id \ --property-id \ --property-alias \ --property-notification-state ``` **nota** Se as notificações de propriedade estiverem habilitadas no momento, elas deverão ser fornecidas novamente para garantir que continuem sendo ativadas. ------ # Cenários comuns ## Mover um fluxo de dados Para alterar a associação de um fluxo de dados com outra propriedade do ativo, primeiro desassocie o fluxo de dados da propriedade atual do ativo. Ao desassociar um fluxo de dados de uma propriedade do ativo, deve haver um alias atribuído a essa propriedade do ativo. ``` aws iotsitewise disassociate-time-series-from-asset-property \ --alias \ --assetId \ --propertyId ``` Agora, reatribua o fluxo de dados à nova propriedade do ativo. ``` aws iotsitewise associate-time-series-from-asset-property \ --alias \ --assetId \ --propertyId ``` ## Erro ao atribuir um alias a uma propriedade do ativo Ao usar a `UpdateAssetProperty` API para atribuir um alias a uma propriedade, você pode ver a seguinte mensagem de erro: ``` Given alias for property with ID already in use by another property or data stream ``` Essa mensagem de erro indica que o alias não está atribuído à propriedade porque ele é usado atualmente por outra propriedade ou por um fluxo de dados. Isso acontece se os dados estiverem sendo ingeridos AWS IoT SiteWise com um alias. Quando os dados são enviados com um alias que não está sendo usado por outro fluxo de dados ou propriedade do ativo, um novo fluxo de dados é criado com esse alias. As duas opções abaixo resolvem o problema. + Use a `AssociateTimeSeriesToAssetProperty` API para associar o fluxo de dados com seu alias à propriedade do ativo. + Interrompa temporariamente a ingestão de dados e exclua o fluxo de dados. Use a `UpdateAssetProperty` API para atribuir o alias à propriedade do ativo e, em seguida, reative a ingestão de dados. ## Erro ao associar um fluxo de dados a uma propriedade do ativo Ao associar um fluxo de dados a uma propriedade do ativo, a seguinte mensagem de erro é exibida. ``` assetProperty with assetId propertyId contains data ``` Essa mensagem de erro indica que a propriedade do ativo já está associada a um fluxo de dados contendo dados. Esse fluxo de dados deve ser desassociado ou excluído antes de associar outro fluxo de dados a essa propriedade do ativo. **nota** Ao desassociar um fluxo de dados de uma propriedade do ativo, o alias atribuído à propriedade é fornecido ao fluxo de dados. Para que esse alias permaneça atribuído à propriedade, atribua um novo alias a essa propriedade antes de desassociar o fluxo de dados. Para preservar os dados armazenados na propriedade do ativo, faça o seguinte: + Certifique-se de que nenhum dado esteja sendo ingerido na propriedade do ativo, para evitar a criação de um novo fluxo de dados. + Use a `UpdateAssetProperty` API para definir um novo alias que é fornecido ao fluxo de dados atualmente atribuído. + Use a `DisassociateTimeSeriesFromAssetProperty` API para desassociar o fluxo de dados atual da propriedade do ativo. + Use a `AssociateTimeSeriesToAssetProperty` API para associar o fluxo de dados desejado à propriedade do ativo. Se os dados armazenados na propriedade do ativo precisarem ser excluídos, faça o seguinte: + Certifique-se de que nenhum dado esteja sendo ingerido na propriedade do ativo, para evitar a criação de um novo fluxo de dados. + Use a `DeleteTimeSeries` API para excluir o fluxo de dados atualmente atribuído. + Use a `AssociateTimeSeriesToAssetProperty` API para associar o fluxo de dados desejado à propriedade do ativo.