InfoSphere DataStageおよびQualityStage資産のインポートコマンド

istool コマンド・ライン・インターフェース (CLI) を使用して、 以前にエクスポートしたアーカイブ・ファイルから資産をインポートできます。

目的

アーカイブ・ファイルからIBM® InfoSphere DataStageおよびQualityStage®アセットをIBM InfoSphere Information Server のメタデータ・リポジトリーにインポートするには、istool 'importコマンドでInfoSphere® DataStage®コマンド・オプションを使用します。 このコマンドは「export コマンドの逆である。

前提条件

InfoSphere DataStageおよびQualityStageのアセットをインポートするには、対象プロジェクトのアセットを編集する権限を付与されたロールが必要です。 関連する共通メタデータ資産をインポートに含めるには、 共通メタデータ・アドミニストレーター・ロールを持っている必要があります。

このコマンドの実行は、istool コマンド・ライン・ウィンドウで行う方法が推奨されます。 オペレーティング・システムのコマンド・ライン・ウィンドウまたはスクリプトでこのコマンドを実行する場合は、 コマンド名の前に istool を追加してください。

コマンド構文

構文内のオプション・パラメーターおよび値は、大括弧 [ ] で囲まれています。
import
authentication options
[generic options]
-archive file_name_and_path 
[-preview | -replace]
[-responseFile "file_name_and_path"]
[-abortAfter number_of_errors]
-datastage '
   [-nodesign]
   "Server/project" 
   '								

コマンド・オプション

authentication parameters
すべての資産交換コマンドは、InfoSphere Information Server Serverの特定のインストールに接続するための認証オプションを使用します。
generic parameters
汎用パラメーターは、すべての資産交換コマンドで使用可能です。 コマンド構文でヘルプを要求するか、サイレントまたは詳細オペレーションを指定するには、汎用オプションを使用します。
-アーカイブ|-ar"資産パス名"
必須。 資産のインポート元の .isx ファイルを指定します。
-プレビュー
リポジトリーを変更せずに、コマンドのアクションをプレビューする場合に、このオプションを指定します。
-置き換える
既存の資産をインポートされた資産と置き換えたり、マージしたりします。 -replace パラメーターを指定した場合に、ID が同じである資産がターゲット・メタデータ・リポジトリーに存在すると、既存の資産は、資産のタイプに応じて、インポートされた資産と置き換えられたり、マージされたりします。
--responseFile| -rf"ファイル名とパス"
前回の istool import -ds コマンドの実行時にインポートできなかった資産を含む応答ファイルの名前とパスを指定します。 -preview パラメーターではサポートされません。 詳細については、istool exportとistool importコマンドで応答ファイルを使うを参照のこと。
--abortAfter|-abortエラー数
指定した数のエラーが発生した後、インポートを停止します。
-データステージ|-ds 'サーバー/プロジェクト"'
InfoSphere DataStageおよびQualityStageアセットをターゲットサーバーおよびプロジェクトにインポートすることを指定します。 -datastage パラメーターの後、単一引用符 (' ') 内で次のオプションを使用できます。
-ノードサイン
ジョブ・デザインではなく、ジョブ実行可能ファイルのみインポートすることを指定します。

複数タイプの資産のインポート

アーカイブ・ファイルに複数のタイプの資産が含まれている場合、 アーカイブ・ファイルをインポートするときに、組み込まれたメタデータの各タイプを コマンド・ラインに指定する必要があります。 それ以外の場合は、InfoSphere DataStageおよびQualityStageアセットのみがインポートされます。 例えば 、-includedependent オプションを付けてアーカイブがエクスポートされた場合、 それには、共通メタデータ資産が含まれている可能性があります。

次のコマンドは、 正しい順序で、アーカイブ・ファイル arc.isx から資産をインポートします。 共通メタデータ資産が 最初にインポートされます。 InfoSphere DataStageと QualityStageのアセットが、サーバ・スライス上のプロジェクトaProjにインポートされます。
import –domain sliver.svl.ibm.com:9443
-username user1 -password pass1
-archive "c:\arc.isx" 	-cm '' 

import –domain sliver.svl.ibm.com:9443
-username user1 -password pass1 
-archive "c:\arc.isx" 	-datastage ' "slice/aProj" '  
アーカイブ・ファイルには、複数のツールを使用した複数のエクスポートからの資産を含めることができます。 最良のパフォーマンスのために、アーカイブ・ファイルからインポートするとき、または複数のアーカイブ・ファイル内の各種資産をマイグレーションするとき、個別のコマンドを実行して、次のタイプの資産を次の順番でインポートします。
  1. ユーザーおよびグループ
  2. 共通メタデータ
  3. InfoSphere DataStageおよびQualityStageの資産。
  4. レポート。
  5. InfoSphere Information Analyzerの資産。
  6. InfoSphere FastTrackアセット。
  7. InfoSphere Information Governance Catalog拡張データソース。
  8. InfoSphere Information Governance Catalog拡張マッピング・ドキュメント。
  9. InfoSphere Information Governance Catalogビジネス用語集アセット。 11.3 より前のバージョンでは、これらの資産は InfoSphere Business Glossary で作成されます。
  10. InfoSphere Information Governance Catalog拡張データソースおよび拡張マッピングのカスタム属性。 11.3 より前のバージョンでは、これらの資産は InfoSphere Metadata Workbench で作成されます。
リストされていない資産タイプは任意の順序でインポートできます。

複数のプロジェクトへの標準化ルール・セットのインポート

アーカイブファイルにInfoSphere QualityStage の標準化ルールセットのみが含まれている場合、そのルールセットを同時に複数のプロジェクトにインポートできます。

ルール・セットのインポート先プロジェクトの指定に、 ワイルドカード文字としてアスタリスク (*) を使用できます。 例えば、 次のコマンドはルール・セットをサーバー上のすべてのプロジェクトにインポートします。

import –domain test.sample.com:9443
-username isadmin -password isadmin
-archive "c:\arc.isx" 	-datastage ' " test.sample.com/*" '

次のコマンドは、 サーバー上の文字 X で始まるプロジェクトにルール・セットをインポートします。

import –domain test.sample.com:9443
-username isadmin -password isadmin
-archive "c:\arc.isx" 	-datastage ' " test.sample.com/X*" '

終了状況

戻り値 0 は正常終了を示します。他の値はすべて、失敗を示します。 終了コードのリストは、コマンド・ヘルプに表示されています。 istool import -help入力すると、「importコマンドで可能な終了コードのリストが表示される。

エラー処理

複数のオブジェクトが入ったアーカイブ・ファイルからインポートしている場合 、1 つの失敗によって操作が中断されることはありません。 1 つ以上のオブジェクトをインポートできなければ、 終了状況は、エラーを報告します。

次のコマンドは、ファイル arc.isx からの 資産のインポートをプレビューします。 資産はインポートされません。 ジョブ・デザインは含まれません。
import –domain sliver:9443
-username user1 -password pass1
-archive "c:\arc.isx" -pre  -datastage ' -nodesign "slice/aProj" '
プレビューのあと 、-preview オプションを付けないでこのコマンドを繰り返し、slice という名前のコンピューター上の aProj という プロジェクトに資産をインポートします。 slice 上のInfoSphere Information Serverエンジンは、サービス層の sliver という名前のコンピュータに関連付けられています。
import –domain sliver.svl.ibm.com:9443
-username user1 -password pass1
-archive "c:\arc.isx" 	-datastage ' -nodesign "slice/aProj" '