マッピング > マッピング > マッピングのデータプレビュー
  

マッピングのデータプレビュー

マッピングを作成するときに、個別のトランスフォーメーションのデータをプレビューして、マッピングロジックをテストできます。
トランスフォーメーションの［プレビュー］パネルでトランスフォーメーションのデータをプレビューします。処理するソース行の数と、プレビュージョブを実行するランタイム環境を選択します。
プレビュージョブを実行すると、データ統合では、選択されたトランスフォーメーションの直下のダウンストリームに仮想ターゲットを含む一時的なマッピングタスクが作成されます。データ統合は、プレビュージョブの完了後に一時的なタスクを破棄します。ジョブが完了すると、データ統合では、選択したトランスフォーメーションによって変換されたデータが［プレビュー］パネルに表示されます。
次の図は、トランスフォーメーションでプレビュージョブを実行した後のソータトランスフォーメーションの［プレビュー］パネルを示しています。
マッピングに、ソース、フィルタ、ソータおよびターゲットトランスフォーメーションが含まれています。ソータトランスフォーメーションが選択され、［プレビュー］パネルが表示されています。［プレビュー］パネルには、フィルタおよびソータトランスフォーメーションにより処理されたデータの行が示されています。
マッピングでデータをプレビューするには、データ統合データプレビューアロールがあるか、ユーザーロールにデータ統合の「データ - プレビュー」機能特権が必要です。
フィルタトランスフォーメーションなどのアクティブなトランスフォーメーションで、プレビューする行数に制限を適用すると、その行制限がソースにも適用されます。フィルタトランスフォーメーションでは、フィルタ条件によっては、ソースプレビューウィンドウよりフィルタプレビューウィンドウの方が、表示される行数が少ないことがあります。
マッピングで入力パラメータが使用されている場合は、データをプレビューできます。プレビューを実行すると、データ統合でパラメータ値を入力するように求められます。
Mapplet Designerでマップレットを開発するときには、データをプレビューすることはできません。テーブル名に特殊文字、絵文字、Unicode文字が含まれるデータをプレビューすることはできません。
マッピングでBusiness 360 Events Connectorを使用している場合、トランスフォーメーションのデータをプレビューすることはできません。

マッピングのプレビュー動作

選択したトランスフォーメーションまたはアップストリームトランスフォーメーションにマッピング検証エラーがない場合は、トランスフォーメーションのデータをプレビューできます。データ統合では、選択したトランスフォーメーションのマッピング結果が表示されます。また、アップストリームトランスフォーメーションの結果が生成されます。
次のトランスフォーメーションを除いて、任意のトランスフォーメーションのデータをプレビューできます。

マッピングのプレビュージョブの実行

選択したトランスフォーメーションの［プレビュー］パネルでデータプレビュージョブを実行します。
マッピングのデータプレビュージョブを実行する前に、次の条件が満たされていることを確認します。
データプレビュージョブを実行するには:
    1 Mapping Designerでトランスフォーメーションを選択します。
    2［プレビュー］パネルを開きます。
    3［プレビューの実行］をクリックします。
    4 プレビューの実行ウィザードで、プレビューするソース行の数と、プレビュージョブを実行するランタイム環境を入力します。
    入力する番号は、マッピングの各ソースに適用されます。例えば、10行を選択し、マッピングに複数のソースが含まれている場合、プレビュージョブは各ソースの最初の10行を処理します。
    最大で999,999,999行を選択できます。
    警告: 多数のソース行を選択すると、Secure Agentマシンでストレージまたはパフォーマンスの問題が発生する可能性があります。
    5プレビューしているマッピングの一部が入力パラメータを使用している場合は、［次へ］をクリックしてパラメータ値を入力します。
    6［プレビューの実行］をクリックします。
データ統合で、選択したトランスフォーメーションの［プレビュー］パネルに結果が表示されます。
プレビュージョブは、データ統合の［マイジョブ］ページ、およびMonitorの［すべてのジョブ］ページと［実行中のジョブ］ページで監視できます。データ統合では、プレビュージョブに<マッピング名>-<インスタンス番号>という名前が付与されます（例: MyMapping_1）。データプレビュージョブのセッションログをダウンロードできます。ただし、SQL ELTモードのマッピングのデータプレビュージョブのセッションログはダウンロードできません。
プレビュージョブを再開するには、［プレビュー］パネルでジョブを再度実行します。［マイジョブ］ページまたは［すべてのジョブ］ページでデータプレビュージョブを再開することはできません。

マッピングのプレビュー結果の表示

データ統合では、選択したトランスフォーメーションとアップストリームトランスフォーメーションのプレビュー結果がマッピングに生成されます。データ統合では、Secure Agentマシンにプレビュー結果がCSVファイルで保存されます。
データ統合では、選択したトランスフォーメーションと各アップストリームトランスフォーメーションの［プレビュー］パネルにプレビュー結果が表示されます。データ統合では、ダウンストリームトランスフォーメーションのプレビュー結果は表示されません。
トランスフォーメーションに複数の出力グループがあり、別の出力グループの結果をプレビューする場合は、［プレビュー］パネルの上部にある［出力グループ］メニューから出力グループを選択します。
プレビュー結果をダウンロードするには、［プレビュー］パネルの［ダウンロード］をクリックします。
データ統合では、Secure Agentマシンにプレビュー結果がCSVファイルで保存されます。プレビューを実行すると、データ統合では、選択したトランスフォーメーション用に1つのCSVファイルが作成され、マッピングのアップストリームトランスフォーメーションごとに1つのCSVファイルが作成されます。トランスフォーメーションに複数の出力グループがある場合、データ統合では出力グループごとに1つのCSVファイルが作成されます。同じプレビューを複数回実行すると、データ統合ではCSVファイルが上書きされます。
デフォルトでは、ファイルは次のディレクトリに格納されています。
<Secure Agentのインストールディレクトリ>/apps/Data_Integration_Server/data/cache/preview
Secure Agentで実行されるデータ統合サービスの$PMCacheDirプロパティの値を組織管理者が変更しない限り、CSVファイルはこのディレクトリに保存されます。Secure Agentサービスの詳細については、管理者ヘルプにある。
注: Secure Agentマシンに、Secure Agentを使用してデータプレビューを実行する可能性のあるすべてのユーザーのプレビューデータを保存するのに十分なディスク容量があることを確認してください。
データ統合はプレビューディレクトリを24時間ごとにパージします。パージ時に、データ統合は24時間よりも前のファイルを削除します。
注: CSV形式では、integer型、double型、string型、およびtext型のNULL値は空として表示されます。

プレビュー結果のカスタマイズ

［プレビュー］パネルに表示するカラムを選択できます。また、カラムを並べ替えることもできます。［設定］ダイアログの［プレビュー］パネルをカスタマイズします。
次の画像は、［設定］ダイアログを示しています。
この画像は、左側にある［使用可能なカラム］領域と右側にある［選択されたカラム］領域を示しています。カラム名は左右両方の領域に表示されます。［選択されたカラム］領域では［MiscDate］カラムが選択されています。選択したカラムを左側の［使用可能なカラム］に移動したり、［選択したカラム］領域で上下に移動したりするための方向矢印があります。
［設定］ダイアログを開くには、［プレビュー］パネルの［設定］アイコンをクリックします。［選択したカラム］領域のカラムが［プレビュー］パネルに表示されます。［プレビュー］パネルからカラムを非表示にするには、カラムを選択して［使用可能なカラム］領域に移動します。［プレビュー］パネルでカラムを並べ替えるには、［選択したカラム］領域でカラム名を選択し、上下に移動します。