関数 - dm_execution_performance_counters
適用対象: 
SQL Server Azure Data Factory の SSIS 統合ランタイム
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 | カウンターによって返される値です。 |
例
A. 実行中の実行の統計を返す
次の例では、ID が 34 である処理中の実行の統計を関数で返します。
select * from [catalog].[dm_execution_performance_counters] (34)
B. 実行中のすべての実行の統計を返す
次の例では、権限に応じて、Integration Services サーバーで処理中のすべての実行の統計を関数で返します。
select * from [catalog].[dm_execution_performance_counters] (NULL)
アクセス許可
この関数には、次の権限のいずれかが必要です。
実行のインスタンスの READ および MODIFY 権限
ssis_admin データベース ロールのメンバーシップ
sysadmin サーバー ロールのメンバーシップ
エラーおよび警告
関数が失敗する原因となる条件を以下に示します。
ユーザーには指定された実行に対する MODIFY 権限がない。
指定された実行 ID が無効である。