创建元数据实例

本指南介绍了如何在元数据存储分区中创建云元数据实例。Manufacturing Data Engine (MDE) 提供两种创建元数据实例的方式:

  1. 通过 Metadata API 或网页界面(所有存储分区)。
  2. 动态(仅限记录和标记存储分区)。

准备工作

如需完成本指南,您需要已创建元数据存储桶

通过元数据 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_NAMEBUCKET_VERSION 定义的架构。

控制台

打开界面顶部菜单中的 CLOUD TAGS 部分,以创建 Metadata Instance。默认视图会显示 MDE 实例中可用标记的列表:

元数据部分 - 列表

界面仅支持修改标记元数据桶。其他类型的存储分区实例只能使用 API 创建。如需创建标记元数据实例,请执行以下操作:

  1. 点击列表中所选代码中的操作图标。
  2. 选择查看 / 修改

    “标记”部分 -“修改标记”

  3. 修改标记侧边菜单中,找到标记元数据部分,以修改或添加新的元数据实例

  4. 点击要实现的 Bucket 的徽章。相应分桶的属性会显示在下方。

    代码部分 - 修改代码元数据

  5. 根据需要修改现有属性或添加新属性。 这些属性可供修改。

  6. 在表单的每个框中添加所选值。

  7. 实例完成后,点击保存

  8. 然后,系统会根据 Bucket 架构验证实例。如果验证成功,系统会存储实例并显示成功消息。此实例将成为当前有效实例,用于限定为此代码收到的新记录

通过解析器动态创建元数据实例

当您使用 lookup by value 方法解析元数据实例引用时,可以从解析器动态创建元数据实例。当您使用 lookup by value 方法时,如果所提供自然键的最新元数据实例值不存在,MDE 会自动根据 proto 记录中定义的实例对象为该自然键创建新的元数据实例。如需了解详情,请参阅如何通过实例值解析元数据 instance_id 文档。