CDC Replication Engine for InfoSphere® DataStage® には、ご使用の環境に合わせて拡張または変更できるサンプル・カスタム・データ・フォーマットが用意されています。
このタスクについて
サンプルは samples.jarにあります。これは、 CDC Replication Engine for InfoSphere DataStage インストール・ディレクトリーの samples ディレクトリーにあります。 このファイルには、以下のサンプルが入っています。
- SampleDataStageDataFormat.java —IBM® IBM®DataStageファイル リーダーおよび列インポーター ステージに適したデータをフォーマットします。 このサンプルは com.datamirror.ts.userexit.sample にあります。
次のことに注意してください。
- サンプル・カスタム・データ形式を変更せずに実行するには、 管理コンソールで、コンパイル済みカスタム・データ形式の完全修飾パスを指定する必要があります。 例えば、com.datamirror.ts.target.publication.userexit.sample.UserExitSampleなどです。
- コンパイル済みサンプル・カスタム・データ形式は、 ts.jar ファイルにあります。このファイルは、 CDC Replication Engine for InfoSphere DataStage インストール・ディレクトリーの lib ディレクトリーにあります。 ts.jar ファイルにあるコンパイル済みカスタム・データ形式には、*.class 拡張子が付いています。
- サンプル・カスタム・データ形式を変更する場合は、ソース・コードに変更を加えた後でカスタム・データ形式をコンパイルしなければなりません。
- カスタム・データ形式は、クラスパスにも必要です。
- Java クラスが変更または変更された場合、変更されたユーザー出口を取得するには、 CDC Replication Engine for InfoSphere DataStage インスタンスを再始動する必要があります。
- CDC Replicationを停止します。
- samples.jar ファイルを IBM Data Replication インストール・ディレクトリー内の lib ディレクトリーに unzip します。 jar ファイルの unzip 時は、ディレクトリー構造を必ず維持してください。
jar ファイルの unzip 後、以下のようなディレクトリー構造になります。
<installation_directory>/lib/com/datamirror/ts/target/publication/userexit/sample
- サンプル・カスタム・データ形式に変更を加えます。
- 変更したカスタム・データ形式をコンパイルします。 例えば、 UserExitSample.javaをコンパイルする場合は、コマンド・ウィンドウを開き、 lib フォルダーにナビゲートして、以下のコマンドを発行します。
javac -classpath ts.jar:. com/datamirror/ts/target/publication/userexit/sample
/UserExitSample.java
このコマンドが正常に実行されると、画面には何も出力されません。
前提条件: このコマンドを実行するには、システムに Java™ JDK が必要です。
注: ユーザー出口は Java 8 でコンパイルすることをお勧めします。 Java 7 でのユーザー出口のコンパイルのサポートは非推奨になっており、将来削除される可能性があります。 Java 6 以下でのユーザー出口のコンパイルはサポートされません。
- コマンドを正常に実行した後、以下のディレクトリーにナビゲートし、 UserExitSample.class ファイルを作成したことを確認します。
<installation_directory>/lib/com/datamirror/ts/target/publication/userexit/sample
- CDC Replicationを開始します。
- カスタム・データ・フォーマットを構成するための最後のステップは、 管理コンソールで UserExitSample への完全修飾パスを指定することです。 次に例を示します。
com.datamirror.ts.target.publication.userexit.sample.UserExitSample
注: .class 拡張子は指定しないでください。
- さまざまなエンジン用の UNIX または Linux オペレーティング・システムのユーザー出口資料のコンパイル・コマンドは、以下のコマンドを使用します。
javac -classpath ts.jar:.
com/datamirror/ts/target/publication/userexit/sample/UserExitSample.java
これを内部的に検証するには、前述のコマンドに含まれる追加の jar を使用するか、「*」を使用して現行 lib ディレクトリー内のすべてのファイルを使用するか、以下のいずれかを使用します。
javac -classpath ts.jar:user-exit-xxxx.jar
com/datamirror/ts/target/publication/userexit/sample/UserExitSample.java
それとも
javac -cp "*"
com/datamirror/ts/target/publication/userexit/sample/SampleDataStageDataFormat.java
次の作業
CDC Replicationには、サンプル Java クラス・ユーザー出口も用意されています。 これらのサンプルは、ご使用の環境に合わせて拡張または変更することができます。
注: Java クラスが変更または変更された場合、変更されたユーザー出口を取得するには、 CDC Replication インスタンスを再始動する必要があります。
注: 実稼働環境でサンプル・カスタム・データ形式を使用する予定の場合は、デプロイする前にサンプルをテストする必要があります。 IBM は、変更またはカスタマイズされたカスタム・データ・フォーマットによって生じる悪影響に対して責任を負いません。