擷取錯誤碼

本文包含可能會在 數據擷取期間發生的錯誤碼。

當您在叢集上啟用失敗的擷取 診斷記錄 時，您可以在 失敗的擷取作業記錄中看到錯誤碼。

您可以使用 .show 擷取失敗命令 來呈現數據擷取管理命令失敗的相關信息，不過此命令會排除擷取程式其他階段的失敗。 如需所有階段失敗的完整檢視，請參閱 擷取計量 和 診斷記錄。

擷取結果計量會提供擷取錯誤類別的相關信息，不過它不會顯示特定的錯誤碼。 本文中的錯誤會依這些類別來組織。

注意

針對暫時性錯誤或「General_RetryAttemptsExceeded」錯誤，重試擷取可能會成功。

類別：BadFormat

錯誤訊息	描述	永久/暫時性
Stream_WrongNumberOfFields	輸入記錄中的欄位數目不一致。 HRESULT：0x80DA0008	持續性
Stream_ClosingQuoteMissing	CSV 格式無效。 遺漏右引號。 HRESULT：0x80DA000b	持續性
BadRequest_InvalidBlob	Blob 無效。	持續性
BadRequest_EmptyArchive	封存是空的。	持續性
BadRequest_InvalidArchive	封存無效。	持續性
BadRequest_InvalidMapping	無法剖析擷取對應。 如需如何寫入擷取對應的詳細資訊，請參閱 數據對應。	持續性
BadRequest_InvalidMappingReference	無效的對應參考。	持續性
BadRequest_FormatNotSupported	不支援格式。 這可能是因為您使用特定數據連線不支援的格式。 如需擷取所支援之數據格式的詳細資訊，請參閱 支持的數據格式。	持續性
BadRequest_InconsistentMapping	支援的擷取對應與現有的數據表架構不一致。	持續性
BadRequest_UnexpectedCharacterInInputStream	輸入數據流中的非預期字元。	持續性

類別：BadRequest

錯誤訊息	描述	永久/暫時性
BadRequest_EmptyBlob	Blob 是空的。	持續性
BadRequest_NoRecordsOrWrongFormat	Blob 是空的或指定的 擷取格式 不符合 blob 內容 (例如， JSON 使用的格式，而不是 MULTIJSON) 。	持續性
BadRequest_EmptyBlobUri	Blob URI 是空的。	持續性
BadRequest_DuplicateMapping	擷取屬性包括ingestionMapping和ingestionMappingReference，這無效。	持續性
BadRequest_InvalidOrEmptyTableName	數據表名稱是空的或無效的。 如需命名慣例的詳細資訊，請參閱 實體名稱。	持續性
BadRequest_EmptyDatabaseName	資料庫名稱是空的。	持續性
BadRequest_EmptyMappingReference	某些格式應該會取得要擷取的擷取對應，而對應參考是空的。 如需對應的詳細資訊，請參閱 數據對應。	持續性
Download_BadRequest	無法從 Azure 記憶體下載來源，因為要求不正確。	持續性
BadRequest_MissingMappingtFailure	Avro 和 Json 格式必須使用 ingestionMapping 或 ingestionMappingReference 參数擷取。	持續性
Stream_NoDataToIngest	找不到要擷取的數據。 如果是 JSON 格式的數據，此錯誤可能表示 JSON 格式無效。	持續性
Stream_DynamicPropertyBagTooLarge	數據在動態數據列中包含太大的值。 HRESULT：0x80DA000E	持續性
General_BadRequest	不正確的要求。	持續性
BadRequest_CorruptedMessage	訊息已損毀。	持續性
BadRequest_SyntaxError	要求語法錯誤。	持續性
BadRequest_ZeroRetentionPolicyWithNoUpdatePolicy	數據表沒有保留原則，而且不是任何更新原則的源數據表。	持續性
BadRequest_CreationTimeEarlierThanSoftDeletePeriod	為擷取指定的建立時間不在 內 SoftDeletePeriod。 如需 的詳細資訊 SoftDeletePeriod，請參閱 原則物件。	持續性
BadRequest_NotSupported	不支援要求。	持續性
Download_SourceNotFound	無法從 Azure 記憶體下載來源。 找不到來源。	持續性
BadRequest_EntityNameIsNotValid	實體名稱無效。 如需命名慣例的詳細資訊，請參閱 實體名稱。	持續性
BadRequest_MalformedIngestionProperty	擷取屬性的格式不正確。	持續性
BadRequest_IngestionPropertyNotSupportedInThisContext	此內容不支援擷取屬性。	持續性
BadRequest_NonMultiDatabaseDataConnection	事件包含 『Database』 屬性，會將內嵌的數據路由傳送至與數據連線設定中所設定之目標資料庫不同的資料庫。 不過，由於連線未設定為允許路由傳送至多個資料庫，因此不允許動態資料庫路由。	持續性
BadRequest_InvalidBlobUri	Blob URI 無效。	持續性
BadRequest_DataCapacityLimitReached	記憶體帳戶已達到其數據容量限制。	持續性
BadRequest_InvalidManagedIdentity	受控識別不存在或沒有必要的許可權。	持續性

類別：DataAccessNotAuthorized

錯誤訊息	描述	永久/暫時性
Download_AccessConditionNotSatisfied	無法從 Azure 記憶體下載來源。 不符合存取條件。	持續性
Download_Forbidden	無法從 Azure 記憶體下載來源。 禁止存取。	持續性
Download_AccountNotFound	無法從 Azure 記憶體下載來源。 找不到帳戶。	持續性
BadRequest_TableAccessDenied	拒絕存取數據表。 如需詳細資訊，請參閱 角色型訪問控制。	持續性
BadRequest_DatabaseAccessDenied	拒絕存取資料庫。 如需詳細資訊，請參閱 角色型訪問控制。	持續性
BadRequest_InvalidAuthentication	對數據的驗證無效。	持續性

類別：DownloadFailed

錯誤訊息	描述	永久/暫時性
Download_NotTransient	無法從 Azure 記憶體下載來源。 未發生暫時性錯誤	持續性
Download_UnknownError	無法從 Azure 記憶體下載來源。 發生未知錯誤	暫時性
Download_TransientNameResolutionFailure	無法從 Azure 記憶體下載來源。 發生暫時性記憶體帳戶名稱解析失敗	暫時性

類別：EntityNotFound

錯誤訊息	描述	永久/暫時性
BadRequest_MappingReferenceWasNotFound	找不到對應參考。	持續性
BadRequest_DatabaseNotExist	資料庫不存在。	持續性
BadRequest_TableNotExist	數據表不存在。	持續性
BadRequest_EntityNotFound	找不到實體 (，例如對應、資料庫或數據表) 。	持續性

類別：FileTooLarge

錯誤訊息	描述	永久/暫時性
Stream_InputStreamTooLarge	數據中輸入數據或單一欄位的大小總計太大。 HRESULT：0x80DA0009 如需此類型擷取大小限制的詳細資訊，請參閱 字串數據類型。	持續性
BadRequest_FileTooLarge	Blob 大小已超過擷取允許的大小限制。	持續性

類別：InternalServiceError

錯誤訊息	描述	永久/暫時性
General_InternalServerError	發生內部伺服器錯誤。	暫時性
General_TransientSchemaMismatch	啟動擷取時的目標數據表架構不符合認可擷取時的架構。	暫時性
逾時	作業因為逾時而中止。	暫時性
OutOfMemory	擷取作業記憶體不足。	暫時性
Schema_PermanentUpdateFailure	無法永久更新架構。	持續性

類別：UpdatePolicyFailure

錯誤訊息	描述	永久/暫時性
UpdatePolicy_QuerySchemaDoesNotMatchTableSchema	無法叫用更新原則。 查詢架構不符合數據表架構。	持續性
UpdatePolicy_FailedDescendantTransaction	無法叫用更新原則。 失敗的子代交易式更新原則。	暫時性
UpdatePolicy_IngestionError	無法叫用更新原則。 發生擷取錯誤。 更新原則的來源數據表上會報告錯誤。	暫時性
UpdatePolicy_UnknownError	無法叫用更新原則。 發生未知錯誤。 錯誤會在更新原則的目標數據表上報告。	暫時性
UpdatePolicy_Cyclic_Update_Not_Allowed	無法叫用更新原則。 不允許迴圈更新。	持續性
UpdatePolicy_BadRequest	因為要求不正確而無法叫用更新原則， 例如，查詢語意錯誤。	持續性

類別：UserAccessNotAuthorized

錯誤訊息	描述	永久/暫時性
BadRequest_InvalidKustoIdentityToken	無效的 Kusto 身分識別令牌。	持續性
禁止	安全性許可權不足，無法執行要求。	持續性

類別：ThrottledOnEngine

錯誤訊息	描述	永久/暫時性
General_ThrottledIngestion	節流擷取。	暫時性

類別：RetryAttemptsExceeded

錯誤訊息	描述	永久/暫時性
General_RetryAttemptsExceeded	在週期性暫時性錯誤之後，作業已超過重試嘗試的限制或時間範圍限制。	持續性

類別：BlobAlreadyReceived

錯誤訊息	描述	永久/暫時性
BlobAlreadyReceived_BlobAlreadyFoundInBatch	偵測到相同特定批次中的相同 Blob 以進行擷取。 在此情況下，只會使用一個 Blob 複本來擷取。 此類型的許多錯誤可能表示擷取組態是次佳的。 例如，在相同的記憶體上定義兩個事件方格數據連線。	持續性

類別：未知

錯誤訊息	描述	永久/暫時性
Unknown	發生未知錯誤。	暫時性