创建类型版本

本指南介绍如何在 Manufacturing Data Engine (MDE) 中为现有类型创建新类型版本。

准备工作

在开始为现有类型创建新类型版本之前，您需要 了解如何创建类型。

版本控制限制

创建类型的新版本时，请考虑以下限制：

新版本可以：

  • 向数据架构添加新的可选字段。
  • 在数据架构中将必填字段标记为可选字段。
  • 添加新的元数据存储桶引用。

新版本不可以：

  • 从数据架构中移除字段。
  • 更改数据架构中现有字段的数据类型。
  • 在数据架构中将可选属性标记为必填属性。
  • 移除元数据存储桶引用。

创建新类型版本

您可以使用 API 或控制台创建新类型版本，将新元数据存储桶与已具有现有元数据存储桶关联的现有类型相关联，并应用典型的存储规范。

REST

执行以下 REST API 请求：

POST /configuration/v1/types/TYPE_NAME/versions

{
  "metadataBuckets": [
    {
      "bucketName": "EXISTING_BUCKET_NAME",
      "version": "EXISTING_BUCKET_VERSION"
    },
    {
      "bucketName": "NEW_BUCKET_NAME",
      "version": "NEW_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"
    }
  ]
}

替换以下内容：

  • TYPE_NAME：要为其创建新版本的类型的名称。
  • EXISTING_BUCKET_NAME：已与此类型关联的现有存储桶的名称。
  • EXISTING_BUCKET_VERSION：已与此类型关联的现有存储桶的版本。
  • NEW_BUCKET_NAME：新存储桶的名称。
  • NEW_BUCKET_VERSION：新存储桶的版本。

控制台

  1. 如需使用控制台创建新的类型版本 ，请打开类型 部分标签页。

    “类型”部分 - 类型列表

  2. 此部分列出了 MDE 实例中的所有可用类型。该列表显示了每种类型的基本配置，包括：

  • 名称：类型的唯一名称。所有类型都必须具有不同的唯一名称。
  • 存储：显示与该类型关联的当前存储规范。
  • 原型：显示定义该类型的原型的名称。 每种类型都与一个唯一的原型相关联。创建类型后，无法修改原型关联。
  • 版本：类型的版本号。类型可以进行版本控制。此列表中的默认视图仅显示该类型的最新可用版本。您可以取消选中显示最新版本 复选框来显示较早的版本。
  • 元数据：为与该类型关联的每个元数据存储桶 呈现一个颜色编码的徽章。标记元数据存储分区与记录元数据存储分区通过徽章内的特定图标进行区分。
    • 转换：为与该类型关联的每种转换类型显示一个徽章 。
  • 已启用：如果该类型已启用，则显示 true 值； 如果未启用，则显示 false 值。用户可以随时启用或停用类型。
  • 有效：创建类型后，需要一定的时间来预配。 在预配类型时，其有效状态为 false。准备就绪后，它们会显示为 true。

  1. 如需在此网页界面中创建新的类型版本 ，请点击操作 图标，然后点击创建新版本 。系统会显示以下表单：

    “类型”部分 - 类型列表

  2. 系统会打开创建新类型版本 ，显示一个用于修改 所选 类型 的设置的表单：

    “类型”部分 - 类型列表

表单的顶部部分显示了类型的名称和原型。这些属性无法修改。只有更改元数据规范或修改数据架构才会触发新类型版本。修改其余类型参数会更新类型，但不需要新版本。

元数据规范和数据架构都可以通过添加新元素进行修改。但是，所有新类型版本都需要向后兼容。无法通过移除元数据存储分区来创建类型的新版本。您可以打开元数据存储分区 部分来添加新的元数据存储分区。