次の方法で共有


データ コレクションの管理

適用対象: SQL Server

SQL Server Management Studio またはTransact-SQL のストアド プロシージャと関数を使用して、データ コレクションの有効化または無効化、コレクション セットの構成の変更、管理データ ウェアハウスのデータの表示など、データ コレクションのさまざまな側面を管理します。

SSMS を使用したデータ コレクションの管理

SQL Server Management Studio のオブジェクト エクスプローラーを使用することで、次のデータ コレクター関連のタスクを実行します。

Transact-SQL を使用したデータ コレクションの管理

データ コレクターにはストアド プロシージャの豊富なコレクションがあり、それらを使用してデータ コレクターの関連タスクを実行することができます。 たとえば、Transact-SQL を使用すると、次のタスクを実行できます。

さらに、msdb および管理データ ウェアハウスのデータベースの構成データ、実行ログ データ、および管理データ ウェアハウスに格納されているデータの取得に使用できる関数やビューもあります。

用意されているストアド プロシージャ、関数、およびビューを使用して、独自のエンド ツー エンドのデータ コレクション シナリオを作成することもできます。

重要

通常のストアド プロシージャとは異なり、データ コレクターのストアド プロシージャは、厳密に定義された型パラメーターを使用し、自動データ型変換はサポートされていません。 これらのパラメーターが、引数の説明で指定されている正しいデータ型で呼び出されないと、このストアド プロシージャではエラーが返されます。

SQL Server Management Studio を使用して、付属のコード サンプルを作成して実行します。 詳細については、「 オブジェクト エクスプローラー」を参照してください。 また、任意のエディターでクエリを作成し、.sql というファイル名拡張子を持つテキスト ファイルに保存することもできます。 このクエリは、Windows コマンド プロンプトから sqlcmd ユーティリティを使用して実行できます。 詳細については、「sqlcmd - ユーティリティの使用」を参照してください。

ストアド プロシージャとビュー

次のセクションでは、データベース エンジンのデータ コレクションを操作するために使用するストアド プロシージャとビューについて説明します。

データ コレクターの操作

次の表に、データ コレクターの操作に使用できるストアド プロシージャを示します。

プロシージャ名 説明
sp_syscollector_enable_collector データ コレクターを有効にします。
sp_syscollector_disable_collector データ コレクターを無効にします。

コレクション セットの操作

次の表に、コレクション セットの操作に使用できるストアド プロシージャを示します。

プロシージャ名 説明
sp_syscollector_run_collection_set コレクション セットを要求時に実行します。
sp_syscollector_start_collection_set コレクション セットを開始します。
sp_syscollector_stop_collection_set コレクション セットを停止します。
sp_syscollector_create_collection_set コレクション セットを作成します。
sp_syscollector_delete_collection_set コレクション セットを削除します。
sp_syscollector_update_collection_set コレクション セットの構成を変更します。
sp_syscollector_upload_collection_set コレクション セットのデータを管理データ ウェアハウスにアップロードします。 これは、実質的にはオンデマンドのアップロードです。

コレクション アイテムの操作

次の表に、コレクション アイテムの操作に使用できるストアド プロシージャを示します。

プロシージャ名 説明
sp_syscollector_create_collection_item コレクション アイテムを作成します。
sp_syscollector_delete_collection_item コレクション アイテムを削除します。
sp_syscollector_update_collection_item コレクション アイテムを更新します。

コレクター型の操作

次の表に、コレクター型の操作に使用できるストアド プロシージャを示します。

プロシージャ名 説明
sp_syscollector_create_collector_type コレクター型を作成します。
sp_syscollector_update_collector_type コレクター型を更新します。
sp_syscollector_delete_collector_type コレクター型を削除します。

構成情報の取得

次の表に、構成情報や実行ログ データの取得に使用できるビューを示します。

ビューの名前 説明
syscollector_config_store データ コレクターの構成を取得します。
syscollector_collection_items コレクション アイテムの情報を取得します。
syscollector_collection_sets コレクション セットの情報を取得します。
syscollector_collector_types コレクター型の情報を取得します。
syscollector_execution_log コレクション セットとパッケージの実行に関する情報を取得します。
syscollector_execution_stats タスクの実行に関する情報を取得します。
syscollector_execution_log_full 実行ログがいっぱいになったときに情報を取得します。

管理データ ウェアハウスへのアクセスを構成する

次の表に、管理データ ウェアハウスへのアクセスの構成に使用できるストアド プロシージャを示します。

プロシージャ名 説明
sp_syscollector_set_warehouse_database_name 管理データ ウェアハウスの接続文字列で定義されているデータベース名を指定します。
sp_syscollector_set_warehouse_instance_name 管理データ ウェアハウスの接続文字列で定義されているインスタンスを指定します。

管理データ ウェアハウスの構成

次の表に、管理データ ウェアハウスの構成の操作に使用できるストアド プロシージャを示します。

プロシージャ名 説明
core.sp_create_snapshot 管理データ ウェアハウス内にコレクションのスナップショットを作成します。
core.sp_update_data_source データ コレクションのデータ ソースを更新します。
core.sp_add_collector_type 管理データ ウェアハウスにコレクター型を追加します。
core.sp_remove_collector_type 管理データ ウェアハウスからコレクター型を削除します。
core.sp_purge_data 管理データ ウェアハウスからデータを削除します。

アップロード パッケージの操作

次の表に、アップロード パッケージの操作に使用できるストアド プロシージャを示します。

プロシージャ名 説明
sp_syscollector_set_cache_window データのアップロードの再試行回数を構成します。
sp_syscollector_set_cache_directory アップロードを次に再試行するまでのデータの一時ストレージを指定します。

データ コレクションの実行ログの操作

次の表に、データ コレクションの実行ログの操作に使用できるストアド プロシージャを示します。

プロシージャ名 説明
sp_syscollector_delete_execution_log_tree 実行ログからコレクション セットのエントリを削除します。

関数

次の表に、実行情報とトレース情報の取得に使用できる関数を示します。

関数名: 説明
fn_syscollector_get_execution_details 特定のパッケージに関する Get SSIS の実行ログ データを取得します。
fn_syscollector_get_execution_stats コレクション セットまたはパッケージの実行統計を取得します。 この情報には、ログに記録されたエラーが含まれます。
snapshots.fn_trace_getdata ジェネリック SQL トレース コレクター型を使用したデータ収集時にログに記録されたイベントを取得します。