sp_syscollector_set_cache_directory (Transact-SQL)

  • [アーティクル]

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

トピック リンク アイコン Transact-SQL 構文表記規則

構文

sp_syscollector_set_cache_directory [ @cache_directory = ] 'cache_directory'

引数

  • [ @cache_directory = ] 'cache_directory'
    収集した情報が一時的に格納されるファイル システム内のディレクトリを指定します。 cache_directory のデータ型は nvarchar(255) で、既定値は NULL です。 この値を指定しなかった場合、SQL Server の既定の一時ディレクトリが使用されます。

リターン コード値

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

説明

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

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 N'D:\tempdata';
GO
EXECUTE dbo.sp_syscollector_enable_collector;
GO

関連項目

参照

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

sp_syscollector_set_cache_window (Transact-SQL)