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_windowは int で、既定値は 1. @cache_windowには、次のいずれかの値を指定できます。

Value	説明
-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;

関連するコンテンツ

• システム ストアド プロシージャ (Transact-SQL)
• sp_syscollector_set_cache_directory (Transact-SQL)