Amazon S3コネクタ > Amazon S3を使用したマッピングとマッピングタスク > マッピングタスクのマッピングオブジェクト

マッピングタスクのマッピングオブジェクト

マッピングタスクを設定するときに、Amazon S3ソースおよびターゲットの詳細プロパティを構成できます。

マッピングタスクのAmazon S3ソース

マッピングタスクで使用するAmazon S3ソース接続の場合、マッピングタスクウィザードの［ソース］ページで詳細プロパティを設定できます。

以下の詳細プロパティを設定できます。

プロパティ	説明
S3ファイルの分割ダウンロードを有効にする	大きなAmazon S3オブジェクトを複数パーツに分けてダウンロードします。 Secure Agentは、Amazon S3のオブジェクトを複数パーツに分けてダウンロードします。 Amazon S3オブジェクトのファイルサイズが5MBを超える場合は、オブジェクトを複数パーツに分けて同時にダウンロードできます。
ヘッダー行番号	Amazon S3コネクタにはこのプロパティは反映されません。
データの読み込み開始行	Secure Agentがデータを読み取る場所から行番号を指定します。デフォルトは1です。注: ヘッダーからデータを読み取るには、［ヘッダー行番号］と［データの読み込み開始行］のフィールドに同じ値を指定する必要があります。
ステージングファイルの場所	Amazon S3のステージングディレクトリ。 Secure Agentランタイム環境でタスクを実行する場合は、ランタイム環境内の対応するSecure Agentマシンで利用できるディレクトリパスを指定します。ディレクトリパスを指定すると、Secure Agentは、次の形式で指定したパーティションの数に応じてフォルダを作成します。InfaS3Staging<00/11><timestamp>_<partition number>。ここで、00は読み取り操作を表し、11は書き込み操作を表します。例えば、InfaS3Staging000703115851268912800_0のようになります。注: 新しいディレクトリに一時ファイルが作成されます。ディレクトリ名を指定するとき、同じ名前のフォルダがすでに存在する場合、Secure Agentはそのフォルダのコンテンツを削除します。指定した場所に対する書き込み権限が必要です。ディレクトリパスを指定しない場合、Secure Agentはステージングファイルの場所として一時ディレクトリを使用します。ホステッドエージェントのランタイム環境でタスクを実行する場合は、ステージングディレクトリの場所を空のままにしてください。ホステッドエージェントは、一時的な場所にディレクトリを作成します。
パーツサイズ	オブジェクトのパーツサイズを指定します。デフォルトは5MBです。
トレースレベル	ログファイルに表示される詳細情報の量を設定します。［簡易］、［ノーマル］、［詳細 - 初期化］、［詳細 - データ］から選択できます。デフォルトは［ノーマル］です。

マッピングタスクのマッピングターゲット

マッピングタスクで使用されるAmazon S3 マッピングの場合、マッピングタスクウィザードの［ターゲット］ページでマッピング設定できます。

以下の詳細プロパティを設定できます。

プロパティ	説明
暗号化タイプ	データの暗号化に使用する方法。次のいずれかの値を選択します。 - なし。データは暗号化されません。 - クライアントサイド暗号化。 - 区切りファイルをAmazonバケットにアップロード中に、Secure Agentによりデータが暗号化されます。 - Amazon S3接続プロパティでマスタ対称キーまたは顧客マスタキーIDを指定する場合は、詳細プロパティでクライアントサイド暗号化を選択する必要があります。 - サーバーサイド暗号化。 - Amazon S3接続プロパティで顧客マスタキーIDを指定する場合は、詳細プロパティでサーバーサイド暗号化を選択する必要があります。 - 詳細プロパティでサーバーサイド暗号化を選択し、接続プロパティで顧客マスタキーIDを指定しない場合、データの暗号化にはAmazon S3が管理する暗号化キーが使用されます。
フォルダパス	Amazon S3オブジェクトへの完全なパス。バケット名と任意のフォルダ名が含まれている必要があります。フォルダパスの末尾にスラッシュを使用しないでください。以下に例を示します。 <バケット名>/<マイフォルダ名> 実行時に指定されたフォルダパスで、接続の作成時に指定されたパスが上書きされます。
圧縮タイプ	データをAmazon S3に書き込むとき、データをGZIP形式で圧縮します。 Amazon S3のターゲットファイルの拡張子は .gz になります。Secure Agentはデータを圧縮してから、そのデータをAmazon S3バケットに送信します。デフォルトは［なし］です。
パーツサイズ	オブジェクトのパーツサイズを指定します。デフォルトは5MBです。
TransferManagerスレッドプールサイズ	データを並行して書き込むスレッドの数を指定します。 Amazon S3コネクタはAWS TransferManager APIを使用して、大きなオブジェクトを複数パーツに分けてAmazon S3にアップロードします。ファイルサイズが5MBを超える場合、マルチパーツアップロードを設定して、複数パーツに分けたオブジェクトを並行してアップロードできます。［TransferManagerスレッドプールサイズ］に50を超える値を設定した場合、値は50に戻されます。デフォルトは10です。
パーティションファイルのマージ	該当なし。
分散カラム	実行時に複数ターゲットファイルの作成に使用するカラムの名前を指定します。
ステージングファイルの場所	Amazon S3のステージングディレクトリ。 Secure Agentランタイム環境でタスクを実行する場合は、ランタイム環境内の対応するSecure Agentマシンで利用できるディレクトリパスを指定します。ディレクトリパスを指定すると、Secure Agentは、次の形式で指定したパーティションの数に応じてフォルダを作成します。 InfaS3Staging<00/11><タイムスタンプ>_<パーティション番号> ここで、00は読み取り操作、11は書き込み操作を表します。以下に例を示します。 InfaS3Staging000703115851268912800_0 注: 新しいディレクトリに一時ファイルが作成されます。ディレクトリ名を指定するとき、同じ名前のフォルダがすでに存在する場合、Secure Agentはそのフォルダのコンテンツを削除します。指定した場所に対する書き込み権限が必要です。ディレクトリパスを指定しない場合、Secure Agentはステージングファイルの場所として一時ディレクトリを使用します。ホステッドエージェントのランタイム環境でタスクを実行する場合は、ステージングディレクトリの場所を空のままにしてください。ホステッドエージェントは、一時的な場所にディレクトリを作成します。
オブジェクトタグ	Amazon S3バケットに格納されているオブジェクトに、1つまたは複数のタグを追加できます。キー値のペアを入力するか、キー値のペアを含むファイルパスを指定することができます。詳細については、オブジェクトタグを参照してください。
成功ファイルディレクトリ	該当なし。
エラーファイルのディレクトリ	該当なし。

ターゲットの指定

マッピングの結果は、既存のターゲットに保存することも、新たにターゲットを作成して保存することもできます。ターゲットを作成することを選択した場合、タスクの実行時にエージェントによりターゲットが作成されます。

ターゲットのプロパティを指定するには、次の手順に従います。

1. マッピングでターゲットトランスフォーメーションを選択します。

2. ［受信フィールド］タブで、ターゲットに含めるフィールドを指定するためのフィールドルールを設定します。

3. ターゲットを指定するには、［ターゲット］タブをクリックします。

4. ターゲット接続を選択します。

5. ターゲットタイプとして、［単一オブジェクト］または［パラメータ］を選択します。

6. ターゲットオブジェクトまたはパラメータを指定します。.csvターゲットファイル名を指定する必要があります。

- 実行時にターゲットファイルを作成するには、拡張子を含めてターゲットファイルの名前を入力します（例: Accounts.csv）。
- ファイル名にタイムスタンプを含める場合は、［特殊文字の処理］をクリックして、ファイル名に特殊文字を追加します。例えば、すべてのタイムスタンプ情報を含める場合は、 Accounts_%d%m%y%T.csvという特殊文字を追加します。

7. ファイルの形式オプションを設定する場合は、［形式オプション］をクリックして［OK］をクリックします。

8. ［選択］をクリックして、ターゲットオブジェクトを選択します。実行時に既存のターゲットオブジェクトを選択するか、新しいターゲットオブジェクトを作成して、オブジェクト名を指定することができます。

次の図は、［ターゲットオブジェクト］ボックスを示します。

The following image shows the Target Object box where you can select an existing target object or create a new target object at the runtime.

9. 必要に応じて、ターゲットの詳細プロパティを指定します。