錯誤記錄
智慧建議為服務在 Azure Data Lake Storage 中處理的每個資料物件建立錯誤記錄。 此錯誤記錄會寫回到 Data Lake Storage 帳戶。 如果資料設定有問題，請使用本文來了解記錄中報告的錯誤及其更正方法。
本文列出智慧建議服務在記錄中發現的錯誤類型、這些錯誤的含義以及關於其解決方式的提示。
更正錯誤時，智慧建議會自動選擇新資料，並在下一個定期模型週期中處理變更。 若要進一步了解此程序，請移至手動觸發模型建立。
錯誤的類型
使用下表來了解智慧建議可能傳回的不同類型的錯誤。
有些類型的錯誤會導致資料列在處理中遭捨棄，而其他類型的錯誤可能是嚴重錯誤，並造成調製管線完全停止處理。
就導致資料列在處理中遭捨棄的錯誤而言，如果該資料列在輸入資料中廣泛使用，則可能會使得產品的品質不佳，甚至產生空白結果。
| 錯誤類型 | 描述 | 建議的解決方法 |
|---|---|---|
| AttributeValueNotAllowed | 屬性使用的是已保留或不適當的值。 | "0" 是系統中保留的值。 可能的話，請變更此屬性的值。 如需詳細資訊，請前往目錄資料實體。 |
| DataTypeMismatch | 指定資料類型的格式不正確。 | 仔細檢查格式設定，並確定 model.json 或資料合約中沒有任何不正確的字元或空格。 如需有關格式設定的詳細資訊，請參閱我們的資料合約格式設定準則。 |
| EmptyMandatoryAttribute | 資料列的其中一個必要屬性為空白。 | 填入遺失的資料。 |
| InvalidGuidIdFormat | 如果系統已設定為使用 ItemID GUID 類型，則所有的識別碼都必須是 GUID。 | 讓 ItemID 類型在所有資料列中保持一致。 |
| InvalidIdFormat | 如果系統已設定為使用英數字元 (16) ItemID 類型，則所有的識別碼都必須是英數字元 (16)。 | 讓 ItemID 類型在所有資料列中保持一致。 |
| ImageContentIsEmpty | 下載的影像是空的。 | 檢查影像 URL。 |
| ImageDownloadFailed | 影像必須位於 Data Lake Storage，並透過驗證受到保護 (非匿名存取)。 | 檢查影像 URL。 |
| ImageMalwareDetected | 惡意軟體掃描偵測到影像有問題。 | 檢查影像 URL。 |
| ImageNotFound | 找不到指定 URL 中的影像。 | 檢查影像 URL。 |
| ImageSizeLargerThanAllowed | 影像大於允許的大小上限。 | 檢查影像 URL。 |
| ImageUnexpectedContentType | 影像 URL 包含未預期的內容類型。 | 檢查影像 URL。 |
| MalwareDetected | 檢查影像檔案。 這些檔案可能受到感染。 | 檢查影像 URL。 |
| InvalidListName | 確定清單名稱與文件相符。 | 如需詳細資訊，請前往建議擴充資料實體。 |
| InvalidDateFormat | 在 ItemsAndVariants 輸入中，發行日期不符合支援的日期格式 yyyy-MM-ddTHH:mm:ss.fffZ。 |
確認您的日期時間格式符合我們資料合約結構描述中的需求，不然就讓發行日期保持空白。 |
| InvalidListAvailabilityRange | [開始日期] 應早於 [結束日期]，並且都必須是非空白。 | 檢查可用性的日期。 如需詳細資訊，請前往目錄資料實體。 |
| UniqueAttributeCountExceedsThreshold | 部分屬性在唯一值方面受到限制。 此錯誤表示智慧建議服務已達到超出支援限制的資料大小。 | 如果發生此錯誤，而無法解決問題時，請前往支援。 |
| CsvInvalidFormat | 輸入資料實體的 CSV 格式可能不正確。 | 錯誤記錄檔會向用戶端指出錯誤的位置，以及有關錯誤的詳細資料。 如需詳細資訊，請參閱資料合約資料格式準則。 |
| MissingAttribute | 指定的資料實體未包含所有必要的屬性。 | 如需關於特定資料實體所需屬性的詳細資訊，請參閱資料合約概觀。 |
| MandatoryInputIsMisssing | model.json 檔案遺失。 | 重新確認您已將 model.json 檔案正確上傳至ir_root 資料夾底下的儲存體帳戶。 其次，檢查模型資源連接字串是否指向含有 model.json 檔案的資料夾。 如果 model.json 檔案已遭修改、已損毀或遺失，則可以從資料合約下載全新 model.json 檔案，並將其新增至 ir_root 資料夾。 |
| MulitpleFilterTypes | Reco_ItemAndVariantFilters 包含具有多個篩選類型的篩選名稱。 | 檢閱資料合約，並確認所有與特定 FilterName 相關的值都有相同的 FilterType。 如需詳細資訊，請參閱我們的項目與變體篩選準則。 |
| NonNumericFilterValue | 數值篩選假設所有的值都是數值。 | 將篩選條件變更為數值資料。 |
| TotalLineCountExceedsThreshold | 輸入資料實體目前超過行計數閾值。 | 此服務對於特定資料實體及值的不重複值與組合數目有預設閾值。 檢查記錄檔以了解發生錯誤的位置，並遵循資料合約格式設定準則找出每個資料實體的正確閾值。 |
| UnexpectedColumnCount | 您缺少或取得的列數超過每個資料合約所允許的欄數。 某些欄可以有選用值並且可以保留空白，但是所有的欄都必須存在，才能讓服務正常運作。 | 如果是非必要的欄或是無法使用的資料，請讓欄保留空白。 不要將欄移除。 輸入結構描述中必須正好有 12 欄。 未正確逸出的字串可能包含逗號並中斷欄計數。 不要編輯 model.json 檔案，以免損毀資料合約。 如果您的 model.json 檔案已遭修改或破壞，則可以從資料合約下載新的 model.json 檔案。 |
| UniqueAttributeCountExceedsThreshold | 輸入資料實體目前超過不重複值/組合計數閾值。 | 此服務對於特定資料實體及值的不重複值與組合數目有預設閾值。 檢查記錄檔以了解發生錯誤的位置，並遵循資料合約格式設定準則找出每個資料實體的正確閾值。 |
| UnsupportedFilterType | 服務發覺您使用的可能是不支援的篩選類型。 | 請確定篩選類型是文件所列其中一個支援的值。如需詳細資訊，請移至目錄資料實體。 |
| DistinctValueViolation | ItemsAndVariants.csv 有重複的變體識別碼。 檢查記錄檔是否有資料重複的項目變體識別碼。 | 如果在資料合約找出重複資料，則服務會停止處理相關資料實體，這樣就不會處理使用資料實體的案例。 視資料數量而定，此錯誤會在前幾分鐘或一小時內觸發。 若要解決此問題，請移除任何重複資料，然後重新開始建模週期。 |
| DistinctValueViolation | Interactions.csv 包含兩個具有相同變體識別碼的不同主要項目。 檢查記錄檔有變體識別碼相同的項目識別碼。 | 如果在資料合約找出重複資料，則服務會停止處理相關資料實體，這樣就不會處理使用資料實體的案例。 視資料數量而定，此錯誤會在前幾分鐘或一小時內觸發。 若要解決此問題，請移除任何重複資料，然後重新開始建模週期。 |
| UniqueAttributesCombinationExceedsThreshold | 存在超出限制的輸入資料組合。 例如：itemId、variantId 非重複計數越過限制。 | 檢查記錄檔以了解發生錯誤的位置，並遵循資料合約格式設定準則找出每個資料實體的正確閾值。 |
| MaxUniqueAttributeCountPerItemExceedsThreshold | 輸入資料組合已超過每個產品的限制。 例如：每個項目的不同影像數量越過限制。 | 檢查記錄檔以了解發生錯誤的位置，並遵循資料合約格式設定準則找出每個資料實體的正確閾值。 |
| 內部 | 一般錯誤；除列出的錯誤外，任何無法識別的錯誤。 | 如果發生此錯誤，而您無法解決問題時，請連絡我們的團隊。 |
範例記錄檔
以下是記錄檔的範例。 回覆包含下列區段：
- TotalRecordCount：正確處理的總列數。
- TotalDroppedRecords：因資料設定發生問題而捨棄的總列數。
- Errors：已發現且已分組為類別的錯誤類型。 每個錯誤類型都包含總列數以及格式錯誤的資料範例。
在提供的範例中，您會發現已傳回兩種類型的錯誤。 第一個錯誤「EmptyMandatoryAttribute」顯示目前留有空字串的 ItemId。 第二個錯誤「InvalidIdFormat」參考不正確的 ItemId 格式，以及 ItemId 設定不正確的範例。
{
"TotalRecordCount": 12803,
"TotalDroppedRecords": 69,
"Errors": [
{
"ErrorCategory": "EmptyMandatoryAttribute",
"ColumnName": "ItemId",
"ErrorCount": 1,
"Samples": [
""
]
},
{
"ErrorCategory": "InvalidIdFormat",
"ColumnName": "ItemId",
"ErrorCount": 68,
"Samples": [
"6.92E+13",
"4.18E+171",
"5.74E+13",
"6.70E+36",
"9.95E+11",
"5.13E+23",
"9.26E+14",
"1.02E+11",
"5.43E+14",
"9.07E+80"
]
}
]
}
仍需要協助嗎？
如果發生未列於本表中的問題，請前往支援，以取得有關如何與智慧建議支援小組聯繫的資訊。