建立中繼資料 bucket 版本

本指南說明如何在 Manufacturing Data Engine (MDE) 中，為現有值區建立新的中繼資料值區版本。

中繼資料 bucket 版本可讓您演進 bucket 結構定義。型別和剖析器一律會參照特定 bucket 版本，因此建立新版本時，不會影響現有的資料處理管道。您必須升級型別和剖析器，或建立新的型別和剖析器，才能使用新版 bucket。您可以使用設定 API 或 MDE 網頁介面建立中繼資料 bucket 版本。

事前準備

本指南假設您已為 MDE 建立中繼資料 bucket。

版本限制

建立值區的新版本時，請注意下列限制：

新版本可能：

• 新增選填欄位。
• 將必填欄位標示為選填。

新版本可能無法：

• 移除欄位。
• 變更現有欄位的資料類型。
• 將選填屬性標示為必填。

建立新的中繼資料 bucket 版本

您可以使用終端機或控制台建立中繼資料 bucket 版本。

REST

執行下列 REST API 要求：

POST /metadata/v1/buckets/BUCKET_NAME/versions

{
  "schema": "BUCKET_SCHEMA",
  "provider": "local"
}

更改下列內容：

• BUCKET_NAME：要建立的 bucket 名稱。
• BUCKET_TYPE：要建立的 bucket 類型。必須是 TAG、RECORD 或 LOOKUP。TAG 值區中繼資料例項的 natural_key 必須是標記名稱。RECORD bucket 中中繼資料例項的 natural_key 可以是任何鍵。LOOKUP 值區中繼資料執行個體的 natural_key 可以是任何鍵，但記錄無法參照查詢值區中的執行個體，且執行個體不會寫入任何資料接收器。查閱值區僅做為參考資料來源，可供剖析器使用 Whistle 函式 lookupByKey 擷取，並用於擴充記錄。
• BUCKET_SCHEMA：buckets 的 JSON 結構定義。結構定義會限制可在值區中建立的執行個體。
• INSTANCE_OVERWRITE_MODE：TRUE 或 FALSE。判斷是否要透過合併提供的執行個體與特定自然鍵的最新執行個體，來建立新執行個體，或是要照原樣建立新執行個體。

控制台

1. 如要建立新的中繼資料 bucket 版本，請在 Cloud Management MC 網頁介面的「METADATA」(中繼資料) 區段中，按一下「Create New Version」(建立新版本)：

   

2. 系統會顯示設定面板，內含可更新新中繼資料 bucket 版本參數的表單：

   

   新版本只能進行回溯相容的變更。如要新增、中斷或變更，必須建立新的 bucket。 您可以在面板中更新下列項目：

   • 執行個體更新模式：變更值區的執行個體擷取行為。
   • 中繼資料結構定義：在 bucket 的現有結構定義中新增屬性。

3. 完成變更後，按一下「建立」即可儲存新版中繼資料 bucket。

4. 如果變更失敗，系統會顯示錯誤訊息。如果變更成功，系統會顯示成功訊息。新版本號碼會依序遞增，並自動指派給 bucket。