本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 與 的資產同步 AWS IoT SiteWise AWS IoT TwinMaker 支援資產 AWS IoT SiteWise 和資產模型的資產同步 （資產同步）。使用 AWS IoT SiteWise 元件類型，資產同步會取得現有的 AWS IoT SiteWise 資產和資產模型，並將這些資源轉換為 AWS IoT TwinMaker 實體、元件和元件類型。下列各節會逐步解說如何設定資產同步，以及哪些 AWS IoT SiteWise 資產和資產模型可以同步到您的 AWS IoT TwinMaker 工作區。 **Topics** + [搭配 使用資產同步 AWS IoT SiteWise](tm-sw-asset-sync-use.md) + [自訂和預設工作區之間的差異](tm-sw-default-ws-diffs.md) + [從 同步的資源 AWS IoT SiteWise](tm-sw-asset-sync-map.md) + [分析同步狀態和錯誤](tm-sw-asset-sync-ts.md) + [刪除同步任務](tm-sw-asset-sync-delete.md) + [資產同步限制](tm-sw-asset-sync-limits.md) # 搭配 使用資產同步 AWS IoT SiteWise 本主題說明如何開啟和設定 AWS IoT SiteWise 資產同步。根據您正在使用的工作區類型，遵循適當的程序。 **重要** [自訂和預設工作區之間的差異](tm-sw-default-ws-diffs.md) 如需自訂和預設工作區間差異的相關資訊，請參閱 。 **Topics** + [使用自訂工作區](tm-sw-custom-ws.md) + [使用 IoTSiteWiseDefaultWorkspace](tm-sw-default-ws.md) # 使用自訂工作區 請先檢閱這些先決條件，再開啟資產同步。 ## 先決條件 使用 之前 AWS IoT SiteWise，必須先完成下列項目： + 您有一個 AWS IoT TwinMaker 工作區。 + 您在 中有資產和資產模型 AWS IoT SiteWise。如需詳細資訊，請參閱[建立資產模型](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/create-asset-models.html)。 + 具有下列 AWS IoT SiteWise 動作讀取許可的現有 IAM 角色： + `ListAssets` + `ListAssetModels` + `DescribeAsset` + `DescribeAssetModel` + IAM 角色必須具有下列 的寫入許可 AWS IoT TwinMaker： + `CreateEntity` + `UpdateEntity` + `DeleteEntity` + `CreateComponentType` + `UpdateComponentType` + `DeleteComponentType` + `ListEntities` + `GetEntity` + `ListComponentTypes` 使用下列 IAM 角色做為所需角色的範本： ``` // trust relationships { { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "iottwinmaker.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] } // permissions - replace ACCOUNT_ID, REGION, WORKSPACE_ID with actual values { "Version": "2012-10-17", "Statement": [{ "Sid": "SiteWiseAssetReadAccess", "Effect": "Allow", "Action": [ "iotsitewise:DescribeAsset" ], "Resource": [ "arn:aws:iotsitewise:REGION:ACCOUNT_ID:asset/*" ] }, { "Sid": "SiteWiseAssetModelReadAccess", "Effect": "Allow", "Action": [ "iotsitewise:DescribeAssetModel" ], "Resource": [ "arn:aws:iotsitewise:REGION:ACCOUNT_ID:asset-model/*" ] }, { "Sid": "SiteWiseAssetModelAndAssetListAccess", "Effect": "Allow", "Action": [ "iotsitewise:ListAssets", "iotsitewise:ListAssetModels" ], "Resource": [ "*" ] }, { "Sid": "TwinMakerAccess", "Effect": "Allow", "Action": [ "iottwinmaker:GetEntity", "iottwinmaker:CreateEntity", "iottwinmaker:UpdateEntity", "iottwinmaker:DeleteEntity", "iottwinmaker:ListEntities", "iottwinmaker:GetComponentType", "iottwinmaker:CreateComponentType", "iottwinmaker:UpdateComponentType", "iottwinmaker:DeleteComponentType", "iottwinmaker:ListComponentTypes" ], "Resource": [ "arn:aws:iottwinmaker:REGION:ACCOUNT_ID:workspace/WORKSPACE_ID", "arn:aws:iottwinmaker:REGION:ACCOUNT_ID:workspace/WORKSPACE_ID/*" ] } ] } ``` 使用下列程序來開啟和設定 AWS IoT SiteWise 資產同步。 1. 在 [AWS IoT TwinMaker 主控台](https://console.aws.amazon.com/iottwinmaker/)中，導覽至**設定**頁面。 1. 開啟**模型來源**索引標籤。 ![\[開啟模型來源索引標籤的 AWS IoT TwinMaker 主控台設定頁面。\]](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/asset-sync-settings.png) 1. 選擇**連線工作區**，將您的 AWS IoT TwinMaker 工作區連結至您的 AWS IoT SiteWise 資產。 **注意** 您只能搭配單一 AWS IoT TwinMaker 工作區使用資產同步。如果您想要在不同工作區中同步，您必須中斷同步與某個工作區的連線，並連線至另一個工作區。 1. 接著，導覽至您要在其中使用資產同步的工作區。 1. 選擇 **Add sources (新增來源)**。這會開啟**新增實體模型來源**頁面。 ![\[新增實體模型來源頁面。\]](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/add-model-source.png) 1. 在**新增實體模型來源**頁面上，確認來源欄位顯示 **AWS IoT SiteWise**。選取您建立做為 IAM 角色先決條件的 **IAM 角色**。 1. 您現在已開啟 AWS IoT SiteWise 資產同步。您應該會在選取的**工作區**頁面頂端看到合規橫幅，確認資產同步處於作用中狀態。您也應該會在**實體模型來源區段中看到列出的同步來源**。 ![\[工作區頁面顯示實體模型來源的清單。\]](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/success-sync.png) # 使用 IoTSiteWiseDefaultWorkspace 當您選擇加入[AWS IoT SiteWiseAWS IoT TwinMaker 整合](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/integrate-tm.html)時，`IoTSiteWiseDefaultWorkspace`會建立名為 的預設工作區，並自動與其同步 AWS IoT SiteWise。 您也可以使用 AWS IoT TwinMaker `CreateWorkspace` API 來建立名為 的工作區`IoTSiteWiseDefaultWorkspace`。 ## 先決條件 在建立 之前`IoTSiteWiseDefaultWorkspace`，請確定您已執行下列動作： + 建立 AWS IoT TwinMaker 服務連結角色。如需詳細資訊，請參閱[使用 的服務連結角色 AWS IoT TwinMaker](using-service-linked-roles.md)。 + 前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。 檢閱角色或使用者，並確認其具有 的許可`iotsitewise:EnableSiteWiseIntegration`。 如有需要，請將許可新增至角色或使用者： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:EnableSiteWiseIntegration", "Resource": "*" } ] } ``` ------ # 自訂和預設工作區之間的差異 **重要** 新 AWS IoT SiteWise 功能，例如 [https://docs.aws.amazon.com//iot-sitewise/latest/userguide/custom-composite-models.html](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/custom-composite-models.html)，僅在 中提供`IoTSiteWiseDefaultWorkspace`。建議您使用預設工作區，而非自訂工作區。 使用 時`IoTSiteWiseDefaultWorkspace`，與使用具有資產同步的自訂工作區有幾個顯著差異。 + 當您建立預設工作區時，Amazon S3 位置和 IAM 角色是選用的。 **注意** 您可以使用 `UpdateWorkspace`提供 Amazon S3 位置和 IAM 角色。 + `IoTSiteWiseDefaultWorkspace` 沒有要同步資源的資源計數限制 AWS IoT SiteWise AWS IoT TwinMaker。 + 當您從 同步資源時 AWS IoT SiteWise，其 `SyncSource` 會是 `SITEWISE_MANAGED`。這包括 `Entities`和 `ComponentTypes`。 + 等新 AWS IoT SiteWise 功能`CompositionModel`僅在 中提供`IoTSiteWiseDefaultWorkspace`。 有幾個特定限制`IoTSiteWiseDefaultWorkspace`，它們是： + 無法刪除預設工作區。 + 若要刪除資源，您必須先刪除 AWS IoT SiteWise 資源，然後 AWS IoT TwinMaker 刪除 中的對應資源。 # 從 同步的資源 AWS IoT SiteWise 本主題列出您可以從 同步 AWS IoT SiteWise 到 AWS IoT TwinMaker 工作區的資產。 **重要** [自訂和預設工作區之間的差異](tm-sw-default-ws-diffs.md) 如需自訂和預設工作區間差異的相關資訊，請參閱 。 ## 自訂和預設工作區 下列資源已同步，並可在****自訂和預設工作區中使用： **資產模型** AWS IoT TwinMaker 在 中為每個資產模型建立新的元件類型 AWS IoT SiteWise。 + 資產模型`TypeId`的 元件將使用下列其中一種模式： + **自訂工作區 - ** `iotsitewise.assetmodel:assetModelId` + **預設工作區 -** `assetModelId` + 資產模型中的每個屬性都是元件類型的新屬性，具有下列其中一個命名模式： + **自訂工作區 - ** `Property_propertyId` + **預設工作區 - ** `propertyId` 中的屬性名稱 AWS IoT SiteWise 會儲存為 屬性定義`displayName`中的 。 + 資產模型中的每個階層都是 類型的新屬性，`LIST`而 `nestedType` 位於 元件類型`RELATIONSHIP`中。階層會對應至名稱字首為下列其中一項的 屬性： + **自訂工作區 - ** `Hierarchy_hierarchyId` + **預設工作區 - ** `hierarchyId` **資產** AWS IoT TwinMaker 會為其中的每個資產建立新的實體 AWS IoT SiteWise。 + 與 `assetId`中的 `entityId` 相同 AWS IoT SiteWise。 + 這些實體有一個名為 的單一元件`sitewiseBase`，其元件類型對應至此資產的資產模型。 + 任何資產層級覆寫，例如設定屬性別名或度量單位，都會反映在 實體中 AWS IoT TwinMaker。 ## 僅限預設工作區 下列資產已同步，**且僅適用於預設工作區** `IoTSiteWiseDefaultWorkspace`。 **AssetModelComponents** AWS IoT TwinMaker 會為每個 `AssetModelComponents` 中的 建立新的元件類型 AWS IoT SiteWise。 + 資產模型`TypeId`的 元件使用以下模式：`assetModelId`。 + 資產模型中的每個屬性都是元件類型中的新屬性，屬性名稱為 `propertyId`。中的屬性名稱 AWS IoT SiteWise 會儲存為 屬性定義`displayName`中的 。 + 資產模型中的每個階層都是 類型的新屬性，`LIST`而 `nestedType` 位於 元件類型`RELATIONSHIP`中。階層會映射至名稱字首為 的 屬性`hierarchyId`。 **AssetModelCompositeModel** AWS IoT TwinMaker 會為每個 `AssetModelCompositeModel` 中的 建立新的元件類型 AWS IoT SiteWise。 + 資產模型`TypeId`的 元件使用以下模式：`assetModelId_assetModelCompositeModelId`。 + 資產模型中的每個屬性都是元件類型中的新屬性，屬性名稱為 `propertyId`。中的屬性名稱 AWS IoT SiteWise 會儲存為 屬性定義`displayName`中的 。 **AssetCompositeModels** AWS IoT TwinMaker 會為每個 `AssetCompositeModel` 中的 建立新的複合元件 AWS IoT SiteWise。 + 與 `assetModelCompositeModelId`中的 `componentName` 相同 AWS IoT SiteWise。 ## 資源未同步 下列資源不會同步： **非同步資產和資產模型** + 警示模型將同步為 compositeModels但與警示相關的資產中的對應資料不會同步。 + [AWS IoT SiteWise 資料串流](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/manage-data-streams.html)不會同步。只會同步在資產模型中建模的屬性。 + 屬性、測量、轉換、彙總和中繼資料計算的屬性值，例如公式和視窗不會同步。只會同步有關屬性的中繼資料，例如別名、度量單位和資料類型。您可以使用一般 AWS IoT TwinMaker 資料連接器 API [ GetPropertyValueHistory](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html) 查詢值。 ## 在 中使用同步實體和元件類型 AWS IoT TwinMaker 從中同步資產後 AWS IoT SiteWise，同步的元件類型將僅供讀取 AWS IoT TwinMaker。任何更新或刪除動作都必須在 中完成 AWS IoT SiteWise， AWS IoT TwinMaker 如果 syncJob 仍在作用中，這些變更會同步至 。 同步的實體和 AWS IoT SiteWise 基本元件也會唯讀 AWS IoT TwinMaker。您可以將其他非同步元件新增至同步的實體，只要沒有實體層級屬性，例如描述或`entityName`已更新。 有些限制適用於如何與同步實體互動。您無法在同步實體階層中的同步實體下建立子實體。此外，您無法建立從同步元件類型延伸的非同步元件類型。 **注意** 如果在 中刪除資產， AWS IoT SiteWise 或者您刪除同步任務，其他元件會與實體一起刪除。 您可以在 Grafana 儀表板中使用這些同步實體，並將其新增為場景編寫器中的標籤，例如一般實體。您也可以為這些同步的實體發出知識圖表查詢。 **注意** 不會收取未修改的同步實體費用，但如果已進行變更，則會向您收取這些實體的費用 AWS IoT TwinMaker。例如，如果您將非同步元件新增至同步的實體，該實體現在會計費 AWS IoT TwinMaker。如需詳細資訊，請參閱[AWS IoT TwinMaker 定價](https://aws.amazon.com//iot-twinmaker/pricing/)。 # 分析同步狀態和錯誤 本主題提供如何分析同步錯誤和狀態的指引。 **重要** [自訂和預設工作區之間的差異](tm-sw-default-ws-diffs.md) 如需自訂和預設工作區間差異的相關資訊，請參閱 。 ## 同步任務狀態 同步任務具有下列其中一種狀態，視其狀態而定。 + 同步任務`CREATING`狀態表示任務正在檢查許可，並從 載入資料 AWS IoT SiteWise 以準備同步。 + 同步任務`INITIALIZING`狀態表示 中的所有現有資源 AWS IoT SiteWise 都會同步至 AWS IoT TwinMaker。如果使用者擁有大量資產和資產模型，此步驟可能需要更長的時間才能完成 AWS IoT SiteWise。您可以在 [AWS IoT TwinMaker 主控台](https://console.aws.amazon.com/iottwinmaker/)中檢查同步任務，或呼叫 `ListSyncResources` API 來監控已同步的資源數量。 + 同步任務`ACTIVE`狀態表示初始化步驟已完成。任務現在已準備好同步來自 的任何新更新 AWS IoT SiteWise。 + 同步任務`ERROR`狀態表示具有上述任何狀態的錯誤。檢閱錯誤訊息。IAM 角色設定可能有問題。如果您想要使用新的 IAM 角色，請刪除發生錯誤的同步任務，並使用新角色建立新的任務。 同步錯誤會出現在模型來源頁面中，該頁面可從工作區中的**實體模型來源**資料表存取。模型來源頁面會顯示無法同步的資源清單。大多數錯誤都會由同步任務自動重試，但如果資源需要 動作，則會保持 `ERROR` 狀態。您也可以使用 [ ListSyncResources](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListSyncResources.html) API 取得錯誤清單。 若要查看目前來源列出的所有錯誤，請使用下列程序。 1. 在 [AWS IoT TwinMaker 主控台](https://console.aws.amazon.com/iottwinmaker/)中導覽至您的工作區。 1. 選取**實體模型** AWS IoT SiteWise 來源模態中列出的來源，以開啟資產同步詳細資訊頁面。 ![\[AWS IoT SiteWise 來源頁面會顯示資產同步詳細資訊，包括錯誤。\]](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/synced-resources.png) 1. 如上述螢幕擷取畫面所示，任何持續發生錯誤的資源都會列在**錯誤**表格中。您可以使用此表格來追蹤和修正與特定資源相關的錯誤。 可能的錯誤包括下列項目： + 雖然 AWS IoT SiteWise 支援重複的資產名稱，但 AWS IoT TwinMaker 僅在 `ROOT`層級支援它們，而不是在相同的父實體下。如果您在 的父實體下有兩個同名資產 AWS IoT SiteWise，其中一個資產無法同步。若要修正此錯誤，請在同步 AWS IoT SiteWise 之前刪除其中一個資產，或在不同的父項資產下移動其中一個資產。 + 如果您已有與資產 ID 具有相同 ID 的 AWS IoT SiteWise 實體，該資產會無法同步，直到您刪除現有的實體為止。 # 刪除同步任務 使用下列程序刪除同步任務。 **重要** [自訂和預設工作區之間的差異](tm-sw-default-ws-diffs.md) 如需自訂和預設工作區間差異的相關資訊，請參閱 。 1. 導覽至 [AWS IoT TwinMaker 主控台](https://console.aws.amazon.com/iottwinmaker/)。 1. 開啟您要從中刪除同步任務的工作區。 1. 在**實體模型來源**下，選取要 AWS IoT SiteWise 開啟來源詳細資訊頁面的來源。 1. 若要停止同步任務，請選擇**中斷連線**。確認您的選擇，以完全刪除同步任務。 ![\[Disconnect AWS IoT SiteWise 同步對話方塊具有取消或中斷同步任務的按鈕。\]](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/confirm-delete.png) 刪除同步任務後，您可以在相同或不同的工作區中再次建立同步任務。 如果工作區中有任何同步任務，則無法刪除工作區。在刪除工作區之前，請先刪除同步任務。 如果在刪除同步任務期間發生任何錯誤，同步任務會保持 `DELETING` 狀態，並自動重試。如果有任何與刪除資源相關的錯誤，您現在可以手動刪除任何同步的實體或元件類型。 **注意** 首先 AWS IoT SiteWise 刪除從 同步的任何資源，然後刪除同步任務本身。 # 資產同步限制 **重要** [自訂和預設工作區之間的差異](tm-sw-default-ws-diffs.md) 如需自訂和預設工作區間差異的相關資訊，請參閱 。 由於[AWS IoT SiteWise 配額](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html)高於預設[AWS IoT TwinMaker 配額](https://docs.aws.amazon.com//general/latest/gr/iot-twinmaker.html)，因此我們正在增加從 同步的實體和元件類型的下列限制 AWS IoT SiteWise。 + 工作區中的 1000 個同步元件類型，因為它只能從中同步 1000 個資產模型 AWS IoT SiteWise。 + 工作區中 100，000 個同步的實體，因為它只能從中同步 100，000 個資產 AWS IoT SiteWise。 + 每個父實體最多 2000 個子實體。它會同步每個單一父系資產的 2000 個子資產。 **注意** [GetEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetEntity.html) API 只會傳回階層屬性的前 50 個子實體，但您可以使用 [GetPropertyValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValue.html) API 來分頁和擷取所有子實體的清單。 + 每個同步元件 600 個屬性 AWS IoT SiteWise，可同步具有 600 個屬性和階層的資產模型。 **注意** 這些限制僅適用於同步的實體。如果您需要增加非同步資源的這些限制，請請求增加配額。