使用数据源

使用 AWS IoT SiteWise 控制台 或管理您的数据流 AWS CLI。

Console

使用 AWS IoT SiteWise 控制台管理您的数据流。

要管理数据流（控制台）

1. 导航到 AWS IoT SiteWise 控制台。

2. 在导航窗格中，选择 数据流。

3. 或者，要添加或更新标签，请选择要编辑的数据流，然后选择 管理标签。

   在 编辑标签 页面上，选择 添加标签。在 密钥字段中，输入要使用的标签的名称。

   选择保存。

4. 或者，在 数据流表中，您可以通过以下方式筛选数据流。

   • 在第一个下拉菜单中，选择 别名前缀或资产 ID。

     • 别名前缀- 数据流的别名前缀。如果您的目标数据流具有别名前缀，则可以选择此选项。

     • 资产 ID - 在其中创建资产属性的资产 ID。如果您的目标数据流与资产属性相关联，则可以选择此选项。

   • 在第二个下拉菜单中，选择 所有数据流、关联的数据流或 取消关联的数据流。

     • 所有数据流- 与资产属性关联或不关联的数据流。

     • 关联的数据流- 与资产属性关联的数据流。

     • 取消关联的数据流- 未与资产属性关联的数据流。

5. 选择您要管理的数据流。 AWS IoT SiteWise 在页面底部的图表中显示您选择的数据流。如果选择超过 10 个，则图表将仅显示前 10 个。

6. （可选）通过以下方式配置图表。

   1. 在 聚合函数中，选择以下选项之一。

      • 数据点计数 – 返回给定变量在当前时间间隔内的数据点总数。

      • 平均值 – 返回给定变量在当前时间间隔内的平均值。

      • 总和 – 返回给定变量在当前时间间隔内的值总和。

      • 最小值 – 返回给定变量在当前时间间隔内的最小值。

      • 最大值 – 返回给定变量在当前时间间隔内的最大值。

      有关更多信息，请参阅 在公式表达式中使用聚合函数。

   2. 对于 时间范围，请选择以下选项之一。

      • 过去 1 小时 - 图表显示过去一小时的聚合数据。

      • 过去 2 小时 - 图表显示过去两个小时的聚合数据。

      • 过去 3 小时 - 图表显示过去三个小时的聚合数据。

      • 过去 4 小时 - 图表显示过去四个小时的聚合数据。

   3. 对于集成类型，选择下列选项之一。

      • 1 分钟 - 在指定时间范围内每分钟聚合一次数据。

      • 1 小时 - 在指定时间范围内每小时聚合一次数据。

7. 选择 管理数据流。

8. 在 更新数据流关联部分的测量名称列中，执行以下任一操作。

   • 如果数据流与测量相关联，请通过选择关闭图标来删除关联。

   • 如果数据流未与测量值关联，请选择选择测量值。

9. 在选择测量值表中，导航到目标资产，然后选择要关联的测量值。

10. 或者，在更新资产属性别名部分中，为每个测量输入唯一的别名。

11. 选择更新。

状态 列可以展示以下值之一。

• 待处理 - 您正在更新数据流关联或资产属性别名。

• 提交 - 保存您对关联或资产属性别名的更改。

• 错误- AWS IoT SiteWise 无法处理您更新数据流关联或测量别名的请求。

• 成功 - 您成功更新了测量的数据流关联或别名。

AWS CLI

使用以下API操作来管理您的数据流。代码示例使用 AWS CLI。

• AssociateTimeSeriesToAssetProperty— 将数据流（时间序列）与资产属性相关联。

• DisassociateTimeSeriesFromAssetProperty— 取消数据流与资产属性的关联。

• DeleteTimeSeries— 删除数据流。

• DescribeTimeSeries— 检索有关数据流的信息。

• ListTimeSeries— 检索数据流的分页列表。

AssociateTimeSeriesToAssetProperty

要将数据流与资产属性相关联，请运行以下命令。

重要

指定的资产属性当前不得与任何数据流相关联。

• Replace（替换） data-stream-alias 使用您要关联的数据流的别名。

• Replace（替换） asset-ID 以及创建资产属性的资产的 ID。

• Replace（替换） property-ID 带有资产属性的ID。

aws iotsitewise associate-time-series-to-asset-property \ 
                         --alias data-stream-alias \
                         --assetId asset-ID \
                         --propertyId property-ID

DisassociateTimeSeriesFromAssetProperty

要取消数据流与资产属性之间的关联，请运行以下命令。

• Replace（替换） data-stream-alias 使用要取消关联的数据流的别名。

• Replace（替换） asset-ID 以及创建资产属性的资产的 ID。

• Replace（替换） property-ID 带有资产属性的ID。

aws iotsitewise disassociate-time-series-from-asset-property \ 
                         --alias data-stream-alias \
                         --assetId asset-ID \
                         --propertyId property-ID

DeleteTimeSeries

要删除数据流，运行以下命令。

Replace（替换） data-stream-alias 使用要删除的数据流的别名。

aws iotsitewise delete-time-series --alias data-stream-alias

要识别数据流，请执行以下操作之一：

• 如果数据流未与资产属性关联，请指定该数据流的 alias。

• 如果数据流与资产属性相关联，请指定以下选项之一：

  • 数据流的 alias。

  • 标识资产属性的 assetId 和 propertyId。

DescribeTimeSeries

使用该DescribeTimeSeriesAPI操作来验证是否成功关联或取消了数据流的关联。

要检索有关数据流的信息，请运行以下命令。

aws iotsitewise describe-time-series --alias data-stream-alias

要识别数据流，请执行以下操作之一：

• 如果数据流未与资产属性关联，请指定该数据流的 alias。

• 如果数据流与资产属性相关联，请指定以下选项之一：

  • 数据流的 alias。

  • 标识资产属性的 assetId 和 propertyId。

ListTimeSeries

使用该ListTimeSeriesAPI操作来验证是否成功删除了数据流。

要检索数据流的分页列表，请运行以下命令。

aws iotsitewise list-time-series