本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 物联网 SiteWise OPC UA 采集器
<a name="iotsitewise-opcua-collector-component"></a>

IoT SiteWise OPC UA 收集器组件 (`aws.iot.SiteWiseEdgeCollectorOpcua`) 使 Amazon IoT SiteWise 网关能够从本地 OPC UA 服务器收集数据。

使用此组件， Amazon IoT SiteWise 网关可以连接到多个 OPC UA 服务器。有关 Amazon IoT SiteWise 网关的更多信息，请参阅[《*Amazon IoT SiteWise 用户指南》*中的在边缘使用 Amazon IoT SiteWise](https://docs.amazonaws.cn/iot-sitewise/latest/userguide/gateways-ggv2.html)。

**Topics**
+ [版本](#iotsitewise-opcua-collector-component-versions)
+ [Type](#iotsitewise-opcua-collector-component-type)
+ [操作系统](#iotsitewise-opcua-collector-component-os-support)
+ [要求](#iotsitewise-opcua-collector-component-requirements)
+ [依赖项](#iotsitewise-opcua-collector-component-dependencies)
+ [配置](#iotsitewise-opcua-collector-component-configuration)
+ [输入数据](#iotsitewise-opcua-collector-component-input-data)
+ [输出数据](#iotsitewise-opcua-collector-component-output-data)
+ [本地日志文件](#iotsitewise-opcua-collector-component-log-file)
+ [许可证](#iotsitewise-opcua-collector-component-licenses)
+ [更改日志](#iotsitewise-opcua-collector-component-changelog)
+ [另请参阅](#iotsitewise-opcua-collector-component-see-also)

## 版本
<a name="iotsitewise-opcua-collector-component-versions"></a>

此组件具有以下版本：
+ 3.1.x
+ 3.0.x
+ 2.6.x
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Type
<a name="iotsitewise-opcua-collector-component-type"></a>

<a name="public-component-type-generic"></a>此<a name="public-component-type-generic-phrase"></a>组件是一个通用组件 (`aws.greengrass.generic`)。[Greengrass Nucleus](greengrass-nucleus-component.md) 运行组件的生命周期脚本。

<a name="public-component-type-more-information"></a>有关更多信息，请参阅[组件类型](develop-greengrass-components.md#component-types)。

## 操作系统
<a name="iotsitewise-opcua-collector-component-os-support"></a>

此组件可以安装在运行以下操作系统的核心设备上：
+ Linux
+ Windows

## 要求
<a name="iotsitewise-opcua-collector-component-requirements"></a>

此组件具有以下要求：
+ Greengrass 核心设备必须在以下其中一个平台上运行：
  + 操作系统：Ubuntu 20.04 或更高版本

    架构：x86\_64 (AMD64) 或 ARMv8 (Aarch64)
  + 操作系统：Red Hat Enterprise Linux (RHEL) 8

    架构：x86\_64 (AMD64) 或 ARMv8 (Aarch64)
  + 操作系统：Amazon Linux 2

    架构：x86\_64 (AMD64) 或 ARMv8 (Aarch64)
  + 操作系统：Debian 11

    架构：x86\_64 (AMD64) 或 ARMv8 (Aarch64)
  + 操作系统：Windows Server 2019 或更高版本

    架构：x86\_64 () AMD64
+ Greengrass 核心设备必须允许与 OPC UA 服务器进行出站网络连接。

## 依赖项
<a name="iotsitewise-opcua-collector-component-dependencies"></a>

部署组件时， Amazon IoT Greengrass 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖关系的要求，才能成功部署组件。本部分列出了此组件的[已发布版本](#iotsitewise-opcua-collector-component-changelog)的依赖关系，以及定义每个依赖关系的组件版本的语义版本约束。您还可以在 [Amazon IoT Greengrass 控制台](https://console.amazonaws.cn//greengrass)中查看每个组件版本的依赖关系。在组件详细信息页面上，查找**依赖关系**列表。

下表列出了此组件所有版本的依赖关系。


| 依赖关系 | 兼容版本 | 依赖关系类型 | 
| --- | --- | --- | 
| [Greengrass Nucleus](greengrass-nucleus-component.md) | >=2.3.0 <3.0.0 | 硬性 | 
| [流管理器](stream-manager-component.md) | >2.0.10 <3.0.0 | 硬性 | 
| [密钥管理器](secret-manager-component.md) | >=2.0.8 <3.0.0 | 硬性 | 

有关组件依赖关系的更多信息，请参阅[组件配方参考](component-recipe-reference.md#recipe-reference-component-dependencies)。

## 配置
<a name="iotsitewise-opcua-collector-component-configuration"></a>

此组件没有任何配置参数。

您可以使用 Amazon IoT SiteWise 控制台或 API 来配置 IoT SiteWise OPC UA 收集器组件。有关更多信息，请参阅《Amazon IoT SiteWise 用户指南》中的[第 4 步：添加数据来源 – 可选](https://docs.amazonaws.cn/iot-sitewise/latest/userguide/create-gateway-ggv2.html#add-data-sources-console)。**

## 输入数据
<a name="iotsitewise-opcua-collector-component-input-data"></a>

此组件仅接受以下格式的数据，所有其他格式的数据都将被忽略并丢弃。下表将 OPC UA 数据类型映射到其 SiteWise 等效类型。


|  **SiteWise 数据类型**  |  **OPC UA 数据类型**  |  **描述**  | 
| --- | --- | --- | 
| `STRING` | `String`<br />`Guid`<br />`XmlElement` | 最大长度为 1024 个字节的字符串。 | 
| `INTEGER` | `SByte`<br />`Byte`<br />`Int16`<br />`UInt16`<br />`Int32`<br />`UInt32`\*<br />`Int64`\* | 有符号的 32 位整数，其范围为 `-2,147,483,648 to 2,147,483,647`。 | 
| `DOUBLE` | `UInt32`\*<br />`Int64`\*<br />`Float`<br />`Double` | 浮点数，其范围为 `–10^100 to 10^100` 并采用 `IEEE 754` 双精度。 | 
| `BOOLEAN` | `Boolean` | `true` 或 `false`。 | 

\* 对于 OPC UA 数据类型`UInt32`和`Int64`，`INTEGER`如果能够表示其值，则其 SiteWise 数据类型将为，否则将 SiteWise `DOUBLE`是。

## 输出数据
<a name="iotsitewise-opcua-collector-component-output-data"></a>



此组件将`BatchPutAssetPropertyValue`消息写入 Amazon IoT Greengrass 流管理器。有关更多信息，请参阅《Amazon IoT SiteWise API Reference》**中的 [BatchPutAssetPropertyValue](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)。

## 本地日志文件
<a name="iotsitewise-opcua-collector-component-log-file"></a>

此组件使用以下日志文件。

------
#### [ Linux ]

```
{{/greengrass/v2}}/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```

------
#### [ Windows ]

```
{{C:\greengrass\v2}}\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log
```

------

**查看此组件的日志**
+ 在核心设备上运行以下命令可实时查看此组件的日志文件。将`{{/greengrass/v2}}`或{{C:\\greengrass\\v2}}替换为 Amazon IoT Greengrass 根文件夹的路径。

------
#### [ Linux ]

  ```
  sudo tail -f {{/greengrass/v2}}/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content {{C:\greengrass\v2}}\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait
  ```

------

## 许可证
<a name="iotsitewise-opcua-collector-component-licenses"></a>

<a name="component-core-software-license"></a>此组件在 [Greengrass Core 软件许可协议](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)下发行。

## 更改日志
<a name="iotsitewise-opcua-collector-component-changelog"></a>

下表介绍每个组件版本的更改。


|  **版本**  |  **更改**  | 
| --- | --- | 
| 3.1.0 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.3 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.2 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.1 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.0 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.6.0 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.5.1 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.5.0 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.4.2 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
| 2.4.1 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
| 2.4.0 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.3.0 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
| 2.2.0 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.1.3 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.1.1 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.0.3 | 错误修复和改进。 | 
| 2.0.2 | 关于与边缘同步的资产优先级的错误修复和改进。 | 
| 2.0.1 | 初始版本。 | 

## 另请参阅
<a name="iotsitewise-opcua-collector-component-see-also"></a>
+ [什么是 Amazon IoT SiteWise？](https://docs.amazonaws.cn/iot-sitewise/latest/userguide/what-is-sitewise.html) 在《*Amazon IoT SiteWise 用户指南》*中。