sp_syscollector_set_cache_window (Transact-SQL)

适用于SQL Server

设置在发生故障时尝试数据上传的次数。 在失败时重新尝试上载可降低丢失所收集数据的风险。

Transact-SQL 语法约定

语法

sp_syscollector_set_cache_window [ [ @cache_window = ] cache_window ]
[ ; ]

参数

[ @cache_window = ] cache_window

重试将数据上传到管理数据仓库失败的次数,而不会丢失数据。 @cache_window为 int,默认值为 1. @cache_window可以具有以下值之一:

说明
-1 缓存先前上载失败的所有上载数据。
0 不要缓存上传失败的任何数据。
n 缓存以前上传失败的 n 个数据,其中 n>= 1。

返回代码值

0(成功)或 1(失败)。

注解

在更改缓存窗口配置之前,必须禁用数据收集器。 如果数据收集器处于启用状态,此存储过程将失败。 有关详细信息,请参阅 “启用或禁用数据收集”,以及 管理数据收集

权限

要求dc_admin(具有 EXECUTE 权限)固定数据库角色的成员身份才能执行此过程。

示例

以下示例禁用数据收集器,配置缓存窗口以最多保留三次上载失败的数据,然后启用数据收集器。

USE msdb;
GO
EXECUTE dbo.sp_syscollector_disable_collector;
GO
EXECUTE dbo.sp_syscollector_set_cache_window 3;
GO
EXECUTE dbo.sp_syscollector_enable_collector;