

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

# 从中同步的资源 AWS IoT SiteWise
<a name="tm-sw-asset-sync-map"></a>

本主题列出了您可以从哪些资源同步 AWS IoT SiteWise 到 AWS IoT TwinMaker 工作区。

**重要**  
有关自定义工作空间和默认工作区之间的区别的信息，请参阅[自定义工作空间和默认工作空间之间的区别](tm-sw-default-ws-diffs.md)。

## 自定义和默认工作空间
<a name="tm-sw-asset-sync-both"></a>

**以下资源已同步，可在自定义工作空间和默认工作空间中使用：**

**资产模型**  
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。  
+ `entityId`与 `assetId` in 相同 AWS IoT SiteWise。
+ 这些实体包含一个名为 `sitewiseBase` 的组件，其组件类型与此资产的资产模型相对应。
+ 任何资产级别的替代（例如设置属性别名或计量单位）都将反映在 AWS IoT TwinMaker中的实体中。

## 仅限默认工作空间
<a name="tm-sw-asset-sync-default"></a>

以下资源已同步，**仅在默认工作区中可用**。`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。  
+ `componentName`与 `assetModelCompositeModelId` in 相同 AWS IoT SiteWise。

## 资源未同步
<a name="tm-sw-asset-no-sync"></a>

未同步以下字段：

**非同步资产与资产模型**  
+ 警报模型将作为 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
<a name="tm-sw-asset-sync-component-types"></a>

从中同步资源后 AWS IoT SiteWise，同步的组件类型只能在中读取。 AWS IoT TwinMaker任何更新或删除操作都必须在中完成 AWS IoT SiteWise，如果 SyncJob 仍处于活动状态， AWS IoT TwinMaker 则这些更改会同步到。

同步的实体和 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/)。