擷取錯誤碼
本文包含可能會在數據擷取期間發生的錯誤碼。
當您在叢集上啟用失敗的擷取診斷記錄時，您可以在失敗的擷取作業記錄中看到錯誤碼。
您可以使用 .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 | 啟動擷取時，目標數據表的架構不符合認可擷取時的架構。 | 暫時性 |
| Timeout | 作業因為逾時而中止。 | 暫時性 |
| 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 | 發生未知錯誤。 | 暫時性 |