创建元数据存储桶版本

本指南介绍了如何在 Manufacturing Data Engine (MDE) 中为现有存储桶创建新的元数据存储桶版本。

借助元数据存储桶版本，您可以演变存储桶架构。类型和解析器始终引用特定的存储桶版本，因此，当您创建新版本时，它不会影响现有的数据处理流水线。您必须升级类型和解析器，或创建新的类型和解析器，才能使用新的存储桶版本。 您可以使用配置 API 或 MDE 网页界面创建元数据存储桶版本。

准备工作

本指南要求您已为 MDE 创建 元数据存储桶 。

版本控制限制

创建存储桶的新版本时，请考虑以下限制：

新版本可以：

• 添加新的可选字段。
• 将必填字段标记为可选。

新版本不可以：

• 移除字段。
• 更改现有字段的数据类型。
• 将可选属性标记为必填。

创建新的元数据存储桶版本

您可以使用终端或控制台创建元数据存储桶版本。

REST

执行以下 REST API 请求：

POST /metadata/v1/buckets/BUCKET_NAME/versions

{
  "schema": "BUCKET_SCHEMA",
  "provider": "local"
}

替换以下内容：

• BUCKET_NAME：要创建的存储桶的名称。
• BUCKET_TYPE：要创建的存储桶的类型。必须是 TAG、RECORD 或 LOOKUP 之一。TAG 存储桶中元数据实例的 natural_key 必须是标记名称。RECORD 存储桶中元数据实例的 natural_key 可以是任何键。LOOKUP 存储桶中元数据实例的 natural_key 可以是任何键，但记录无法引用查找存储桶中的实例，并且这些实例不会写入任何数据接收器。查找存储分区仅用作参考数据的来源，解析器可以使用 Whistle 函数 lookupByKey 检索这些数据，并用于扩充记录。
• BUCKET_SCHEMA：存储桶的 JSON 架构。该架构限制了可在存储桶中创建的实例。
• INSTANCE_OVERWRITE_MODE：TRUE 或 FALSE。用于确定是合并提供的实例和给定自然键的最新实例来创建新实例，还是按提供的方式创建新实例。

控制台

1. 如需创建新的元数据存储桶版本 ，请在 Cloud Management MC 网页界面的元数据 部分点击创建新版本 ：

   

2. 系统会显示一个配置面板，其中包含一个用于更新 新 元数据存储桶版本的参数的表单：

   

   新版本仅允许进行向后兼容 的更改。如需进行新的重大更改，需要创建新的存储桶。 您可以在面板中更新以下内容：

   • 实例更新模式：更改 存储桶的实例提取行为。
   • 元数据架构：向 存储桶的现有架构添加新属性。

3. 实施更改后，点击创建 以保存元数据存储桶的新版本。

4. 如果更改失败，系统会显示错误消息。如果更改成功，系统会显示成功消息。新版本号是按顺序自动分配给存储桶的。