创建类型
本指南介绍了如何在 Manufacturing Data Engine (MDE) 中创建新类型。您可以使用配置 API 或 MDE 网页界面创建类型。
准备工作
在其他配置设置中，类型可让您定义相应类型记录的背景信息添加范围 - 可用于或必须用于添加记录背景信息的元数据桶。如果您想将元数据存储桶与某种类型相关联，首先需要创建该存储桶。如需了解详情，请参阅如何创建元数据存储桶。
类型命名
创建类型时，名称在 MDE 部署中必须是唯一的。类型名称不得包含空格或特殊字符，例如 &、@ 或 %。
创建类型
如需创建具有一个元数据存储桶关联和典型存储规范的类型，您可以使用终端或控制台界面。
REST
执行以下 REST API 请求：
POST /configuration/v1/types
{
"archetype": "ARCHETYPE NAME",
"name": "TYPE_NAME",
"metadataBuckets": [
{
"bucketName": "BUCKET_NAME",
"version": "BUCKET_VERSION"
}
],
"storageSpecs": [
{
"sink": "BIG_QUERY",
"disabled": "false",
"materializeCloudMetadata": "true"
},
{
"sink": "BIG_TABLE",
"disabled": "false",
"materializeCloudMetadata": "false"
},
{
"sink": "GCS",
"disabled": "false",
"materializeCloudMetadata": "false"
},
{
"sink": "PUBSUB_PROTO",
"disabled": "false",
"materializeCloudMetadata": "false"
},
{
"sink": "PUBSUB_JSON",
"disabled": "false",
"materializeCloudMetadata": "false"
}
]
}
替换以下内容：
ARCHETYPE：原型名称。DISCRETE_DATA_SERIES、CLUSTERED_DISCRETE_DATA_SERIES、NUMERIC_DATA_SERIES、CLUSTERED_NUMERIC_DATA_SERIES、CONTINUOUS_DATA_SERIES、CLUSTERED_CONTINUOUS_DATA_SERIES之一。TYPE_NAME：要创建的类型的名称。BUCKET_NAME：要与此类型关联的存储桶的名称。BUCKET_VERSION：要与此类型相关联的桶的版本。
控制台
如需使用控制台创建新的类型，请打开类型部分标签页。
此部分列出了 MDE 实例中的所有可用类型。该列表显示了每种类型的基本配置，包括：
- 名称：类型的唯一名称。所有类型的名称必须各不相同。
- 存储：显示与相应类型关联的当前存储规范。
- 原型：显示定义类型的原型的名称。 每种类型都与一个唯一的原型相关联。创建类型后，无法修改原型关联。
- 版本：类型的版本号。类型可以进行版本控制。此列表中的默认视图仅显示相应类型的最新可用版本。您可以取消选中显示最新版本复选框，以显示旧版本。
- 元数据：为与类型相关联的每个元数据桶呈现一个彩色徽章。标记元数据存储分区与记录元数据存储分区的区别在于徽章内有一个特定图标。
- 转换：显示与相应类型关联的每种转换类型的徽章。
- 已启用：如果类型已启用，则显示
true值；如果未启用，则显示false值。您可以随时启用或停用这些类型。 - 有效：创建类型需要一定的配置时间。
在预配类型时，其有效状态为
false。准备就绪后，它们会显示为true。
每种新类型在创建时都会预配自己的基础架构，以存储其标记和所有数据接收器的记录。例如，新类型会在 BigQuery 中创建一个新表，其中包含该类型的新名称，并会自动填充与其原型对应的架构。在预配类型时，该类型会显示为 Non Active。
如需创建新的类型，请点击添加新类型。系统会显示以下表单：
如需定义新的类型，请提供其名称和原型。创建类型后，其名称和原型便无法更改。所有类型的名称都必须各不相同。必须从可用的原型列表中选择原型。您无法创建或修改现有原型，因为它们是系统配置的一部分。
打开数据架构部分，根据需要定义
JSON schema，以定义新类型的数据字段：
数据架构必须是有效的
JSON Schema，否则将不被接受。此数据架构不会作为提取流水线的一部分强制执行。在未来的 MDE 版本中，系统将根据传入消息的数据对象类型的数据架构来验证该数据对象。数据架构可让您了解不同数据接收器中可用的数据字段的结构。还需要根据原型特征定义每个数据架构规范。通过定义与类型关联的元数据桶来完成新类型的定义，方法是打开元数据桶部分：
如需向类型添加元数据桶，请点击添加。
从可用的元数据存储分区列表中选择要添加的存储分区。系统仅显示这些存储桶的最新版本。您可以在以后创建新的元数据存储桶版本来更新元数据存储桶版本。添加分桶后，元数据部分会显示一个新标记。
打开表单的存储设置部分，定义默认存储设置。在此部分中，有一个切换按钮，用于切换此 MDE 实例中可用的每个数据接收器。
选择默认情况下存储属于此类型的标记的每个接收器。创建标记时，标记会继承存储空间规范。您可以随时在标记级层修改存储空间规范。
如需完成新类型的定义，请打开转换和连接部分，选择与此类型关联的转换。
选择要与类型关联的转换，并根据如何配置转换定义其参数。
添加完所有形参后，点击 CREATE（创建）保存新的类型。如果有任何参数不正确，系统会显示一条错误消息。如果操作成功，系统会显示一条确认消息。