支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪[從 遷移 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # IoT SiteWise 連接器 IoT SiteWise 連接器會將本機裝置和設備資料傳送至其中的資產屬性 AWS IoT SiteWise。您可以使用此連接器從多個 OPC-UA 伺服器收集資料，並將其發佈至 IoT SiteWise。連接器會將資料傳送至目前 AWS 帳戶 和區域中的資產屬性。 **注意** IoT SiteWise 是一項全受管服務，可從工業裝置和設備收集、處理和視覺化資料。您可以設定資產屬性，以處理從此連接器傳送至資產測量內容的原始資料。例如，您可以定義一個將裝置的攝氏溫度資料點轉換為華氏溫度的轉換屬性，或者定義計算每小時平均溫度的指標屬性。如需詳細資訊，請參閱《 AWS IoT SiteWise使用者指南**》中的[什麼是AWS IoT SiteWise ？](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/)。 連接器使用從 OPC-UA 伺服器傳送的 OPC-UA 資料串流路徑，將資料傳送至 IoT SiteWise。例如，資料串流路徑 `/company/windfarm/3/turbine/7/temperature` 可能代表 3 號風力發電廠 7 號渦輪機的溫度感應器。如果 AWS IoT Greengrass 核心失去與網際網路的連線，連接器會快取資料，直到成功連線至 為止 AWS 雲端。您可以設定用於快取資料的最大磁碟緩衝區大小。如果快取大小超過磁碟緩衝區大小上限，則連接器會捨棄佇列中最舊的資料。 設定和部署 IoT SiteWise 連接器之後，您可以在 [IoT SiteWise 主控台](https://console.aws.amazon.com/iotsitewise/)中新增閘道和 OPC-UA 來源。在主控台中設定來源時，您可以篩選或加上 IoT SiteWise 連接器傳送的 OPC-UA 資料串流路徑。如需完成設定閘道和來源的指示，請參閱*AWS IoT SiteWise 《 使用者指南*》中的[新增閘道](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway.html#add-gateway)。 IoT SiteWise 只會從您已映射至 IoT SiteWise 資產測量屬性的資料串流接收資料。若要將資料串流對應至資產屬性，您可以將屬性的別名設定為和 OPC-UA 資料串流路徑相同。若要了解如何定義資產模型和建立資產，請參閱*AWS IoT SiteWise 《 使用者指南*》中的[建立工業資產的模型](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/industrial-asset-models)。 **備註** 您可以使用串流管理員，從 OPC-UA 伺服器以外的來源將資料上傳至 IoT SiteWise。串流管理員也提供可自訂的持久性和頻寬管理支援。如需詳細資訊，請參閱[管理 AWS IoT Greengrass 核心上的資料串流](stream-manager.md)。 此連接器以[無容器](lambda-group-config.md#no-container-mode)隔離模式執行，因此您可以將其部署到在 Docker 容器中執行的 Greengrass 群組。 此連接器具有下列版本。 | 版本 | ARN | | --- | --- | | 12 （建議） | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12` | | 11 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11` | | 10 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10` | | 9 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9` | | 8 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8` | | 7 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7` | | 6 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6` | | 5 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5` | | 4 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4` | | 3 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3` | | 2 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2` | | 1 | `arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1` | 如需版本變更的詳細資訊，請參閱 [Changelog](#iot-sitewise-connector-changelog)。 ## 要求 此連接器有下列要求： ------ #### [ Version 9, 10, 11, and 12 ] **重要** 此版本推出新需求： AWS IoT Greengrass Core 軟體 v1.10.2 和[串流管理員](stream-manager.md)。 + AWS IoT Greengrass 核心軟體 v1.10.2。 + 已在 Greengrass 群組上啟用[串流管理員](stream-manager.md)。 + Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。 + 此連接器只能在同時支援 [AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)和 [IoT SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) 的 Amazon Web Services 區域中使用。 + 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子系上的 `iotsitewise:BatchPutAssetPropertyValue`動作，如下列範例所示。您可以從`Condition`政策中移除 ，以允許連接器存取所有 IoT SiteWise 資產。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 如需詳細資訊，請參閱《[IAM 使用者指南》中的新增和移除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ** ------ #### [ Versions 6, 7, and 8 ] **重要** 此版本推出新需求： AWS IoT Greengrass Core 軟體 v1.10.0 和[串流管理員](stream-manager.md)。 + AWS IoT Greengrass 核心軟體 v1.10.0。 + 已在 Greengrass 群組上啟用[串流管理員](stream-manager.md)。 + Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。 + 此連接器只能在同時支援 [AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)和 [IoT SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) 的 Amazon Web Services 區域中使用。 + 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子系上的 `iotsitewise:BatchPutAssetPropertyValue`動作，如下列範例所示。您可以從`Condition`政策中移除 ，以允許連接器存取所有 IoT SiteWise 資產。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 如需詳細資訊，請參閱《[IAM 使用者指南》中的新增和移除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ** ------ #### [ Version 5 ] + AWS IoT Greengrass 核心軟體 v1.9.4。 + Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。 + 此連接器只能在同時支援 [AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)和 [IoT SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) 的 Amazon Web Services 區域中使用。 + 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子系上的 `iotsitewise:BatchPutAssetPropertyValue`動作，如下列範例所示。您可以從`Condition`政策中移除 ，以允許連接器存取所有 IoT SiteWise 資產。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 如需詳細資訊，請參閱《[IAM 使用者指南》中的新增和移除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ** ------ #### [ Version 4 ] + AWS IoT Greengrass 核心軟體 v1.10.0。 + Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。 + 此連接器只能在同時支援 [AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)和 [IoT SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) 的 Amazon Web Services 區域中使用。 + 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子系上的 `iotsitewise:BatchPutAssetPropertyValue`動作，如下列範例所示。您可以從`Condition`政策中移除 ，以允許連接器存取所有 IoT SiteWise 資產。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 如需詳細資訊，請參閱《[IAM 使用者指南》中的新增和移除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ** ------ #### [ Version 3 ] + AWS IoT Greengrass 核心軟體 v1.9.4。 + Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。 + 此連接器只能在同時支援 [AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)和 [IoT SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) 的 Amazon Web Services 區域中使用。 + 新增至 Greengrass 群組角色的 IAM 政策。此角色允許 AWS IoT Greengrass 群組存取目標根資產及其子系上的 `iotsitewise:BatchPutAssetPropertyValue`動作，如下列範例所示。您可以從`Condition`政策中移除 ，以允許連接器存取所有 IoT SiteWise 資產。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` ------ 如需詳細資訊，請參閱《[IAM 使用者指南》中的新增和移除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ** ------ #### [ Versions 1 and 2 ] + AWS IoT Greengrass 核心軟體 v1.9.4。 + Java 8 已安裝在核心裝置上並已新增至 PATH 環境變數。 + 此連接器只能在同時支援 [AWS IoT Greengrass](https://docs.aws.amazon.com/general/latest/gr/greengrass.html)和 [IoT SiteWise](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) 的 Amazon Web Services 區域中使用。 + 新增至 Greengrass 群組角色的 IAM 政策，允許存取目標根資產及其子系上的 和 AWS IoT Core `iotsitewise:BatchPutAssetPropertyValue`動作，如下列範例所示。您可以從`Condition`政策中移除 ，以允許連接器存取所有 IoT SiteWise 資產。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } }, { "Effect": "Allow", "Action": [ "iot:Connect", "iot:DescribeEndpoint", "iot:Publish", "iot:Receive", "iot:Subscribe" ], "Resource": "*" } ] } ``` ------ 如需詳細資訊，請參閱《 IAM 使用者指南》**中的[新增和移除 IAM 身分許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。 ------ ## Parameters ------ #### [ Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12 ] `SiteWiseLocalStoragePath` IoT SiteWise 連接器可寫入持久性資料的 AWS IoT Greengrass 主機目錄。預設為 `/var/sitewise`。 AWS IoT 主控台中的顯示名稱：**本機儲存路徑** 必要：`false` 類型：`string` 有效模式： `^\s*$|\/.` `AWSSecretsArnList` 中的秘密清單 AWS Secrets Manager ，其中每個都包含 OPC-UA 使用者名稱和密碼金鑰/值對。每個秘密都必須是金鑰/值對類型的秘密。 在 AWS IoT 主控台中顯示名稱：**OPC-UA 使用者名稱/密碼秘密的 ARNs 清單** 必要：`false` 類型：`JsonArrayOfStrings` 有效模式： `\[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]` `MaximumBufferSize` IoT SiteWise 磁碟用量的大小上限，以 GB 為單位。預設為 10GB。 AWS IoT 主控台中的顯示名稱：**磁碟緩衝區大小上限** 必要：`false` 類型：`string` 有效模式： `^\s*$|[0-9]+` ------ #### [ Version 1 ] `SiteWiseLocalStoragePath` IoT SiteWise 連接器可寫入持久性資料的 AWS IoT Greengrass 主機目錄。預設為 `/var/sitewise`。 AWS IoT 主控台中的顯示名稱：**本機儲存路徑** 必要：`false` 類型：`string` 有效模式： `^\s*$|\/.` `SiteWiseOpcuaUserIdentityTokenSecretArn` 中 AWS Secrets Manager 包含 OPC-UA 使用者名稱和密碼金鑰值對的秘密。此秘密必須是索引鍵/值組類型的秘密。 在 AWS IoT 主控台中顯示名稱：**OPC-UA 使用者名稱/密碼秘密的 ARN** 必要：`false` 類型：`string` 有效模式： `^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+` `SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId` AWS IoT Greengrass 群組中參考 OPC-UA 使用者名稱和密碼秘密的秘密資源。 在 AWS IoT 主控台中顯示名稱：**OPC-UA 使用者名稱/密碼秘密資源** 必要：`false` 類型：`string` 有效模式： `^$|.+` `MaximumBufferSize` IoT SiteWise 磁碟用量的 GB 大小上限。預設為 10GB。 AWS IoT 主控台中的顯示名稱：**磁碟緩衝區大小上限** 必要：`false` 類型：`string` 有效模式： `^\s*$|[0-9]+` ------ ### 建立範例連接器 (AWS CLI) 下列 AWS CLI 命令`ConnectorDefinition`會使用包含 IoT SiteWise 連接器的初始版本來建立 。 ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyIoTSiteWiseConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11" } ] }' ``` **注意** 此連接器中的 Lambda 函數具有[長期生命週期](lambda-functions.md#lambda-lifecycle)。 在 AWS IoT Greengrass 主控台中，您可以從群組的連接器頁面新增**連接器**。如需詳細資訊，請參閱[Greengrass 連接器入門 (主控台)](connectors-console.md)。 ## 輸入資料 此連接器不接受 MQTT 訊息做為輸入資料。 ## 輸出資料 此連接器不會將 MQTT 訊息發佈為輸出資料。 ## 限制 此連接器受以下 IoT SiteWise 施加的所有限制的約束，包括以下內容。如需詳細資訊，請參閱《》中的[AWS IoT SiteWise 端點和配額](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)*AWS 一般參考*。 + 每個閘道的數量上限 AWS 帳戶。 + 每個閘道的 OPC-UA 來源數目上限。 + 每個 存放的timestamp-quality-value(TQV) 資料點的最大速率 AWS 帳戶。 + 每個資產屬性儲存的 TQV 資料點最大速率。 ## 授權 ------ #### [ Version 9, 10, 11, and 12 ] IoT SiteWise 連接器包含下列第三方軟體/授權： + [MapDB](https://github.com/jankotek/mapdb/blob/master/LICENSE.txt) + [埃爾森](https://github.com/jankotek/elsa/blob/master/LICENSE.txt) + [Eclipse Milo](https://github.com/eclipse/milo/blob/maintenance/0.2/LICENSE) 此連接器根據 [Greengrass 核心軟體授權合約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)發行。 ------ #### [ Versions 6, 7, and 8 ] IoT SiteWise 連接器包含下列第三方軟體/授權： + [Milo](https://github.com/eclipse/milo/) / EDL 1.0 此連接器根據 [Greengrass 核心軟體授權合約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)發行。 ------ #### [ Versions 1, 2, 3, 4, and 5 ] IoT SiteWise 連接器包含下列第三方軟體/授權： + [Milo](https://github.com/eclipse/milo/) / EDL 1.0 + [Chronicle-Queue](https://github.com/OpenHFT/Chronicle-Queue) / Apache License 2.0 此連接器根據 [Greengrass 核心軟體授權合約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)發行。 ------ ## 變更記錄 下表說明每個版本的連接器的變更。 | 版本 | 改變 | Date | | --- | --- | --- | | 12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v1/developerguide/iot-sitewise-connector.html) | 2021 年 12 月 22 日 | | 11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v1/developerguide/iot-sitewise-connector.html) | 2021 年 3 月 24 日 | | 10 | 設定為`StreamManager`在來源連線中斷並重新建立時改善處理。當沒有可用`ServerTimestamp`時，此版本也接受 OPC-UA `SourceTimestamp` 值與 。 | 2021 年 1 月 22 日 | | 9 | 為自訂 Greengrass `StreamManager` 串流目的地、OPC-UA 不動作帶、自訂掃描模式和自訂掃描速率啟動支援。也包括在從 IoT SiteWise 閘道進行組態更新期間改善的效能。 | 2020 年 12 月 15 日 | | 8 | 改善連接器遇到間歇性網路連線時的穩定性。 | 2020 年 11 月 19 日 | | 7 | 修正閘道指標的問題。 | 2020 年 8 月 14 日 | | 6 | 新增對 CloudWatch 指標和自動探索新 OPC-UA 標籤的支援。此版本需要[串流管理員](stream-manager.md)和 AWS IoT Greengrass Core 軟體 v1.10.0 或更高版本。 | 2020 年 4 月 29 日 | | 5 | 修正 AWS IoT Greengrass Core 軟體 v1.9.4 的相容性問題。 | 2020 年 2 月 12 日 | | 4 | 已修正 OPC-UA 伺服器重新連線的問題。 | 2020 年 2 月 7 日 | | 3 | 移除 `iot:*` 許可需求。 | 2019 年 12 月 17 日 | | 2 | 新增 OPC-UA 秘密資源的支援。 | 2019 年 12 月 10 日 | | 1 | 初始版本。 | 2019 年 12 月 2 日 | Greengrass 群組一次只能包含一個版本的連接器。若要取得有關升級連接器版本的資訊，請參閱[升級連接器版本](connectors.md#upgrade-connector-versions)。 ## 另請參閱 + [使用 Greengrass 連接器來整合服務和通訊協定](connectors.md) + [Greengrass 連接器入門 (主控台)](connectors-console.md) + [Greengrass 連接器入門 (CLI)](connectors-cli.md) + 請參閱*AWS IoT SiteWise 《 使用者指南*》中的下列主題： + [什麼是 AWS IoT SiteWise？](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/) + [使用閘道](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateway-connector.html) + [Gateway CloudWatch 指標](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-metrics.html#gateway-metrics) + [疑難排解 IoT SiteWise 閘道](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting.html#troubleshooting-gateway)