メタデータ インスタンスを作成する

このガイドでは、 メタデータ バケットにクラウド メタデータ インスタンスを作成する方法について説明します。Manufacturing Data Engine(MDE)には、メタデータ インスタンスを作成する 2 つの方法があります。

  1. Metadata API またはウェブ インターフェース(すべてのバケット)。
  2. パーサーから動的に(レコード バケットとタグ バケットのみ)。

始める前に

このガイドを完了するには、メタデータ バケットがすでに 作成されている必要があります

Metadata API またはコンソールを使用してメタデータ インスタンスを作成する

メタデータ インスタンスは、Metadata API または MDE UI で作成できます。API を使用すると、外部ソースからメタデータ インスタンスを MDE に読み込み、参照データを使用してルックアップ バケットにデータを入力できます。

REST API 呼び出しまたはコンソールで次の手順に沿って、クラウド メタデータ インスタンスを作成します。

REST

POST metadata/v1/buckets/BUCKET_NAME/BUCKET_VERSION/instances

{
    "naturalKey": "NATURAL_KEY",
    "instance": METADATA_INSTANCE_OBJECT
}

次のように置き換えます。

  • BUCKET_NAME は、メタデータ インスタンスを作成するバケットの名前に置き換えます。
  • BUCKET_VERSION は、メタデータ インスタンスを作成するメタデータ バケットのバージョンに置き換えます。
  • NATURAL_KEY は、メタデータ インスタンスの自然キーに置き換えます。BUCKET_NAME がタグ バケットに対応している場合は、tagName にする必要があります。BUCKET_NAME がレコード バケットに対応していて、自然キーが省略されている場合、自然キーは値のハッシュに自動的に設定されます。
  • METADATA_INSTANCE_OBJECT は、メタデータ インスタンス オブジェクトに置き換えます。メタデータ インスタンス オブジェクトは、BUCKET_NAMEBUCKET_VERSION に定義されたスキーマに準拠している必要があります。

コンソール

UI の上部メニューの ['CLOUD TAGS'] セクションを開いて、メタデータ インスタンス を作成します。デフォルト ビューには、MDE インスタンスで使用可能なタグ のリストが表示されます。

メタデータ セクション - リスト

UI では、タグ メタデータ バケットの編集のみがサポートされています。他のバケット タイプのインスタンスは、API を使用してのみ作成できます。**タグ メタデータ インスタンス** を作成するには:

  1. リストから選択した [タグ] の ['ACTIONS'] アイコンをクリックします。
  2. ['View / Edit'] を選択します。

    タグ セクション - タグを編集

  3. ['Edit Tag'] サイドメニューで、['Tag Metadata'] セクションを見つけて、 新しいメタデータ インスタンス を編集または追加します。

  4. 実装するバケットのバッジ をクリックします。バケットの属性が下に表示されます。

    [タグ] セクション - タグのメタデータを編集する

  5. 必要に応じて、既存の属性を変更するか、新しい属性を追加します。 これらの属性は編集可能で、変更できます。

  6. フォームの各ボックスに選択した値を追加します。

  7. インスタンスが完成したら、['SAVE'] をクリックします。

  8. インスタンスはバケット スキーマに対して検証されます。検証に成功すると、インスタンスが保存され、成功メッセージが表示されます。このインスタンスは、このタグに対して受信した新しいレコード を修飾する現在の有効なインスタンスになります。

パーサーから動的にメタデータ インスタンスを作成する

メタデータ インスタンス参照の解決に lookup by value メソッドを使用すると、パーサーからメタデータ インスタンスを動的に作成できます。lookup by value メソッドを使用し、指定された自然キーの最新のメタデータ インスタンス値が存在しない場合、MDE は、proto レコードで定義されたインスタンス オブジェクトから、自然キーの新しいメタデータ インスタンスを自動的に作成します。詳細については、 インスタンス値でメタデータ インスタンス ID を解決する方法 に関するドキュメントをご覧ください。