sp_syscollector_set_cache_window (Transact-SQL)

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

主题链接图标Transact-SQL 语法约定

语法

sp_syscollector_set_cache_window [ @cache_window = ] cache_window 

参数

  • [ @cache_window = ] cache_window
    是将数据上载到管理数据仓库失败但不丢失数据的重试次数。cache_window 是默认值为 1 的 int。cache_window 可以为下列值之一:

    说明

    -1

    缓存先前上载失败的所有上载数据。

    0

    不缓存上载失败的任何数据。

    n

    从 n 个以前的上载失败中缓存数据,其中,n > = 1。

返回代码值

0(成功)或 1(失败)

注释

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

权限

必须具有 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;