APEX Backup Service （PPBS） Hybrid/Enterprise Workload Agent SQL 错误代码

SQL1

错误消息：SQL 代理遇到内部错误 

错误解决方案：请与支持部门联系。

SQL3

错误消息：元数据与上次备份不匹配。  在上一个备份周期中可能未备份 SQL Server 实例。

错误说明：如果选择用于备份的数据库的元数据与之前备份时的数据库元数据不匹配，则会发生此错误。 

错误解决方案：通过管理控制台运行完整备份。

SQL4的

错误消息：Specified instance not found on present application server.：[尝试恢复到服务器中未找到的实例>的实例<逻辑路径]

错误说明：如果目标机器上不存在指定的实例，则会发生此错误。

错误解决方案：  要解决该错误，请执行以下操作：

• 将数据库文件还原到备用位置。这些文件可用于通过将数据库附加到其他 SQL 实例来恢复数据库。
• 确保实例正在目标计算机上运行。

SQL5

错误消息：  未能获取 SQL 产品版本

错误说明：  出现此错误的原因可能如下：

• 未配置 sqlcmd。
• sqlcmd 出错。

错误解决方案：   要解决此错误，请执行以下操作：

• 在命令提示符下，键入“sqlcmd”以检查是否配置了 sqlcmd。
• 重试此操作。

提醒：此错误适用于 SQL 代理版本 4.6.5 及更早版本。 

SQL6

错误消息：  ABS SQL 代理在服务器上找不到要备份的实例/数据库，或者 SQL 服务未运行，或者备份策略设置为排除所有数据库。

错误说明：  出现此错误的原因可能如下：

• 所选数据库的日志链已断开。
• 所有数据库都处于简单恢复模式，用于日志备份。
• 从 UI 中排除的所有数据库。

错误解决方案：   要解决此错误，请执行以下操作：

• 确保至少有一个实例处于联机状态且处于工作状态。
• 检查备份策略和排除的文件夹条目。
• 触发完整/差异备份。
• 禁用第三方备份工具。
• 至少一个数据库应具有完整恢复模式。
• 更新排除数据库列表。

SQL7

错误消息：  混合工作负载代理遇到 ODBC 驱动程序错误

错误说明：   出现此错误的原因可能如下：

• 与 SQL Server 的连接丢失。
• 数据库的元信息不可用。
• 没有足够的权限来访问 SQL Server。

错误解决方案：   要解决此错误，请执行以下操作：

• 检查 SQL Server 实例是否已启动并正在运行。
• 根据文档启用本地系统帐户的权限。

SQL8的

错误消息：  混合工作负载代理遇到 VIDLIB 应用程序错误

错误说明：出现此错误的原因可能如下：

• 本地网络连接已禁用
• 无法创建与 SQL Server 的虚拟连接
• 没有足够的权限来访问 SQL Server
• 当数据库的日志链由于更改/替换的数据文件而中断时，数据库的时间点或事务标记还原将失败。

错误解决方案：  可以通过以下方法解决此错误：

• 这可能是暂时性问题，可能会在下一个日志备份周期中自动解决。
• 检查根据文档启用的本地系统帐户的权限。

SQL9

错误消息：  发生 SQL 代理内部错误

错误解决方案：   请与支持部门联系。

SQL10

错误消息：  未找到标记的交易时间戳。事务日志不足，无法还原标记的事务。

错误说明：  此错误可能是由于以下原因造成的：

• 事务日志链断开
• 时间戳问题

错误解决方案：请与支持部门联系。

SQL11

错误消息：  时间点恢复的时间戳无效

错误说明：  此错误可能是由于以下原因造成的：

• 事务日志链断开
• 时间戳问题

错误解决方案：   请与支持部门联系。

SQL12

错误消息：  数据库在目标 SQL Server 上不兼容。请检查版本兼容性级别。 

错误说明：   发生此错误的原因可能是 SQL Server 还原实例不兼容。

错误解决方案：  若要解决此问题，请尝试在兼容的 SQL Server 实例上还原数据库。请参见ALTER DATABASE 兼容级别。 

提醒：此问题不适用于 SQL Server 代理 4.6.5 及更早版本。 

SQL15

错误消息：SQL 代理遇到内部错误

错误解决方案：请与支持部门联系。

SQL16

错误消息：SQL Server 备份节点运行状况不正常。

错误说明：当可用性组节点未连接或未处于正常运行状态时，会发生此错误。

错误解决方案：要解决此问题，请检查群集和可用性组的状态，并根据备份首选项确定是否有可用的节点。

SQL17

错误消息：客户端上的 SQL Server 发现失败

错误说明：当 ABS 未发现 MS-SQL 资源（如实例和 AG）时，会发生此错误。

错误解决方案：要解决此问题，请检查 ABS 客户端日志文件中是否有错误。请与支持部门联系。

SQL18

错误消息：AG 节点的客户端版本不同。

错误说明：当可用性组节点上安装不同的 ABS 客户端版本时，会发生此错误。

错误解决方案：要解决此问题，请确保在所有可用性组节点上安装相同版本的混合工作负载代理。

SQL20

错误消息：由于 SQL 节点不可用，未能触发备份请求。

错误说明：发生此错误的原因是 SQL 节点不可用导致混合工作负载代理无法触发备份请求。检查 SQL 节点的连接状态。

错误解决方案：要解决此问题，请检查群集和可用性组的状态，并根据备份首选项确定是否有可用的节点。

SQL21

错误消息：为触发备份作业传递的计划 CLI 参数不正确

错误说明：如果找不到 CLI 触发的备份作业的备份计划，则会发生此错误。

错误解决方案：通过 CLI 触发 SQL 备份时交叉检查备份策略计划参数。

SQL22

错误消息：为触发备份作业而传递的 SQL 资源的 CLI 参数不正确

错误说明：如果您为 CLI 触发的备份作业提供的实例或可用性组的名称无效，则会发生此错误。

错误解决方案：通过 CLI 触发 SQL 备份时交叉检查资源参数。

SQL23

错误消息：备份集的 CLI 参数或为触发备份作业传递的策略不正确

错误说明：对于 CLI 触发的备份作业，可能会发生此错误，原因如下：

• 未配置备份集
• 备份集已禁用
• 未在备份集中配置备份类型。

错误解决方案：通过 CLI 触发 SQL 备份时交叉检查备份集参数。

SQL24

错误消息：无法触发备份作业，因为 2 个或更多备份作业正在运行。 

错误说明：如果两个或多个 CLI 触发的备份作业已在运行，则可能会发生此错误。

错误解决方案：  要解决此问题，请等待，直至运行 CLI 触发的备份作业少于两个。

SQL25

错误消息：未创建日志备份的触发备份作业。 

错误说明：如果不存在完整备份，或者 CLI 触发的备份作业正在进行另一个完整备份或差异备份，则会发生此错误。

错误解决方案：  要解决此问题，请确保执行完整备份，然后在未进行完整备份或差异备份时重试。

SQL32

错误消息：在完成第一个完整备份之前，无法创建新的备份作业。   

错误说明：如果在第一次完整备份完成之前从命令行触发备份作业，则会发生此错误。

错误解决方案：  要解决此问题，请确保等待第一个完整备份完成。

SQL33

错误消息：在上载期间未找到数据库。

错误说明：如果在备份期间删除实例上的数据库，则会发生此错误。

错误解决方案：要解决此问题，请确保在备份操作期间未删除实例上的数据库。

SQL34

错误消息：未能获取产品版本信息，例如实例 [instance_name]

错误说明：当混合工作负载代理无法识别 SQL Server 版本时，会发生此错误。  混合工作负载代理无法识别 SQL Server 版本的原因之一是是否禁用了 TLS 1.0/1.1。

错误解决方案：如果禁用了 TLS 1.0/1.1，请安装 SQL Server Native Client 驱动程序 11.0。您可以从 Microsoft 下载中心下载适用于 MS-SQL Server 2012 的 SQL Server 本机客户端驱动程序。如果问题仍然存在，请联系支持部门。

SQL35

错误消息：数据库状态错误。 

错误说明：在以下情况下，替换原始数据库还原作业可能会发生此错误：

• 所选 SQL Server 实例上不存在数据库
• 选择要替换的数据库在属于可用性组的 SQL Server 实例上运行
• 所选 SQL Server 实例处于无恢复模式

错误解决方案：要解决此问题，请确保：

• 数据库存在于所选 SQL Server 实例上
• SQL Server 实例不是可用性组的一部分
• SQL Server 实例未处于无恢复模式

SQL36 

错误消息：未能分离数据库。

错误说明：如果 ABS 在恢复期间无法将数据库与其 SQL Server 实例分离，则会发生此错误。

错误解决方案：要解决此问题，请检查：

• 如果数据库存在于 SQL Server 实例上
• 如果 SQL Server 实例上的任何问题阻止数据库分离

SQL37 

错误消息：当前日志备份作业已过期，新的日志备份作业已排队。

错误说明：如果 ABS 在现有日志备份作业已排队时计划新的 SQL 日志备份作业，则会发生此错误。ABS 一次仅对一个 SQL 日志备份作业进行排队。因此，当 ABS 触发新的日志备份作业时，该作业将排队，并且处于排队状态的早期日志备份作业将标记为“备份窗口已过期”。此行为可避免多个日志备份作业在排队状态下累积，当日志备份作业长时间运行时可能会发生这种情况。

SQL38 

错误消息：此设备上尚未激活 ABS 客户端。

错误说明：当需要在所选 SQL 资源上激活混合工作负载代理（客户端）时，会发生此错误。
对于 SQL Server 实例，需要在所选实例上激活客户端，而对于可用性组 （AG），需要在可用性组的所有节点上激活客户端。

错误解决方案：
确保在选定的 SQL Server 和可用性节点上安装并激活混合工作负载代理。如果已激活，则重新启动混合工作负载客户端服务。

SQL40

错误消息：作业操作失败，因为未为用户分配 Sysadmin 权限。

错误说明：  ABS 与 Microsoft 虚拟设备接口 （VDI） 对接，以备份和还原 SQL 数据库事务日志和 SQL VDI 差异备份。分配给 SQL Server 的用户帐户需要具有 sysadmin 角色。

错误解决方案：  将凭据分配给 SQL 服务器，并确保分配的用户帐户具有 sysadmin 角色。有关详细信息，请参阅 MS-SQL 服务器的系统要求和加入角色。

SQL50

错误消息：未能将数据库与实例分离。 

错误说明：  在选择从具有 VDI 差异恢复点的恢复点还原数据库文件时，可能会遇到此错误。从 VDI 恢复点还原时，混合工作负载代理会创建一个临时用户数据库，并通过此数据库还原 .mdf、.ndf 和 .ldf 文件。然后，代理通过数据库恢复.bak文件数据，并分离临时数据库。此时，如果混合工作负载代理确实具有分离数据库的权限，则数据库分离可能会失败。

错误解决方案：  使用 SQL Management Studio 并执行以下任务：

1. 右键单击错误中引用的用户数据库 <rst_databasename> ，导航到“任务”，然后单击“分离”。 
2. 在“Detach Database”对话框中，选择“Drop Connections”和“Update Statistics”。
3. 单击 Detach。

手动分离所有已还原的数据库时，数据库将自动删除。数据库文件在指定的还原目标处可用。 

SQL51

错误消息：还原失败，因为数据库文件已存在于给定的下载位置。请从下载位置删除或移动文件，然后再次触发还原。

错误说明： 

在将数据库还原到原始 SQL Server 实例并选择替换原始数据库时，可能会遇到此错误。如果原始位置具有与 SQL Server 实例上的工作数据库关联的数据库文件，则会发生此错误。

错误解决方案：从 UI 中的作业进度日志或客户端作业日志中确定预先存在的数据库文件的位置，然后删除文件或将其移至其他位置。再次触发还原。

SQL52

错误消息：作业操作失败，因为未为用户分配 CREATE ANY DATABASE 权限。

错误说明： 

ABS 与 Microsoft 卷影拷贝服务 （VSS） 对接，以执行基于恢复点的备份和还原。分配给 SQL Server 的用户帐户需要具有 CREATE ANY DATABASE 权限。

错误解决方案：将凭据分配给 SQL Server。确保分配的用户帐户具有 dbcreator/sysadmin 角色。这也可以通过在当前登录名的 SQL Server 用户权限中添加 CREATE ANY DATABASE 来完成。有关详细信息，请参阅管理 MS-SQL 服务器的凭据和加入角色。

SQL53 

错误消息：事务日志备份将失败，因为所有数据库都处于简单恢复模式。

错误说明：当备份集的所有数据库都处于简单恢复模式时，会发生此错误。配置了简单恢复模式的 SQL Server 数据库不支持日志备份，以保持较小的空间需求。因此，此备份集的事务日志备份将失败。

错误解决方案：
在创建或编辑备份集之前，请确保至少有一个选定数据库配置了完整恢复模式。
或者，您可以从所选备份策略中删除事务日志计划，或选择其他不包含事务日志备份计划的备份策略。
有关修改 SQL 服务器数据库的恢复模式的详细信息，请参阅
https://docs.microsoft.com/en-us/sql/relational-databases/backup-restore/view-or-change-the-recovery-model-of-a-database-sql-server?view=sql-server-ver15。

SQL54

错误消息：由于结尾日志备份失败，还原作业失败。
错误说明：结尾日志还原作业失败，因为在触发结尾日志还原作业时选择了结尾日志备份失败时中止还原选项。
错误解决方案：检查结尾日志备份作业错误。如果您仍想继续结尾日志还原，则取消选择结尾日志备份失败时中止还原选项，然后触发结尾日志还原作业。

SQL56

错误消息：由于权限问题，无法在还原位置执行下载/还原。为指定文件夹/驱动器提供管理员权限。
错误说明： 

• 为了下载和还原数据库文件，混合工作负载服务需要对给定还原位置具有打开、创建、读取和写入权限。 
• 如果还原目录对该计算机上的所有 Windows 用户不具有这些权限，则非管理员用户无法访问还原目录。
• 当运行混合工作负载代理的用户无权访问还原目录时，会发生此错误。

错误解决方案：如果混合工作负载服务在标准 Windows 用户上运行，您可以向“所有人”分配特定还原目录的创建、读取、写入和打开权限。否则，请确保混合工作负载服务在已具有管理员权限的 Windows 用户上运行。

SQL57

错误消息：还原将失败，因为目标设备上未运行 VSS 编写器或 SQLWriter 服务。

错误说明：如果 VSS 服务未运行或 SQL 编写器未处于稳定状态，则会发生此错误。

错误解决方案：

检查 VSS 服务。如果 VSS 服务未运行，请手动启动该服务并将其切换到自动模式。如果 VSS 服务处于禁用状态，则将其切换为自动模式。

要了解 VSS SQL 编写器是否正在运行并具有稳定状态，请在命令提示符上键入以下内容：
vssadmin List Writers

Windows 服务上的 SQL 编写器必须正在运行并已启用。还必须将其设置为自动。

如果 VSS 服务和 SQLWriter 都在运行，您可以重新启动这些服务

SQL82的

错误消息：当备份集的另一个日志备份作业处于正在运行或已排队状态时，将跳过日志备份。

错误说明：因为同一备份集存在排队或正在运行的日志备份作业，所以跳过计划的日志备份作业时会发生此错误。

错误解决方案：监视后续日志备份。如果问题仍然存在，请联系支持部门。

SQL83

警告消息：数据库名称可用性检查（带警告图标）。

警告说明：如果系统中已存在同名数据库，并且您不顾预检查警告继续执行恢复操作，则将覆盖并替换现有数据库。

警告解决方案：确保在还原时为数据库选择唯一名称，以避免与目标系统上的现有数据库发生冲突。

SQL84的

错误消息：数据库名称可用性检查（带有错误图标）。

错误说明：在以下情况下会发生此错误：

• 当所选名称已由同一可用性组中的另一个数据库使用时，尝试对数据库执行还原操作。
• 尝试恢复到以前与可用性组关联的数据库，无论恢复目标当前是可用性组中还是独立数据库。
   

错误解决方案：要解决此问题：

• 如果涉及可用性组，请为恢复选择不同且唯一的数据库名称。

• 如果需要替换原始数据库，请确保在启动还原过程之前将其与可用性组分离。

请注意，如果从可用性组中删除原始数据库并尝试使用相同名称还原数据库，则会收到一条警告消息，指示该数据库将被替换。请参阅上面的 SQL83。