DataStage ジョブをマイグレーションするには、ジョブ情報を含む ISX ファイルを作成してインポートします。 該当する場合は、その他のマイグレーション後タスクを実行します。
手順
ISX ファイルの作成およびインポート
以下の表にリストされているいずれかの方法を使用して、ISX ファイルを作成およびエクスポートします。
オプション | 説明 |
---|---|
ISTOOL | ISTOOL を使用して ISX ファイルを作成し、ファイルをエクスポートします。 手順については、InfoSphere DataStage 資産および QualityStage 資産のエクスポート・コマンド ならびに Information Server コンポーネントをエクスポート・インポートするための ISTOOL の使用方法を参照してください。 |
MettleCI | サード・パーティー・サービスであるMettleCIを使用して、サーバー・ジョブ・デザインを同等のパラレル・ジョブ・デザインに変換してから、ISXファイルを作成し、そのファイルをシステムにエクスポートします。 詳しくは、「MettleCLI 文書」を参照してください。 |
InfoSphere Information Server Manager GUI クライアント | ISX ファイルをエクスポートするには、Information Server Manager GUI クライアントを使用します。 詳しい手順については、「資産のエクスポート」を参照してください |
- 既存のプロジェクトを開くか、新規プロジェクトを作成します。
- プロジェクトの 「資産」 タブで、 をクリックします。
- 「ローカル・ファイル」 タブをクリックし、ローカル・コンピューターから ISX ファイルをアップロードします。 次に「作成」をクリックします。注: ISX ファイルは、デスクトップまたはネットワーク・ドライブ上に存在している必要があります。 ファイルを別のアプリケーションから添付ファイルとしてドラッグしないでください。
資産インポート・レポートには、ISX インポートのトラブルシューティングに使用できる状況情報とエラー・メッセージが含まれています。 レポートの表示とトラブルシューティングへの使用については、資産インポートレポート (DataStage) を参照してください。
接続のマイグレーション
マイグレーションされたジョブに接続が含まれている場合は、 DataStage を参照してください。
ステージのマイグレーション
ステージ | 考慮事項 |
---|---|
ストアード・プロシージャー | ストアード・プロシージャーは、対応するプラットフォーム・コネクターにマイグレーションされます。 Db2® タイプのコネクター上のすべてのストアード・プロシージャーは、標準 Db2 コネクターにマイグレーションされます。これには、 Db2 for i や Db2 for z/OS®などのコネクター用のストアード・プロシージャーも含まれます。 Db2 コネクターを正しいコネクター・タイプに手動で置き換え、ストアード・プロシージャー呼び出しにコピーします。 ストアード・プロシージャーで入力パラメーターと出力パラメーターを検出できない場合は、そのまま残され、マイグレーション後に新しい構文と一致するように更新する必要があります。 詳細は、ストアド・プロシージャをDataStageを参照してください。 |
パラメーター・セットおよび PROJDEF 値の確認
パラメーター・セットを調べて、マイグレーション後のデフォルト値が正しいことを確認してください。
PROJDEF パラメーター・セットは、マイグレーションによって作成および更新されます。 PROJDEF パラメーターを設定してジョブをマイグレーションする場合は、 PROJDEF パラメーター・セットを検討し、そのデフォルト値を指定します。 その後、フローおよびジョブ実行内で、 $PROJDEF であるパラメーター値は、 PROJDEF パラメーター・セットの値を使用します。
PROJDEF パラメータの値が DSParams ファイルで定義されている場合は、cpdctl dsjob create-dsparams
コマンドを使ってその値をプロジェクトの実行環境に転送します。 詳細はDSParamsを参照。
dsjob コマンド・ライン・インターフェースを使用するスクリプトの更新
- cpdctl のダウンロード: https://github.com/IBM/cpdctl/releases/
- ソース・シェル・スクリプト (source.sh) を作成して、cpdctl を構成します。 暗号鍵のテキスト・ファイル
key.txt
を作成します。 次の例を参照してください。#!/bin/bash export CPDCTL_ENCRYPTION_KEY_PATH=~/key.txt export DSJOB_URL=https://example.com export DSJOB_ZEN_URL=https://example.com export CPDCTL_ENABLE_DSJOB=true export CPDCTL_ENABLE_DATASTAGE=true export DSJOB_USER=admin export DSJOB_PWD=<Password> cpdctl config user set dscpserver-user --username $DSJOB_USER --password $DSJOB_PWD cpdctl config profile set dscpserver-profile --url $DSJOB_URL cpdctl config context set dscpserver-context --user dscpserver-user --profile dscpserver-profile cpdctl config context use dscpserver-context cpdctl dsjob list-projects
dsjob
への参照をcpdctl dsjob
に変更します。 DataStage コマンド行スタイルに適合するように、コマンド行オプションを調整することが必要な場合があります。 DataStageコマンドラインツールを参照してください。
シーケンス・ジョブのマイグレーション
ISX ファイルをインポートして、シーケンス・ジョブをパイプライン・フローにマイグレーションできます。 CEL で式を書き直し、いくつかのパイプライン・ノードの値を手動で再選択してください。 詳細については、以下のトピックを参照してください:Run flows in sequence with Orchestration Pipelines および Migrating and constructing pipeline flows for DataStage を参照してください。 BASIC ルーチンをスクリプトとして書き換える方法については、DataStage の BASIC ルーチンの移行を参照してください。
ジョブ前およびジョブ後のサブルーチンのルーチン・コードの書き直し
ジョブ前サブルーチンおよびジョブ後サブルーチンをマイグレーションすると、ルーチン・コードは /ds-storage/projects/<projectName>/scripts/DSU.<RoutineName>.shの下の .sh スクリプトに保管されます。 Migrating BASIC routines in DataStage の手順に従って、BASICルーチンと同じようにルーチン・コードを書き換えて、出力引数を取得しますが、before/after-jobサブルーチンの終了文を含めます。 次の例を参照してください。# TODO: Update the following json string and print it as the last line of the standard output.
ErrorCode=0
echo "{\"ErrorCode\":\"$ErrorCode\"}"
exit $ErrorCode