建立型別版本
本指南說明如何在 Manufacturing Data Engine (MDE) 中，為現有型別建立新的型別版本。
事前準備
如要為現有型別建立新版本，請先閱讀如何建立型別。
版本限制
建立新版本的型別時，請注意下列限制：
新版本可能：
- 在資料結構定義中新增選填欄位。
- 在資料結構定義中將必填欄位標示為選填。
- 新增中繼資料值區參照。
新版本可能無法：
- 從資料結構定義中移除欄位。
- 變更資料結構定義中現有欄位的資料類型。
- 在資料架構中將選用屬性標示為必要屬性。
- 移除中繼資料 bucket 參照。
建立新的型別版本
您可以建立新的類型版本，將新的中繼資料 bucket 關聯至現有類型 (該類型已與現有中繼資料 bucket 建立關聯)，並使用 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：已與這個類型建立關聯的現有 bucket 名稱。EXISTING_BUCKET_VERSION：已與這個類型建立關聯的現有 bucket 版本。NEW_BUCKET_NAME：新 bucket 的名稱。NEW_BUCKET_VERSION：新值區的版本。
控制台
如要使用控制台建立新的「類型版本」，請開啟「類型」部分的分頁。
本節列出 MDE 執行個體中的所有可用類型。清單會顯示每種基本設定，包括：
- 名稱：類型的專屬名稱。所有型別的名稱都不得重複。
- 儲存空間：顯示與類型相關聯的目前儲存空間規格。
- 原型：顯示定義類型的原型名稱。 每種型別都與獨一無二的原型相關聯。類型建立後，即無法修改原型關聯。
- 版本：類型的版本號碼。型別可以進行版本控管。這份清單的預設檢視畫面只會顯示該類型可用的最新版本。如要顯示舊版，請取消勾選「顯示最新版本」核取方塊。
- 中繼資料：為與類型相關聯的每個中繼資料值區，顯示以顏色編碼的徽章。標記中繼資料值區與記錄中繼資料值區的差異在於，徽章內有特定圖示。
- 轉換：顯示與類型相關聯的每個轉換類型徽章。
- 已啟用：如果類型已啟用，則顯示
true值；如果未啟用，則顯示false值。使用者隨時可以啟用或停用類型。 - 有效：建立類型後，需要一段時間才能完成佈建。在佈建類型時，其有效狀態為
false。準備就緒時，會顯示為true。
如要在這個網頁介面中建立新的「類型版本」，請按一下「動作」圖示，然後點選「建立新版本」。系統會顯示下列表單：
「Create New Type Version」(建立新類型版本) 隨即開啟，顯示表單，可供修改所選類型的設定：
表單頂端會顯示類型名稱和原型。這些屬性無法修改。只有變更中繼資料規格或修改資料結構定義，才會觸發新的型別版本。修改其餘型別參數會更新型別，但不需要新版本。
您可以新增元素，修改中繼資料規格和資料結構定義。不過，所有新類型版本都必須回溯相容。您無法移除中繼資料值區，建立新版本的類型。如要新增中繼資料值區，請開啟「中繼資料值區」部分。