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)