dm_execution_performance_counters (SSISDB データベース)
Integration Services サーバーで処理中の実行のパフォーマンス統計を返します。
構文
dm_execution_performance_counters [ @execution_id = ] execution_id
引数
[ @execution\_id = ] execution_id
1 つまたは複数のパッケージを含む実行の一意識別子。 パッケージ実行タスクで実行されるパッケージは、親パッケージと同じ実行で実行されます。実行 ID が指定されていない場合は、複数の実行のパフォーマンス統計が返されます。 ssis_admin データベース ロールのメンバーである場合は、処理中のすべての実行のパフォーマンス統計が返されます。 ssis_admin データベース ロールのメンバーでない場合は、処理中の実行のうち読み取り権限を持つ実行のパフォーマンス統計が返されます。 execution_id は BigInt 型です。
解説
次の表に、dm_execution_performance_counter 関数によって返されるカウンター名の値を一覧で示します。
カウンター名 |
説明 |
---|---|
BLOB bytes read |
データ フロー エンジンがすべてのソースから読み取るバイナリ ラージ オブジェクト (BLOB) データのバイト数。 |
BLOB bytes written |
データ フロー エンジンがすべての出力先に書き込む BLOB データのバイト数。 |
BLOB files in use |
データ フロー エンジンがスプールのために使用している BLOB ファイル数。 |
Buffer memory |
物理メモリや仮想メモリなど、Integration Services のバッファーによって使用されるメモリ量。 |
Buffers in use |
すべてのデータ フロー コンポーネントおよびデータ フロー エンジンが使用している、すべての種類のバッファー オブジェクト数。 |
Buffers spooled |
ディスクに書き込むバッファーの数。 |
Flat buffer memory |
すべてのフラット バッファーが使用するメモリ量 (バイト単位)。 フラット バッファーはコンポーネントがデータの格納に使用するメモリ ブロックです。 |
Flat buffers in use |
データ フロー エンジンが使用するフラット バッファー数。 フラット バッファーはすべてプライベート バッファーです。 |
Private buffer memory |
すべてのプライベート バッファーが使用しているメモリ量。 プライベート バッファーは、変換が一時作業のために使用するバッファーです。 データ フロー エンジンがデータ フローをサポートするためにバッファーを作成する場合、バッファーはプライベートではありません。 |
Private buffers in use |
変換が一時作業のために使用するバッファー数。 |
Rows read |
実行準備ができている行の合計数。 |
Rows written |
実行によって書き込まれた行の合計数。 |
戻り値
dm_execution_performance_counters 関数は、1 つの処理中の実行に対して次の列を持つ表を返します。 返す情報は、実行に含まれているすべてのパッケージが対象です。 処理中の実行がない場合は、空の表を返します。
列名 |
列の型 |
説明 |
解説 |
---|---|---|---|
execution_id |
BigInt NULL は無効な値です。 |
パッケージを含む実行の一意識別子。 |
|
counter_name |
nvarchar(128) |
カウンターの名前。 |
値の「解説」セクションを参照してください。 |
counter_value |
BigInt |
カウンターによって返される値です。 |
使用例
次の例では、ID が 34 である処理中の実行の統計を関数で返します。
select * from [catalog].[dm_execution_performance_counters] (34)
次の例では、権限に応じて、Integration Services サーバーで処理中のすべての実行の統計を関数で返します。
select * from [catalog].[dm_execution_performance_counters] (NULL)
権限
この関数には、次の権限のいずれかが必要です。
実行のインスタンスの READ および MODIFY 権限
ssis_admin データベース ロールのメンバーシップ
sysadmin サーバー ロールのメンバーシップ
エラーおよび警告
関数が失敗する原因となる条件を以下に示します。
ユーザーには指定された実行に対する MODIFY 権限がない。
指定された実行 ID が無効である。