| title | sp_syscollector_set_cache_directory (Transact-SQL) | Microsoft Docs | ||
|---|---|---|---|
| ms.custom | |||
| ms.date | 03/14/2017 | ||
| ms.prod | sql-non-specified | ||
| ms.reviewer | |||
| ms.suite | |||
| ms.technology |
|
||
| ms.tgt_pltfrm | |||
| ms.topic | language-reference | ||
| f1_keywords |
|
||
| dev_langs |
|
||
| helpviewer_keywords |
|
||
| ms.assetid | df56d5a5-8961-494f-a745-d752ca63805a | ||
| caps.latest.revision | 18 | ||
| author | JennieHubbard | ||
| ms.author | jhubbard | ||
| manager | jhubbard |
[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx_md]
Specifies the directory where collected data is stored before it is uploaded to the management data warehouse.
| Applies to: [!INCLUDEssNoVersion] ([!INCLUDEssKatmai] through current version). |
Transact-SQL Syntax Conventions
sp_syscollector_set_cache_directory [ @cache_directory = ] 'cache_directory'
[ @cache_directory = ] 'cache_directory'
The directory in the file system where collected data is stored temporarily. cache_directory is nvarchar(255), with a default value of NULL. If no value is specified, the default temporary [!INCLUDEssNoVersion] directory is used.
0 (success) or 1 (failure)
You must disable the data collector before changing the cache directory configuration. This stored procedure fails if the data collector is enabled. For more information, see Enable or Disable Data Collection, and Manage Data Collection.
The specified directory does not need to exist at the time the sp_syscollector_set_cache_directory is executed; however, data cannot be successully cached and uploaded until the directory is created. We recommend creating the directory before executing this stored procedure.
Requires membership in the dc_admin (with EXECUTE permission) fixed database role to execute this procedure.
The following example disables the data collector, sets the cache directory for the data collector to D:\tempdata,and then enables the data collector.
USE msdb;
GO
EXECUTE dbo.sp_syscollector_disable_collector;
GO
EXEC dbo.sp_syscollector_set_cache_directory N'D:\tempdata';
GO
EXECUTE dbo.sp_syscollector_enable_collector;
GO Data Collector Stored Procedures (Transact-SQL)
sp_syscollector_set_cache_window (Transact-SQL)