建立中繼資料執行個體
本指南說明如何在中繼資料 bucket 中建立雲端中繼資料執行個體。製造業資料引擎 (MDE) 提供兩種建立中繼資料執行個體的方式：
- 透過 Metadata API 或網頁介面 (所有值區)。
- 動態來自剖析器 (僅限記錄和標記值區)。
事前準備
如要完成本指南，您必須先建立中繼資料 bucket。
透過中繼資料 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，並指定要建立中繼資料執行個體的中繼資料 bucket 版本。NATURAL_KEY，其中包含中繼資料執行個體的自然鍵。如果BUCKET_NAME對應至代碼儲存區，則必須為tagName。如果BUCKET_NAME對應至記錄值區，且省略自然鍵，系統會自動將自然鍵設為值的雜湊。METADATA_INSTANCE_OBJECT，其中包含中繼資料執行個體物件。中繼資料例項物件必須符合為BUCKET_NAME和BUCKET_VERSION定義的結構定義。
控制台
開啟 UI 頂端選單的「CLOUD TAGS」(雲端標記) 部分，建立「Metadata Instance」(中繼資料執行個體)。預設檢視畫面會列出 MDE 執行個體中可用的標記：
UI 僅支援編輯標記中繼資料值區。其他 Bucket 類型執行個體只能使用 API 建立。如要建立標記中繼資料例項：
- 在清單中選取的「代碼」上，按一下「動作」圖示。
選取「查看 / 編輯」。
在「Edit Tag」(編輯標記) 側邊選單中，找到「Tag Metadata」(標記中繼資料) 專區，即可編輯或新增 Metadata Instance。
按一下要導入的 Bucket 的「徽章」。值區的屬性會顯示在下方。
視需要修改現有屬性或新增屬性。 這些屬性可編輯及修改。
在表單的每個方塊中新增所選值。
完成後，按一下「儲存」。
然後，系統會根據 Bucket 結構定義驗證執行個體。如果驗證成功，系統會儲存執行個體並顯示成功訊息。這個執行個體會成為目前有效的執行個體，符合這個代碼收到的新記錄資格。
從剖析器動態建立中繼資料執行個體
使用 lookup by value 方法解析中繼資料執行個體參照時，系統會從剖析器動態建立中繼資料執行個體。使用 lookup by value 方法時，如果提供的自然鍵沒有最新的中繼資料例項值，MDE 會自動從 Proto 記錄中定義的例項物件，為自然鍵建立新的中繼資料例項。詳情請參閱這份說明文件，瞭解如何依執行個體值解析中繼資料 instance_id。