0 / 0
資料の 英語版 に戻る
DataStage ジョブのマイグレーション
最終更新: 2024年12月09日
DataStage ジョブのマイグレーション

DataStage ジョブをマイグレーションするには、ジョブ情報を含む ISX ファイルを作成してインポートします。 該当する場合は、その他のマイグレーション後タスクを実行します。

手順

DataStage®をマイグレーションするには、以下のタスクを実行します。 ISX ファイルをインポートした後、マイグレーションされたジョブの接続、ステージ、およびその他のコンポーネントに応じて、他のタスクが適用される場合があります。
  1. ISX ファイルの作成およびインポート
  2. 接続のマイグレーション
  3. ステージのマイグレーション
  4. パラメーター・セットおよび PROJDEF 値の確認
  5. dsjob コマンド・ライン・インターフェースを使用するスクリプトの更新
  6. シーケンス・ジョブのマイグレーション
  7. ジョブ前およびジョブ後のサブルーチンのルーチン・コードを書き直します。

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 ファイルのエクスポートに、パラメーター・セットやテーブル定義などの依存関係が含まれていることを確認してください。 フォルダー・サポートが有効になっている場合、インポート時にフォルダー構造が再作成されます。
注意: DataStage, Orchestration Pipelines, IBM Cloud® Object Storage などのサービスは、.ISX ファイルをインポートする前に、Large インスタンス・サイズまでスケールアップすることをお勧めします。インスタンス・サイズに変更します。 マイグレーション後は、必要なリソースが少なくなり、スケールダウンすることができます。 「大」 インスタンス・サイズでも問題が発生する場合は、構成のカスタマイズが必要になることがあります。 詳しくは、troubleshooting.html#reference_mwl_byg_wpb__largeisxを参照してください。
ISX ファイルをインポートするには、以下の手順を実行します。
  1. 既存のプロジェクトを開くか、新規プロジェクトを作成します。
  2. プロジェクトの 「資産」 タブで、 「新規資産」 > グラフィカル・ビルダー > DataStageをクリックします。
  3. 「ローカル・ファイル」 タブをクリックし、ローカル・コンピューターから ISX ファイルをアップロードします。 次に「作成」をクリックします。
    注: ISX ファイルは、デスクトップまたはネットワーク・ドライブ上に存在している必要があります。 ファイルを別のアプリケーションから添付ファイルとしてドラッグしないでください。

資産インポート・レポートには、ISX インポートのトラブルシューティングに使用できる状況情報とエラー・メッセージが含まれています。 レポートの表示とトラブルシューティングへの使用については、資産インポートレポート (DataStage) を参照してください。

接続のマイグレーション

マイグレーションされたジョブに接続が含まれている場合は、 DataStage を参照してください。

ステージのマイグレーション

表 1. ステージとそのマイグレーションに関する考慮事項。
ステージ 考慮事項
ストアード・プロシージャー ストアード・プロシージャーは、対応するプラットフォーム・コネクターにマイグレーションされます。

Db2® タイプのコネクター上のすべてのストアード・プロシージャーは、標準 Db2 コネクターにマイグレーションされます。これには、 Db2 for iDb2 for z/OS®などのコネクター用のストアード・プロシージャーも含まれます。 Db2 コネクターを正しいコネクター・タイプに手動で置き換え、ストアード・プロシージャー呼び出しにコピーします。

ストアード・プロシージャーで入力パラメーターと出力パラメーターを検出できない場合は、そのまま残され、マイグレーション後に新しい構文と一致するように更新する必要があります。 詳細は、ストアド・プロシージャをDataStageを参照してください。

パラメーター・セットおよび PROJDEF 値の確認

パラメーター・セットを調べて、マイグレーション後のデフォルト値が正しいことを確認してください。

PROJDEF パラメーター・セットは、マイグレーションによって作成および更新されます。 PROJDEF パラメーターを設定してジョブをマイグレーションする場合は、 PROJDEF パラメーター・セットを検討し、そのデフォルト値を指定します。 その後、フローおよびジョブ実行内で、 $PROJDEF であるパラメーター値は、 PROJDEF パラメーター・セットの値を使用します。

PROJDEF パラメータの値が DSParams ファイルで定義されている場合は、cpdctl dsjob create-dsparams コマンドを使ってその値をプロジェクトの実行環境に転送します。 詳細はDSParamsを参照。

dsjob コマンド・ライン・インターフェースを使用するスクリプトの更新

dsjob を使用してジョブを実行するスクリプトがある場合は、以下のステップを実行して、dsjob に対するスクリプト呼び出しを更新します。
  1. cpdctl のダウンロード: https://github.com/IBM/cpdctl/releases/
  2. ソース・シェル・スクリプト (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