sp_syscollector_set_cache_directory (Transact-SQL)

適用対象: SQL サーバー

収集されたデータが管理データ ウェアハウスにアップロードされる前に格納されるディレクトリを指定します。

Transact-SQL 構文表記規則

構文

sp_syscollector_set_cache_directory [ [ @cache_directory = ] N'cache_directory' ]
[ ; ]

収集した情報が一時的に格納されるファイル システム内のディレクトリを指定します。 @cache_directory は nvarchar(255)で、既定値は空の文字列です。 値が指定されていない場合は、既定の一時 SQL Server ディレクトリが使用されます。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

キャッシュ ディレクトリの構成を変更する前に、データ コレクターを無効にする必要があります。 データ コレクターが有効になっている場合、このストアド プロシージャは失敗します。 詳細については、「 データ収集の有効化または無効化および Manage データ収集を参照してください。

指定したディレクトリは、 sp_syscollector_set_cache_directory の実行時に存在する必要はありません。ただし、ディレクトリが作成されるまで、データを正常にキャッシュおよびアップロードすることはできません。 このストアド プロシージャを実行する前に、ディレクトリを作成することをお勧めします。

アクセス許可

このプロシージャを実行するには、(EXECUTE 権限を持つ) dc_admin 固定データベース ロールのメンバーシップが必要です。

例

次の例では、データ コレクターを無効にし、データ コレクターのキャッシュ ディレクトリを D:\tempdataに設定してから、データ コレクターを有効にします。

USE msdb;
GO
EXECUTE dbo.sp_syscollector_disable_collector;
GO
EXEC dbo.sp_syscollector_set_cache_directory
    @cache_directory = N'D:\tempdata';
GO
EXECUTE dbo.sp_syscollector_enable_collector;
GO

関連するコンテンツ

• データ コレクター ストアド プロシージャ (Transact-SQL)
• sp_syscollector_set_cache_window (Transact-SQL)