セッションパラメータは、データベース接続やソースファイルとターゲットファイルなど、セッションの実行ごとに変更できる値を示します。

セッションパラメータには、ユーザー定義パラメータまたは組み込みパラメータのいずれかがあります。セッションまたはワークフローのプロパティでユーザー定義のセッションパラメータを使用し、パラメータファイルでその値を定義します。セッションを実行する際は、Integration Serviceではパラメータファイル内のパラメータをセッション内のパラメータと一致させます。 セッションプロパティ値にパラメータファイルの値を使用します。パラメータファイルでは、フォルダ名とセッション名は大文字/小文字が区別されます。

例えば、ログファイルにセッションログを書き込むことができます。セッションプロパティで、セッションログファイル名として$PMSessionLogFileを使用し、パラメータファイルで$PMSessionLogFileをTestRun.txtに設定します。セッションを実行する際に、Integration Serviceによって、TestRun.txtと名付けられたセッションログが作成されます。

ユーザー定義のセッションパラメータにはデフォルト値がないので、パラメータファイルでこれらを定義する必要があります。Integration Serviceによってユーザー定義のセッションパラメータの値が検索できない場合、セッションが失敗するか、空の文字列をデフォルト値とするか、または実行時にパラメータの展開に失敗します。

pmcmd

を使用してセッションを開始すると、各種パラメータファイルを使用して1つのセッションを実行できます。

pmcmd

を使用して設定したパラメータファイルは、セッションまたはワークフロープロパティでパラメータファイルを上書きします。

組み込みセッションパラメータを使用して、フォルダ名、サービス名、セッション実行統計などのランタイム情報を取得します。組み込みセッションパラメータは、セッション実行後のシェルコマンド、SQLコマンド、およびメールメッセージの中に使用できます。それらのセッションパラメータは、DesignerおよびWorkflow Managerでセッションパラメータを受け入れる入力フィールドに使用できます。Integration Serviceは組み込みセッションパラメータの値を設定します。組み込みセッションパラメータ値は、パラメータファイル内には定義することができません。これらのパラメータは、Integration Serviceでセッションの実行時に展開されます。

以下の表に、ユーザー定義のセッションパラメータを示します。

以下の表に、組み込みセッションパラメータを示します。

適切なプレフィックスおよびサフィックスを使用してパラメータ名を定義します。 例えば、ソースインスタンスが「Customers」という名前の場合、ソーステーブル名を示すパラメータは$PMCustomers@TableNameとなります。ソース修飾子が「SQ_Customers」という名前の場合、影響を受けた行のソース数を示すパラメータは$PMSQ_Customers@numAffectedRowsとなります。