InfoSphere DataStageおよびQualityStageアセット用のエクスポートコマンド

目的

IBM® InfoSphere® DataStage®およびQualityStage®アセットをローカル・ファイル・システムのアーカイブ・ファイルにエクスポートするには、istool 'exportコマンドでDataStageコマンド・オプションを使用します。 その後、istool 'importコマンドをDataStageコマンド・オプションとともに使用すると、エクスポートしたアセットを別のIBM InfoSphere Information Serverメタデータ・リポジトリにリストアできます。

すべてのタイプのすべてのアセットをエクスポートするには、メタデータ リポジトリから別のリポジトリにすべてのアセットを移動するを参照してください。

前提条件

エクスポートするアセットの編集権限が付与されたInfoSphere DataStageおよびQualityStageロールが必要です。

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

コマンド構文

構文内のオプション・パラメーターおよび値は、大括弧 [ ] で囲まれています。

export
authentication parameters
[generic parameters]
-archive "file_name_and_path" 
[-maxArchiveSize number_of_megabytes]
[-updatearchive] 
[-preview ] | [-responseFile "file_name_and_path"]
[-abortIfError number_of_errors]
-datastage '	 "dsServer[:port]/project/folder/asset_name.suffix"
   [ -base "server[:port]/project"]
   [-includedependent]
   [-nodesign] 
   [-includeexecutable]
   '
								

パラメーター

authentication parameters

必須。 すべての資産交換コマンドは、InfoSphere Information Server Serverの特定のインストールに接続するための認証パラメータを使用します。

generic parameters

汎用パラメーターは、すべての資産交換コマンドで使用可能です。 コマンドの構文に関するヘルプを要求したり、サイレントまたは冗長な操作を指定したり、コマンドの実行にスクリプトを使用したりするには、汎用パラメータを使用する。

-アーカイブ｜-ar"ファイル名とパス"

必須。 資産をエクスポートする先の .isx ファイルを指定します。

--maxArchiveSize| -masnumber_of_megabytes

エクスポートおよびインポートのパフォーマンスを向上させるために、エクスポート・ファイルのサイズが指定のメガバイト数を超えた場合に追加のアーカイブ・ファイルを作成します。 例えば、500 を指定し、エクスポートの合計サイズが 1,300 MB の場合、追加のアーカイブ・ファイルが 2 つ作成されます。これらのアーカイブ・ファイルの名前の末尾には番号が付加されます。 これらのアーカイブ・ファイルをインポートする場合、最初のアーカイブ・ファイルを指定すると、すべてのファイルがインポートされます。 詳しくは共通パラメータを参照。

-updatearchive | -up

アーカイブ・ファイルが存在する場合、それを更新します。 -updatearchive を指定しない場合、既存のアーカイブ・ファイルの内容が上書きされます。

-preview | -pre

資産をエクスポートせずに、エクスポート処理をプレビューする場合に、このオプションを指定します。

--responseFile| -rf"ファイル名とパス"

前回の istool export -ds コマンドの実行時にエクスポートできなかった資産を含む応答ファイルの名前とパスを指定します。 -preview パラメーターではサポートされません。 詳細については、istool exportとistool importコマンドで応答ファイルを使うを参照のこと。

--abortIfError| -abortnumber_of_errors

指定した数のエラーが発生すると、エクスポートを停止します。

-データステージ｜-ds' "dsServer/プロジェクト/フォルダ/アセット名.サフィックス"'

必須。 InfoSphere DataStageおよびQualityStageアセットのエクスポートを指定します。 エクスポート・ファイルに追加される資産のパスを指定します。 詳細は、「 InfoSphere DataStageおよびQualityStageアセットのアセット・パス」を参照してください。 資産名は、InfoSphere Information Serverマネージャからコピー＆ペーストできます。

以下のオプションを使用できます。

-ベース"dsServer[:port]/project/[folder]"

基本パスを指定するには、-base オプションを使用します。 このパスは、指定するすべての資産パス名の前に付加されます。 例えば、base オプションで dsServer/project を指定した場合、資産パスでは folder/asset_name.suffix のみ指定します。 -datastage パラメーターの後、単一引用符 (' ') 内にオプションを指定します。

-付属｜-incdep

関連する InfoSphere DataStage and QualityStage 資産や表定義に関連するデータ・コレクション (データベース表またはデータ・ファイル・レコード) などの従属資産を含めます。 データ・コレクション (共有表とも呼ばれる) は、データ・リネージュで使用できる共通メタデータ資産です。 例えば、salesdata という名前の表定義を使用する myjob という名前のジョブをエクスポートする場合 、-includedependent を指定すれば、ジョブがエクスポートされるときに表定義および関連するデータベース表が自動的に含められます。 一般的なメタデータオプションの詳細については、一般的なメタデータ資産のエクスポートコマンドを参照してください。

-ノードサイン

エクスポートからデザイン・オブジェクトを除外します。 -includeexecutable オプションと一緒に使用すると、 実行時実行可能ファイルのみをエクスポートします。

-include実行可能｜-incexec

実行時実行可能ファイルを含めます。 資産によっては実行可能コンポーネントが ないものもあります。 このオプションを使用していて、エクスポートする資産に実行可能コンポーネントがない場合、 警告が生成されますが、結果としてエクスポートは失敗にはなりません。

終了状況

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

エラー処理