引入错误代码
本文包含可能在数据引入期间出现的错误代码。
如果在群集上启用“失败引入”诊断日志，则可在“失败引入”操作日志中查看错误代码。
可以使用 .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 | 事件包含“数据库”属性，该属性将引入的数据路由到与数据连接设置中配置的目标数据库不同的数据库。 但是，由于连接未设置为允许路由到多个数据库，因此不允许动态数据库路由。 | 永久性 |
| 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 | 发生未知错误。 | 暂时性 |