メタデータ バケット バージョンを作成する
このガイドでは、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。指定されたインスタンスを特定の自然キーの最新のインスタンスとマージして新しいインスタンスを作成するか、指定されたとおりに新しいインスタンスを作成するかを決定します。
コンソール
新しいメタデータ バケット バージョン を作成するには、Cloud Management MC ウェブ インターフェースの [METADATA] セクションで [Create New Version] をクリックします。
新しいメタデータ バケット バージョンのパラメータを更新するフォームを含む構成パネルが表示されます。
新しいバージョンでは、下位互換性のある 変更のみが許可されます。新しい変更、破壊的な変更、変更を行うには、新しいバケットを作成する必要があります。 パネルでは、次の項目を更新できます。
- インスタンス更新モード: バケットのインスタンス取り込み動作を変更します。
- メタデータ スキーマ: バケットの既存のスキーマに新しい属性を追加します。
変更を実装したら、[CREATE] をクリックしてメタデータ バケットの新しいバージョンを保存します。
変更が失敗すると、エラー メッセージが表示されます。変更が成功すると、成功メッセージが表示されます。新しいバージョン番号は連番で、バケットに自動的に割り当てられます。