関数 - dm_execution_performance_counters

  • [アーティクル]

適用対象: SQL Server Azure Data Factory の SSIS Integration Runtime

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 が無効である。