型バージョンを作成する

このガイドでは、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: 新しいバケットのバージョン。

コンソール

コンソールを使用して新しいタイプバージョンを作成するには、[タイプ] セクションタブを開きます。
MDE インスタンスで使用可能なすべてのタイプがこのセクションに一覧表示されます。このリストには、各タイプの基本的な構成が表示されます。

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

このウェブインターフェースで新しいタイプバージョンを作成するには、[アクション] アイコンをクリックし、[新しいバージョンを作成] をクリックします。次のフォームが表示されます。
[Create New Type Version] が開き、選択したタイプの設定を変更するフォームが表示されます。

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

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