パラメータファイル

マッピングタスク

次のトランスフォーメーションでは、接続のパラメータ値を定義します。

• - ソース
• - ターゲット
• - ルックアップ
• - SQL

次のトランスフォーメーションでは、オブジェクトのパラメータ値を定義します。

• - ソース
• - ターゲット
• - ルックアップ

また、データフィルタ、式、およびルックアップ式のパラメータの値を定義します。

注: すべてのコネクタがパラメータファイルをサポートしているわけではありません。コネクタが接続とデータオブジェクトの実行時オーバーライドをサポートするかどうかを確認するには、適切なコネクタのヘルプを参照してください。

同期タスク

データフィルタ、式、およびルックアップ式のパラメータの値を定義します。

PowerCenterタスク

データフィルタ、式、およびルックアップ式のパラメータと変数の値を定義します。

パラメータファイルの要件

パラメータスコープ

1. 1タスクセクションで定義した値。
2. 2タスクフローまたはリニアタスクフローセクションで定義した値。
3. 3#USE_SECTIONSで定義した値。
4. 4グローバルセクションで定義した値。

サンプルのパラメータファイル

パラメータファイルの場所。

ローカルマシン

Secure Agentがアクセス可能な場所にファイルを保存します。詳細モードのマッピングの場合は、Secure Agentマシンにファイルを保存する必要があります。

タスクの作成時に［ランタイムオプション］タブでファイル名とディレクトリを入力します。ファイルの絶対パスを入力します。または、$PMシステム変数に関連するパス（$PMRootDir/ParameterFilesなど）を入力します。

次の表に、使用できるシステム変数を示します。

システム変数	説明
$PMRootDir	データ統合サーバーのSecure Agentサービスのルートディレクトリ。 デフォルトは<Secure Agent installation directory>/apps/Data_Integration_Server/dataです。
$PMBadFileDir	行エラーログと拒否ファイルのディレクトリ。 デフォルトは$PMRootDir/errorです。
$PMCacheDir	インデックスファイルとデータキャッシュファイルのディレクトリ。 デフォルトは、$PMRootDir/cacheです。
$PMExtProcDir	外部プロシージャのディレクトリ。 デフォルトは、$PMRootDirです。
$PMLookupFileDir	ルックアップファイルのディレクトリ。 デフォルトは、$PMRootDirです。
$PMSessionLogDir	セッションログのディレクトリ。 デフォルトは$PMRootDir/../logsです。
$PMSourceFileDir	ソースファイルのディレクトリ。 デフォルトは、$PMRootDirです。
$PMStorageDir	セッションやワークフローのリカバリファイルなど、内部プロセスの動作状態に関連するファイルのディレクトリ。 デフォルトは、$PMRootDirです。
$PMTargetFileDir	ターゲットファイルのディレクトリ。 デフォルトは、$PMRootDirです。
$PMTempDir	一時ファイルのディレクトリ。 デフォルトは、$PMRootDir/Tempです。
$PMWorkflowLogDir	ワークフローログのディレクトリ。 デフォルトは$PMRootDir/../logsです。

システム変数の設定済みパスを見つけるには、次のディレクトリにあるpmrdtm.cfgファイルを参照してください。

<Secure Agent installation directory>\apps\Data_Integration_Server\<Data Integration Server version>\ICS\main\bin\rdtm

$PMRootDir以外の変数の設定済みパスは、管理者のデータ統合サーバーシステム設定の詳細にあります。

場所が入力されていない場合、データ統合はデフォルトのパラメータファイルディレクトリを使用します。

クラウドプラットフォーム

Informatica Intelligent Cloud Servicesに保存されている接続を使用できます。次のテーブルは、使用可能な接続タイプと各接続タイプの設定要件を示しています。

接続タイプ	要件
Amazon S3 V2	次の資格情報で作成された接続を使用できます。 - アクセスキー - 秘密鍵 - Region S3バケットはパブリックである必要があります。
Azure Data Lake Store Gen2	次の資格情報で作成された接続を使用できます。 - アカウント名 - ClientID - クライアントシークレット - テナントID - ファイルシステム名 - ディレクトリパス ストレージポイントはパブリックである必要があります。
Google Storage V2	次の資格情報で作成された接続を使用できます。 - サービスアカウントID - サービスアカウントキー - プロジェクトID ストレージバケットはパブリックである必要があります。

タスクを設定する前に接続を作成します。タスクの作成時に、［ランタイムオプション］タブで使用する接続とファイルオブジェクトを選択します。

パラメータファイルに関するルールおよびガイドライン

• •パラメータファイルでパラメータが定義されていない場合、データ統合はタスクで定義されている値を使用します。
• •実行時にオーバーライド可能なソースまたはターゲットのオブジェクトパラメータがマッピングで使用されており、既存のオブジェクトがタスクで選択されている場合、パラメータファイルのパラメータ値をNULLにすることはできません。値がNULLの場合、タスクは失敗します。
• •詳細モードでは、パラメータファイルに入力パラメータ値を設定することはできません。入力パラメータ値に依存するパラメータファイル内の入出力パラメータをオーバーライドする場合は、マッピングタスクで設定する入力パラメータ値に基づいて、入出力パラメータ値が有効であることを確認してください。そうしないと、マッピングが失敗する可能性があります。
例えば、ソース接続が入力パラメータで、ソーステーブルが入出力パラメータの場合、パラメータファイルで設定するテーブル名は、マッピングタスクで設定したソース接続に存在している必要があります。
• •詳細モードでは、デフォルトのパラメータ値がスキーマ名とテーブル名に対して有効であることを確認してください。パラメータファイルを使用してスキーマ名またはテーブル名のオーバーライドのパラメータ値を更新し、デフォルトのパラメータ値が無効である場合、詳細モードのマッピングは失敗します。
• •データ統合はファイルをトップダウンで処理します。
• •同じセクションでパラメータ値が複数回定義されている場合、データ統合は最初の値を使用します。例えば、パラメータファイルには以下のタスクのセクションが含まれます。
[MyProject].[Folder1].[mapping_task1]
$$sourceconn=Oracle
$$filtervariable=ID
$$sourceObject=customer_table
$$targetconn=salesforce
$$sourceconn=ff_2
Mapping_task1を実行すると、sourceconnパラメーターの値はOracleになります。
• •パラメータ値がファイルで定義されている別のパラメータである場合は、パラメータ名の前に1つのドル記号（$）を付けます。データ統合は、最も具体的な範囲内にある変数の最初の値を使用します。例えば、パラメータファイルに以下のようなパラメータ値が含まれていたとします。
[GLOBAL]
$$ffconnection=my_ff_conn
$$var2=California
$var5=North
[Default].[folder5].[sales_accounts]
$$var2=$var5
$var5=south
タスク「sales_accounts」で、「var5」の値は「south」です。var2はvar5として定義されているので、var2も「south」です。
詳細モードでは、パラメータ名の前に2つのドル記号（$$）を付けます。
[GLOBAL]
$$ffconnection=my_ff_conn
$$var2=California
$$var5=North
[Default].[folder5].[sales_accounts]
$$var2=$$var5
$$var5=south
• •タスクが複数回定義されている場合、データ統合はセクションを結合します。
• • 同じタスクに対する複数のセクションでパラメータが定義されている場合、データ統合は最初の値を使用します。例えば、パラメータファイルには以下のタスクのセクションが含まれます。
[Default].[Folder1].[MapTask2]
$$sourceparam=Oracle_Cust

[Default].[Folder1].[MapTask2]
$$sourceparam=Cust_table
$$targetparam=Sales

MapTask2を実行すると、データ統合では次のパラメータ値が使用されます。
• - $$sourceparam=Oracle_Cust
• - $$targetparam=Sales
• •セクション内に存在する場合を除き、パラメータの値はグローバルです。
• •データ統合は、構文エラーのあるセクションを無視します。
• •詳細モードのマッピングのデフォルトの日付/時刻形式は、MM/DD/YYYY HH24:MI:SSです。別の日付/時刻形式を使用するには、マッピングタスクの詳細セッションプロパティDateTime Format Stringを設定します。

パラメータファイルテンプレート

• •マッピングタスクで指定するランタイム値
• •部分的なパラメータ
• •詳細セッションプロパティ
• •システム定義変数

パラメータファイルテンプレートのダウンロード

1マッピングタスクの［ランタイムオプション］タブで、［パラメータファイルテンプレートのダウンロード］をクリックします。
ファイル名は<マッピングタスク名>.paramです。
2以降のタスク実行でこのファイルを使用する場合は、Secure Agentからアクセスできる場所にパラメータファイルを保存します。
タスクの設定時に［ランタイムオプション］タブでファイル名とディレクトリを入力します。

パラメータファイルによる接続の上書き

1マッピングで、入力パラメータを作成します。
1. aパラメータのタイプに［接続］を選択します。
2. b［実行時にパラメータのオーバーライドを許可する］を選択します。
2マッピングで、上書きする接続としてパラメータを使用します。
3マッピングタスクで、パラメータの詳細を次のように定義します。
1. aデフォルトの接続を選択します。
2. b［ランタイムオプション］タブで、パラメータファイルのディレクトリとパラメータファイル名を入力します。
4パラメータファイルで、実行時に使用する値で接続パラメータを定義します。
パラメータ名の前に2個のドル記号（$$）を付けます。例えば、ConParamという名前のパラメータがあり、これを接続OracleCon1で上書きするとします。ランタイム値を次の形式を使用して定義します。
$$ConParam=OracleCon1
5接続を変更する場合は、パラメータファイルのパラメータ値を更新します。

パラメータファイルによるデータオブジェクトの上書き

1マッピングで、入力パラメータを作成します。
1. aパラメータのタイプの［データオブジェクト］を選択します。
2. b［実行時にパラメータのオーバーライドを許可する］を選択します。
2マッピングで、上書きするオブジェクトのオブジェクトパラメータを使用します。
3マッピングタスクで、パラメータの詳細を次のように定義します。
1. aタイプを［シングル］に設定します。
2. bデフォルトデータオブジェクトを選択します。
3. c［スケジュール］タブで、パラメータファイルのディレクトリとファイル名を入力します。
4パラメータファイルで、実行時に使用するオブジェクトを指定します。次のいずれかのタスクを実行します。
• - フラットファイルまたはFTPソース以外のソースの場合は、パラメータ名の前に2つのドル記号（$$）を付けます。例えば、ObjParam1という名前のパラメータがあり、これをデータオブジェクトSourceTableで上書きするとします。ランタイム値を次の形式を使用して定義します。
$$ObjParam1=SourceTable
• - フラットファイルおよびFTPソースの場合は、パラメータ名の前にドル記号（$）を1つ付けます。次の例は、FTP接続のソースディレクトリ、ソースファイル名、およびリモートファイル名を上書きするために使用されるパラメータファイルからのものです。
#USE_SECTIONS
[MyProjectFolder].[MappingTask_ftp]
$Source_dir=/data/test/test_data/Test/
$Source_file=src_ff.txt
$RemoteFileName=/root/FlatFile/Scotty/Test/src_14892_1.txt
[Global]

5オブジェクトを変更する場合は、パラメータファイルのパラメータ値を更新します。

ソースクエリの上書き

1マッピングで、データオブジェクトパラメータを作成します。
2［実行時にパラメータのオーバーライドを許可する］を選択します。
3パラメータをソースオブジェクトとして使用します。
4マッピングタスクで、［ソース］タブの［クエリ］をソースタイプとして選択します。
5デフォルトカスタムクエリを入力します。
6［ランタイムオプション］タブで、パラメータファイル名と場所を入力します。
7パラメータファイルで、タスクの実行時に使用する値を入力します。
8クエリを変更する場合は、パラメータファイルのパラメータ値を更新します。

パラメータファイルを使用した、実行時のターゲットオブジェクトの作成

• •マッピングが、フラットファイル、リレーショナル、またはファイルストレージベースの接続を使用している。
• •マッピングが、マッピングタスク、動的マッピングタスク、またはタスクフローで使用されている。

1マッピングで、入力パラメータを作成します。
1. aパラメータのタイプの［データオブジェクト］を選択します。
2. b［実行時にパラメータのオーバーライドを許可する］を選択します。
2マッピングで、パラメータをターゲットオブジェクトとして使用します。
3タスクで、パラメータの詳細を次のように定義します。
1. aタイプを［シングル］に設定します。
2. bデフォルトデータオブジェクトを選択します。
3. c［スケジュール］タブで、パラメータファイルのディレクトリとファイル名を入力します。
4パラメータファイルで、作成するターゲットオブジェクトの名前を指定します。
パラメータ名の前に2個のドル記号（$$）を付けます。例えば、TargetObjParamという名前のパラメータがあり、MyTargetという名前のターゲットオブジェクトを作成する場合は、ランタイム値を次の形式を使用して定義します。
$$TargetObjParam=MyTarget

ファイルストレージベースのコネクタタイプである場合は、オブジェクト名にパスを含めます。パスを含めない場合、接続で指定されたデフォルトのパスにターゲットが作成されます。
5オブジェクトを変更する場合は、パラメータファイルのパラメータ値を更新します。