sp_syscollector_set_cache_window (Transact-SQL)
適用対象: SQL サーバー
エラーが発生した場合にデータのアップロードを試行する回数を設定します。 データのアップロード時にエラーが発生した場合に再試行することで、収集したデータが失われるリスクが軽減されます。
構文
sp_syscollector_set_cache_window [ [ @cache_window = ] cache_window ]
[ ; ]
引数
[ @cache_window = ] cache_window
管理データ ウェアハウスへの失敗したデータのアップロードが、データを失うことなく再試行される回数。 @cache_window は int で、既定値は 1
です。 @cache_window には、次のいずれかの値を指定できます。
Value | 説明 |
---|---|
-1 | アップロード エラーが発生した場合にそのすべてのアップロード データをキャッシュします。 |
0 | アップロードエラーのデータをキャッシュしないでください。 |
n | 以前の n 件のアップロード エラー ( n>= 1) のデータをキャッシュします。 |
リターン コードの値
0
(成功) または 1
(失敗)。
解説
キャッシュ ウィンドウの構成を変更する前に、データ コレクターを無効にする必要があります。 データ コレクターが有効になっている場合、このストアド プロシージャは失敗します。 詳細については、「 データ収集の有効化または無効化および Manage データ収集を参照してください。
アクセス許可
このプロシージャを実行するには、(EXECUTE 権限を持つ) dc_admin 固定データベース ロールのメンバーシップが必要です。
例
次の例では、データ コレクターを無効にし、最大 3 つの失敗したアップロードのデータを保持するようにキャッシュ ウィンドウを構成し、データ コレクターを有効にします。
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;