创建元数据实例
本指南介绍了如何在元数据存储分区中创建云元数据实例。Manufacturing Data Engine (MDE) 提供两种创建元数据实例的方式:
- 通过 Metadata API 或网页界面(所有存储分区)。
- 动态(仅限记录和标记存储分区)。
准备工作
如需完成本指南,您需要已创建元数据存储桶。
通过元数据 API 或控制台创建元数据实例
您可以通过 Metadata API 或 MDE 界面创建元数据实例。您可以使用该 API 将元数据实例从外部来源加载到 MDE 中,并使用参考数据填充查找桶。
按照以下说明,使用 REST API 调用或控制台创建云元数据实例:
REST
POST metadata/v1/buckets/BUCKET_NAME/BUCKET_VERSION/instances
{
"naturalKey": "NATURAL_KEY",
"instance": METADATA_INSTANCE_OBJECT
}
替换以下内容:
- 将
BUCKET_NAME替换为要在其中创建元数据实例的存储桶的名称。 BUCKET_VERSION,用于指定要在哪个版本的元数据存储桶中创建元数据实例。NATURAL_KEY,其中包含元数据实例的自然键。如果BUCKET_NAME对应于标记桶,则必须为tagName。如果BUCKET_NAME对应于记录桶,并且省略了自然键,则自然键会自动设置为值的哈希。- 将
METADATA_INSTANCE_OBJECT替换为元数据实例对象。元数据实例对象必须符合为BUCKET_NAME和BUCKET_VERSION定义的架构。
控制台
打开界面顶部菜单中的 CLOUD TAGS 部分,以创建 Metadata Instance。默认视图会显示 MDE 实例中可用标记的列表:

界面仅支持修改标记元数据桶。其他类型的存储分区实例只能使用 API 创建。如需创建标记元数据实例,请执行以下操作:
- 点击列表中所选代码中的操作图标。
选择查看 / 修改。

在修改标记侧边菜单中,找到标记元数据部分,以修改或添加新的元数据实例。
点击要实现的 Bucket 的徽章。相应分桶的属性会显示在下方。

根据需要修改现有属性或添加新属性。 这些属性可供修改。
在表单的每个框中添加所选值。
实例完成后,点击保存。
然后,系统会根据 Bucket 架构验证实例。如果验证成功,系统会存储实例并显示成功消息。此实例将成为当前有效实例,用于限定为此代码收到的新记录。
通过解析器动态创建元数据实例
当您使用 lookup by value 方法解析元数据实例引用时,可以从解析器动态创建元数据实例。当您使用 lookup by value 方法时,如果所提供自然键的最新元数据实例值不存在,MDE 会自动根据 proto 记录中定义的实例对象为该自然键创建新的元数据实例。如需了解详情,请参阅如何通过实例值解析元数据 instance_id 文档。