sp_syscollector_set_cache_window (Transact-SQL)

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

适用范围：SQL Server（SQL Server 2008 到当前版本）。

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;

请参阅

参考

系统存储过程 (Transact-SQL)

sp_syscollector_set_cache_directory (Transact-SQL)