次の方法で共有


sp_syscollector_set_cache_window (Transact-SQL)

適用対象: SQL Server

エラーが発生した場合にデータのアップロードを試行する回数を設定します。 データのアップロード時にエラーが発生した場合に再試行することで、収集したデータが失われるリスクが軽減されます。

Transact-SQL 構文表記規則

構文

sp_syscollector_set_cache_window [ [ @cache_window = ] cache_window ]
[ ; ]

引数

[ @cache_window = ] cache_window

管理データ ウェアハウスへの失敗したデータのアップロードが、データを失うことなく再試行される回数。 @cache_windowint で、既定値は 1 です。 @cache_window には、次のいずれかの値を指定できます。

説明
-1 アップロード エラーが発生した場合にそのすべてのアップロード データをキャッシュします。
0 アップロードエラーのデータをキャッシュしないでください。
n n以前のアップロード エラー (n>= 1) からのデータをキャッシュします。

リターン コードの値

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

解説

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

アクセス許可

このプロシージャを実行するには、(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;