タイプ バージョンを作成する

このガイドでは、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. コンソールを使用して新しいタイプ バージョン を作成するには、[タイプ] セクションのタブを開きます。

    Types セクション - 型のリスト

  2. このセクションには、MDE インスタンスで使用可能なすべてのタイプが一覧表示されます。リストには、各タイプの基本的な構成が表示されます。

  • 名前: タイプの固有の名前。すべてのタイプに異なる固有の名前を付ける必要があります。
  • ストレージ: タイプに関連付けられている現在のストレージ仕様が表示されます。
  • アーキタイプ: タイプを定義するアーキタイプの名前が表示されます。 各タイプは一意のアーキタイプに関連付けられています。タイプの作成後にアーキタイプの関連付けを変更することはできません。
  • バージョン: タイプのバージョン番号。タイプはバージョニングできます。このリストのデフォルト ビューには、タイプで使用可能な最新バージョンのみが表示されます。[最新バージョンを表示] チェックボックスをオフにすると、以前のバージョンを表示できます。
  • メタデータ: タイプに関連付けられているメタデータ バケットごとに色分けされたバッジが表示されます。タグ メタデータ バケットは、バッジ内の特定のアイコンを使用してレコード メタデータ バケットと区別されます。
    • 変換: タイプに関連付けられている変換タイプごとにバッジが表示されます。
  • 有効: タイプが有効な場合は true 値が表示され、 有効でない場合は false 値が表示されます。ユーザーはいつでもタイプを有効または無効にできます。
  • 有効: タイプの作成にはプロビジョニングに時間がかかります。 タイプがプロビジョニングされている間、有効ステータスは false です。準備が整うと、true と表示されます。
  1. このウェブ インターフェースで新しいタイプ バージョン を作成するには、[操作] アイコンをクリックして [新しいバージョンを作成] をクリックします。次のフォームが表示されます。

    「型」セクション - 型のリスト

  2. [新しいタイプ バージョンを作成] が開き、選択した タイプ の設定を変更するフォームが表示されます。

    「型」セクション - 型のリスト

フォームの上部には、タイプの名前とアーキタイプが表示されます。これらの属性は変更できません。メタデータ仕様を変更するか、データスキーマを変更すると、新しいタイプ バージョンがトリガーされます。他のタイプ パラメータを変更しても、タイプは更新されますが、新しいバージョンは必要ありません。

メタデータ仕様とデータスキーマは、新しい要素を追加することで変更できます。ただし、新しいタイプ バージョンはすべて下位互換性がある必要があります。メタデータ バケットを削除して、タイプの新しいバージョンを作成することはできません。[メタデータ バケット] セクションを開くと、新しいメタデータ バケットを追加できます。