| Oracle® Fusion Middleware Oracle Data Integrator開発者ガイド 11g リリース1 (11.1.1) B62260-04 |
|
 前 |
 次 |
この付録では、Oracle Data Integrator Toolsのリファレンス情報を提供します。この付録は、これらのツールを使用して統合シナリオを設計するアプリケーション開発者を対象としています。
この付録は次の項で構成されています:
Oracle Data Integrator Tools (Oracle Data Integratorコマンドとも呼ばれます)は、実行時に特定のタスクを処理するために用意されているコマンドです。これらのタスクは、一定の時間待機したり音を鳴らすなどの簡単なタスクの場合や、ANTスクリプトを実行したりサーバーから電子メールを読み込むなどの高度なタスクの場合があります。
これらは、パッケージ、プロシージャ・コマンドまたはナレッジ・モジュール・コマンドで使用され、コマンドラインから直接使用することもできます。
|
注意: Oracle Data Integratorの以前のバージョンでは、内部Javaクラス(SnpsSendMailやSendMailなど)を使用したJythonまたはJavaスクリプトからの組込みツールのコールがサポートされていました。このメソッドを使用したツールの使用方法は、バージョン10.1.3.2.0以降非推奨になっているため、使用しないでください。 |
|
注意: コマンド内で改行は使用できません。 |
Oracle Data Integratorのツールをパッケージに追加して使用する方法は、10.3.1.4項「Oracle Data Integratorツール・ステップの追加」を参照してください。
パッケージ内では、ツール・ステップに順序を付け、その成否に従ってステップを編成できます。詳細は、10.4項「ステップの順序の定義」および10.3.6項「ステップのレイアウトの調整」を参照してください。
パッケージでは、ツール・パラメータ変数値、順序またはOracle Data Integrator置換メソッド・コールでツールを直接使用できます。詳細は、第12章「プロシージャ、変数、順序およびユーザー関数の使用」を参照してください。
KMまたはプロシージャでOracle Data Integratorツールを使用する方法は、12.1項「プロシージャの使用」を参照してください。
ナレッジ・モジュールまたはプロシージャでは、ツール・パラメータ変数値、順序、Oracle Data Integrator置換メソッド・コール、またはSELECT文の結果でツールを直接使用できます。詳細は、第12章「プロシージャ、変数、順序およびユーザー関数の使用」を参照してください。
|
注意: この項で説明されているタスクの実行に必要なコマンドライン・スクリプトは、Oracle Data Integrator Standalone Agentがインストールされている場合のみ使用できます。スタンドアロン・エージェントのインストール方法は、Oracle Fusion Middleware Oracle Data Integratorインストレーション・ガイドを参照してください。 |
コマンドラインからOracle Data Integratorツールを使用するには:
シェル(UNIX)またはコマンドライン・プロンプト(Windows)を起動します。
Oracle Data Integratorをインストールしたディレクトリのoracledi/agent/binサブディレクトリに移動します。
次の構文を使用して、startcmd.bat (Windows)またはstartcmd.sh (UNIX)コマンドを起動します:
startcmd <command_name> [<command_parameters>]*
重要な注意事項
コマンドラインからツールを起動する場合は、次の点に注意してください。
Windowsプラットフォームでは、等号(=)またはスペースが含まれているコマンド引数は、二重引用符で囲む必要があります。Windowsのコマンド・コールはUNIXのコマンド・コールとは異なることがあります。例:
<command_name>パラメータは大文字と小文字が区別されます。
startcmd.bat OdiSleep "-DELAY=5000" (Windows) ./startcmd.sh OdiSleep -DELAY=5000 (UNIX)
ツールによっては、実行の際にリポジトリへの接続を必要とするものがあります。odiparamsファイルにリポジトリ接続が構成されていることを確認してください。詳細は、4.3項「エージェントの管理」を参照してください。
次のODIツールは、コマンドラインからの直接起動をサポートしていません。
OdiInvokeWebService
OdiRetrieveJournalData
OdiRefreshJournalCount
オープン・ツール機能には、パッケージやプロシージャで使用できるカスタムのサード・パーティ・ツールを開発するための拡張可能なプラットフォームがあります。Oracle Data Integratorに付属の標準ツールと同じように、オペレーティング・システムと相互に作用し、データを操作できます。
オープン・ツールはJavaで記述されています。独自のオープン・ツールの記述方法については、A.3項「オープン・ツールの開発」を参照してください。
オープン・ツールは、次のいくつかのファイルが格納されたJavaパッケージ(.zipまたは.jar)として配布されます:
Javaのコンパイル済.classファイル
アイコン・ファイルなどのその他のリソース
オープン・ツールを使用するには、その前に、オープン・ツールをインストールして追加する必要があります。
オープン・ツールをインストールするには、クラスパスまたはこのオープン・ツールを使用しているコンポーネントに、オープン・ツールJarを追加する必要があります。
オープン・ツールJarは、スタンドアロン・エージェントおよびStudioのドライバと同じディレクトリに追加する必要があります。詳細は、『Oracle Fusion Middleware Oracle Data Integratorインストレーション・ガイド』の「追加のドライバとオープン・ツールの追加」を参照してください。
オープン・ツールJarとJava EEエージェントをデプロイするためには、このエージェントのサーバー・テンプレートを生成する必要があります。オープン・ツールは、WLSテンプレート生成ウィザードの「ライブラリおよびドライバ」リストに表示されます。詳細は、4.3.2.1.2項「EEエージェントのためのサーバー・テンプレートの作成」を参照してください。
|
注意: この操作は、ツールを使用する各ODI Studio、およびこのツールを使用してセッションを実行する各エージェントに対して実行する必要があります。 |
この操作は、マスター・リポジトリでオープン・ツールを宣言し、このオープン・ツールをOracle Data Integrator Studioに表示できるようにします。
新しいツールを宣言するには、次のいずれかを実行します:
Oracle Data Integrator Studioで、「ODI」メニューから「オープン・ツールの追加/削除」を選択します。「オープン・ツールの追加」ダイアログが開きます。
「オープン・ツールの追加/削除」ダイアログの「オープン・ツール・クラス名」フィールドにクラス名を入力します。
または:
「ClassPathで検索します」をクリックし、オープン・ツールのJavaクラス名を参照します。クラスを名前で検索するには、上部のフィールドに名前の一部を入力します。
「OK」をクリックします。
Oracle Data Integratorで現在使用可能なすべてのクラスの中には、オープン・ツールでないツールのクラスも表示されることに注意してください。クラスを追加するには、そのクラスの名前を把握している必要があります。
「オープン・ツールの追加」をクリックします。
目的のオープン・ツールが含まれている行を選択します。
クラスパス上で見つかると、提供されているアイコン、構文、説明、プロバイダおよびバージョン番号が表示されます。
見つからない場合は、エラー・メッセージが表示されます。
クラスパスを変更するか、オープン・ツールを適切なディレクトリに移動してください。
|
注意: この操作は、指定のマスター・リポジトリに対して1回のみ実行する必要があります。 |
|
注意: 名前が |
オープン・ツールはJavaパッケージで、インタフェースoracle.odi.sdk.opentools.IOpenToolを実装するコンパイル済Javaクラスが含まれています。すべてのクラスおよびメソッドの詳細は、Oracle Data Integrator Open Tools APIリファレンス(Javadoc)を参照してください。
オープン・ツール・パッケージには通常2つのアイコンも含まれており、Oracle Data Integratorグラフィカル・インタフェースでオープン・ツールを表すために使用されます。
次の表は、オープン・ツールのクラスおよびインタフェースを示しています。
| クラスまたはインタフェース | 説明 |
|---|---|
|
IOpenTool |
すべてのオープン・ツールが実装する必要のあるインタフェース。 |
|
OpenToolAbstract |
いくつかのヘルパー・メソッドを備えたインタフェースの抽象化。可能なかぎり、インタフェースを直接実装するのではなく、このクラスを拡張してください。 |
|
IOpenToolParameter |
オープン・ツールで使用されるパラメータが実装する必要のあるインタフェース。ほとんどの場合は、このインタフェースを実装せずに、OpenToolParameterを使用します。 |
|
OpenToolParameter |
IOpenToolParameterの完全な実装。各OpenToolParameterが1つのパラメータを保持します。 |
|
OpenToolsExecutionException |
オープン・ツールのメソッドによって必要に応じてスローされる例外クラス。 |
|
SimpleOpenToolExample |
オープン・ツールの簡単な例であり、開始点として使用できます。 |
ここでは、基本的なオープン・ツールであるSimpleMessageBoxの開発について説明します。このクラスのソース・コードは、demo/plugins/srcディレクトリにあります。
構文を定義します。この例では、オープン・ツールは次のようにコールされます:
SimpleMessageBox "-TEXT=<text message>" "-TITLE=<window title>"
16x16および32x32のアイコンを作成します(通常は.gif形式)。
クラスを作成し、実装します。A.3.2.1項「クラスの実装」を参照してください。
クラスをコンパイルし、2つのアイコン・ファイルが含まれたパッケージを作成します。
A.2.1項「オープン・ツールのインストールおよび宣言」の説明に従って、オープン・ツールのインストールと宣言を実行します。
クラスの実装は、次の手順で構成されます。
クラスを宣言するには、その前に、パッケージ名を指定する必要があります。
パッケージ名の指定
適切な名前のパッケージにクラスを配置します。パッケージ名は、インストール時にオープン・ツールを識別するために使用されます。
package com.myCompany.OpenTools;
クラスの宣言
オープン・ツールの開発には、2つの基本的な手法があります:
既存のクラスを拡張してオープン・ツールに変換します。この場合は、インタフェースIOpenToolを既存のクラスに直接実装します。
新規のクラスを開発します。この場合は、抽象クラスOpenToolAbstractを拡張する方法が最も容易です。このクラスには、パラメータで使用するための追加のヘルパー・メソッドも含まれています。
public class SimpleMessageBox extends OpenToolAbstract {
ほぼすべてのオープン・ツールには、次のオープン・ツールSDKパッケージをインポートする必要があります。
import oracle.odi.sdk.opentools.IOpenTool; /* All Open Tool classes need these three classes */ import oracle.odi.sdk.opentools.IOpenToolParameter; import oracle.odi.sdk.opentools.OpenToolExecutionException; import oracle.odi.sdk.opentools.OpenToolAbstract; /* The abstract class we extend for the Open Tool */ import oracle.odi.sdk.opentools.OpenToolParameter; /* The class we use for parameters */
この例では、メッセージ・ボックスを作成するために次のパッケージも必要です:
import javax.swing.JOptionPane; /* Needed for the message box used in this example */
OpenToolParameterオブジェクトを格納するプロパティを追加します。このプロパティは、構文に対してオブジェクトを定義する目的と、実際のユーザーからパラメータの値を取得する目的の両方に使用されます。このオープン・ツールのパラメータは、次のように静的配列を使用して定義するのが最も簡単です。この配列は、アクセッサ関数を介してアクセスされるため、プライベートにする必要があります。
private static final IOpenToolParameter[] mParameters = new IOpenToolParameter[]
{
new OpenToolParameter("-TEXT", "Message text", "Text to show in the messagebox (Mandatory).", true),
new OpenToolParameter("-TITLE", "Messagebox title", "Title of the messagebox.", false)
};
OpenToolParameter()コンストラクタに渡される4つのパラメータは、次のとおりです。
パラメータのコード(先頭のハイフンを含みます)。このコードは、getSyntax()によって戻される構文に対応している必要があります。
ユーザーが理解しやすい名前。この名前は、ユーザーがグラフィカル・インタフェースを使用してパラメータを設定する際に使用されます。
説明のヘルプ・テキスト。
パラメータが必須かどうか。これはユーザーに表示する目印です。
|
注意: Oracle Data Integratorでは、パラメータに必須フラグを付けなくてもかまいません。ただし、入力されるパラメータの組合せはすべて処理可能である必要があります。 |
パラメータを取得するには、アクセッサ関数getParameters()を実装する必要があります。
public IOpenToolParameter[] getParameters()
{
return mParameters;
}
オープン・ツールに関する情報を戻す関数であるgetDescription()、getVersion()、getProvider()を実装します。
public String getDescription() { return "This Open Tool displays a message box when executed."; }
public String getVersion() { return "v1.0"; }
public String getProvider() { return "My Company, Inc."; }
getSyntax()関数によって、Oracle Data Integratorのグラフィカル・インタフェースに表示されるオープン・ツールの名前と、パラメータの初期値が決定されます。パラメータ名が、getParameters()によって戻されたパラメータ名と一致していることを確認します。
public String getSyntax()
{
return "SimpleMessageBox \"-TEXT=<text message>\" \"-TITLE=<window title>\"";
}
getIcon()メソッドが、適切なサイズの2つのイメージにパスを戻します。次の例のようになります。
public String getIcon(int pIconType)
{
switch (pIconType)
{
case IOpenTool.SMALL_ICON:
return "/com/myCompany/OpenTools/images/SimpleMessageBox_16.gif";
case IOpenTool.BIG_ICON:
return "/com/myCompany/OpenTools/images/SimpleMessageBox_32.gif";
default:
return "";
}
}
最後は、オープン・ツールが提供する機能を実際に実行するexecute()メソッドです。この場合は、メッセージ・ボックスが表示されます。OpenToolAbstractクラスを拡張する場合は、getParameterValue()メソッドを使用すると、実行時に設定されるパラメータ値を容易に取得できます。
|
注意: すべての実行を捕捉して、 |
public void execute() throws OpenToolExecutionException
{
try
{
if (getParameterValue("-TITLE") == null || getParameterValue("-TITLE").equals("")) /* title was not filled in by user */
{
JOptionPane.showMessageDialog(null, (String) getParameterValue("-TEXT"), (String) "Message", JOptionPane.INFORMATION_MESSAGE);
} else
{
JOptionPane.showMessageDialog(null, (String) getParameterValue("-TEXT"),
(String) getParameterValue("-TITLE"),
JOptionPane.INFORMATION_MESSAGE);
}
}
/* Traps any exception and throw them as OpenToolExecutionException */
catch (IllegalArgumentException e)
{
throw new OpenToolExecutionException(e);
}
}
一般に、オープン・ツール・クラスは、非常に簡潔にインスタンス化されます。次のように使用されます。
インストール
ユーザーがオープン・ツールのインストールを選択すると、Oracle Data Integratorはクラスをインスタンス化し、getDescription()、getProvider()、getIcon()およびgetVersion()の各メソッドをコールして、クラスに関する情報を取得します。
パッケージでの使用
オープン・ツールがパッケージ内で使用される場合、そのクラスは、getDescription()、getProvider()、getIcon()およびgetVersion()の各メソッドをコールするために一時的にインスタンス化されます。さらに、オープン・ツールのコード名とそのデフォルト引数を取得するために、getSyntax()がコールされます。getParameters()メソッドは、引数のリストをユーザーに対して表示するためにコールされます。
実行
オープン・ツールがパッケージまたはプロシージャ内で実行される都度、クラスは繰り返しインスタンス化されます。実行完了後までインスタンスが維持されることはありません。execute()メソッドは1回のみコールされます。
この項では、Oracle Data Integratorツールのリストをカテゴリ別に示します:
この項では、Oracle Data Integratorツールのリストをアルファベット順に示します。
このコマンドを使用してAntビルドファイルを実行します。
Antビルドファイルの詳細および例は、オンライン・ドキュメント(http://jakarta.apache.org/ant/manual/index.html)を参照してください。
使用方法
OdiAnt -BUILDFILE=<file> -LOGFILE=<file> [-TARGET=<target>] [-D<property name>=<property value>]* [-PROJECTHELP] [-HELP] [-VERSION] [-QUIET] [-VERBOSE] [-DEBUG] [-EMACS] [-LOGGER=<classname>] [-LISTENER=<classname>] [-FIND=<file>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
Antビルドファイル。Antコマンドが含まれているXMLファイルです。 |
|
|
はい |
指定のファイルをロギングに使用します。 |
|
|
いいえ |
ビルド・プロセスのターゲット。 |
|
|
いいえ |
プロパティとその値のリスト。 |
|
|
いいえ |
プロジェクトに関するヘルプを表示します。 |
|
|
いいえ |
Antのヘルプを表示します。 |
|
|
いいえ |
Antのバージョンを表示します。 |
|
|
いいえ |
非冗長モードで実行します。 |
|
|
いいえ |
冗長モードで実行します。 |
|
|
いいえ |
デバッグ情報を印刷します。 |
|
|
いいえ |
ロギング情報を装飾なしで表示します。 |
|
|
いいえ |
ロギングを実行するJavaクラス。 |
|
|
いいえ |
クラス・インスタンスをリスナーとして追加します。 |
|
|
いいえ |
ファイル・システムのルートからAntビルドファイルを検索して使用します。 |
例
*.htmlファイルをftp.mycompany.comの/download/publicディレクトリから、FTPを介してC:\tempディレクトリにダウンロードします。
ステップ1: Antビルドファイルを生成します。
OdiOutFile -FILE=c:\temp\ant_cmd.xml
<?xml version="1.0"?>
<project name="myproject" default="ftp" basedir="/">
<target name="ftp">
<ftp action="get" remotedir="/download/public"
server="ftp.mycompany.com" userid="anonymous"
password="me@mycompany.com">
<fileset dir="c:\temp">
<include name="**/*.html"/>
</fileset>
</ftp>
</target>
</project>
ステップ2: Antビルドファイルを実行します。
OdiAnt -BUILDFILE=c:\temp\ant_cmd.xml -LOGFILE=c:\temp\ant_cmd.log
このコマンドを使用して、エージェントをホスティングしているマシン上のデフォルトのビープ音またはサウンド・ファイルを再生します。
次のファイル形式がデフォルトでサポートされています。
WAV
AIF
AU
|
注意: 他のファイル形式を再生するには、アプリケーション・クラスパスに適切なJavaSoundサービス・プロバイダ・インタフェース(JavaSound SPI)を追加する必要があります。 |
使用方法
OdiBeep [-FILE=<sound_file>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
いいえ |
再生するサウンド・ファイルのパスおよびファイル名。指定しない場合は、マシンのデフォルト・ビープ音が使用されます。 |
例
サウンド・ファイルc:\wav\alert.wavを再生します。
OdiBeep -FILE=c:\wav\alert.wav
このコマンドを使用して、データ品質プロジェクトを起動するバッチ・ファイルを実行します。
使用方法
OdiDataQuality -BATCH_FILE=<batch_file> [-OUT_FILE=<stdout_file>] [-ERR_FILE=<stderr_file>] [-SYNCHRONOUS=<yes|no>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
実行するデータ品質バッチ・ファイルの場所。ファイル名は絶対パスで指定する必要があります。このバッチ・ファイルはオペレーティング・システムに依存しており、 例: C:\oracle\oracledq\metabase_data\metabase\oracledq\project2\scripts\runproject2.cmd |
|
|
いいえ |
標準出力のリダイレクト先となるファイル。リダイレクトしない場合は空白のままとし、絶対パスを使用します。 |
|
|
いいえ |
標準エラーのリダイレクト先となるファイル。リダイレクトしない場合は空白のままとし、絶対パスを使用します。 |
|
|
いいえ |
YESに設定すると、このツールは品質プロセスの完了を待機してから終了します。この場合は、エラー・コードを戻す可能性があります。NOに設定すると、品質プロセスの完了を待機せずに、ただちに終了します。 |
例
次のコマンドは、C:\oracle\oracledq\metabase_data\metabase\oracledqディレクトリにエクスポートされたデータ品質プロジェクトを実行します。
OdiDataQuality "-BATCH_FILE=C:\oracle\oracledq\metabase_data\metabase\oracledq\project2\scripts\runproject2.cmd " "-OUT_FILE=C:\temp\output file" "-SYNCHRONOUS=YES"
このコマンドを使用して、指定のシナリオ・バージョンを削除します。
使用方法
OdiDeleteScen -SCEN_NAME=<name> -SCEN_VERSION=<version>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
削除するシナリオの名前。 |
|
|
はい |
削除するシナリオの名前。 |
例
バージョン001のDWHシナリオを削除します。
OdiDeleteScen -SCEN_NAME=DWH -SCEN_VERSION=001
このコマンドを使用して、Oracle Enterprise Data Quality (Datanomic)ジョブを呼び出します。
|
注意: EnterpriseDataQualityツールは、Oracle Enterprise Data Qualityバージョン8.1.6以降をサポートしています。 |
使用方法
OdiEnterpriseDataQuality "-JOB_NAME=<EDQ job name>" "-PROJECT_NAME=<EDQ project name>" "-HOST=<EDQ server hostname>" "-PORT=<EDQ server JMX port>" "-USER=<EDQ user>" "-PASSWORD=<EDQ user's password>" "-SYNCHRONOUS=<yes|no>" "-DOMAIN=-<EDQ_DOMAIN>"
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
Enterprise Data Qualityジョブの名前 |
|
|
はい |
Enterprise Data Qualityプロジェクトの名前 |
|
|
はい |
Enterprise Data Qualityサーバーのホスト名。例: localhost |
|
|
はい |
Enterprise Data QualityサーバーのJMXポート。例: 9005 |
|
|
はい |
Enterprise Data Qualityサーバー・ユーザーのユーザー名。例: dnadmin |
|
|
はい |
Enterprise Data Qualityユーザーのパスワード |
|
|
いいえ |
yesに設定すると、ツールは品質プロセスの完了を待機してから、可能性のあるエラー・コードで復帰します。noに設定すると、ツールは品質プロセスの完了を待機せずに、ただちに正常に終了します |
|
|
いいえ |
MBeanドメインの名前。デフォルトは |
例
次のコマンドは、CUSTOMERSという名前のプロジェクトに配置されているCLEANSE_CUSTOMERSと呼ばれるEnterprise Data Qualityジョブを実行します:
EnterpriseDataQuality "-JOB_NAME=CLEANSE_CUSTOMERS" "-PROJECT_NAME=CUSTOMERS" "-HOST=machine.oracle.com" "-PORT=9005" "-USER=odi" "-PASSWORD=odi” "DOMAIN=dndirector"
このコマンドを使用して、接続しているリポジトリからシナリオのグループをエクスポートします。
エクスポート・ファイルは、SCEN_<scenario name><scenario version>.xmlという名前です。このコマンドは、デザイナおよびオペレータで使用可能なエクスポート機能の動作を再現します。
使用方法
OdiExportAllScen -TODIR=<directory> [-FORCE_OVERWRITE=<yes|no>] [-FROM_PROJECT=<project_id>] [-FROM_FOLDER=<folder_id>] [-FROM_PACKAGE=<package_id>] [-RECURSIVE_EXPORT=<yes|no>] [-XML_VERSION=<1.0>] [-XML_CHARSET=<charset>] [-JAVA_CHARSET=<charset>] [-EXPORT_PACK=<YES|NO>] [-EXPORT_POP=<YES|NO>] [-EXPORT_TRT=<YES|NO>] [-EXPORT_VAR=<YES|NO>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
エクスポート・ファイルが作成されるディレクトリ。 |
|
|
いいえ |
|
|
- |
いいえ |
エクスポートするシナリオが含まれているプロジェクトのID。これは、プロジェクト・ウィンドウの「バージョン」タブに表示される内部識別子です。このパラメータが設定されていない場合は、すべてのプロジェクトのシナリオがエクスポートの対象になります。 |
|
|
いいえ |
エクスポートするシナリオが含まれているフォルダのID。これは、フォルダ・ウィンドウの「バージョン」タブに表示される内部識別子です。このパラメータが設定されていない場合は、すべてのフォルダのシナリオがエクスポートの対象になります。 |
|
|
いいえ |
エクスポートするシナリオが含まれているソース・パッケージのID。これは、パッケージ・ウィンドウの「バージョン」タブに表示される内部識別子です。このパラメータが設定されていない場合は、すべてのコンポーネントのシナリオがエクスポートの対象になります。 |
|
|
いいえ |
yesに設定すると、すべての子オブジェクト(スケジュール)がシナリオとともにエクスポートされます。デフォルトは |
|
|
いいえ |
XMLヘッダーに表示するXMLバージョンを設定します。デフォルトは |
|
|
いいえ |
XMLエクスポート・ファイル内に http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
|
|
いいえ |
ターゲット・ファイルのエンコーディング。デフォルト値はISO-8859-1です。サポートされているエンコーディングは、次のURLで確認できます。 http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
|
|
いいえ |
パッケージに関連付けられているシナリオをエクスポートするかどうかを示します。デフォルト値はYESです。 |
|
|
いいえ |
インタフェースに関連付けられているシナリオをエクスポートするかどうかを示します。デフォルト値はNOです。 |
|
|
いいえ |
プロシージャに関連付けられているシナリオをエクスポートするかどうかを示します。デフォルト値はNOです。 |
|
|
いいえ |
変数に関連付けられているシナリオをエクスポートするかどうかを示します。デフォルト値はNOです。 |
例
内部識別子が10022のDW01プロジェクトのすべてのシナリオとすべての依存オブジェクトを/temp/ディレクトリにエクスポートします。
OdiExportAllScen -FROM_PROJECT=10022 -TODIR=/temp/ -RECURSIVE_EXPORT=yes
このコマンドを使用して、指定したディレクトリに技術環境の詳細をカンマ区切り(.csv)ファイルでエクスポートします。この情報は、メンテナンスやサポートの際に必要です。
使用方法
OdiExportEnvironmentInformation -TODIR=<toDir> -FILE_NAME=<FileName> [-CHARSET=<charset>] [-SNP_INFO_REC_CODE=<row_code>] [-MASTER_REC_CODE=<row_code>] [-WORK_REC_CODE=<row_code>] [-AGENT_REC_CODE=<row_code>] [-TECHNO_REC_CODE=<row_code>] [-RECORD_SEPARATOR_HEXA=<rec_sep>] [-FIELD_SEPARATOR_HEXA=<field_sep] [-TEXT_SEPARATOR=<text_sep>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
エクスポートのターゲット・ディレクトリ。 |
|
|
はい |
CSVエクスポート・ファイルの名前。デフォルトは |
|
|
いいえ |
エクスポート・ファイルのキャラクタ・セット。 |
|
|
いいえ |
Oracle Data Integratorの現在のバージョンおよび現在のユーザーを記述した行を識別するためのコード。このコードは、レコードの最初のフィールドで使用されます。デフォルトは |
|
|
いいえ |
マスター・リポジトリに関する情報が含まれている行のコード。デフォルトは |
|
|
いいえ |
作業リポジトリに関する情報が含まれている行のコード。デフォルトは |
|
|
いいえ |
実行中の各種エージェントに関する情報が含まれている行のコード。デフォルトは |
|
|
いいえ |
データ・サーバーとそのバージョンなどに関する情報が含まれている行のコード。デフォルトは |
|
|
いいえ |
ファイル内の行(またはレコード)を区切る1文字以上の16進コードの文字。デフォルトは |
|
|
いいえ |
レコード内のフィールドを区切る1文字以上の16進コードの文字。デフォルトは |
|
|
いいえ |
STRINGフィールドを区切る16進コードの文字。デフォルトは |
例
技術環境の詳細を/temp/snps_tech_inf.csvエクスポート・ファイルにエクスポートします。
OdiExportEnvironmentInformation "-TODIR=/temp/" "-FILE_NAME=snps_tech_inf.csv" "-CHARSET=ISO8859_1" "-SNP_INFO_REC_CODE=SUNOPSIS" "-MASTER_REC_CODE=MASTER" "-WORK_REC_CODE=WORK" "-AGENT_REC_CODE=AGENT" "-TECHNO_REC_CODE=TECHNO" "-RECORD_SEPARATOR_HEXA=0D0A" "-FIELD_SEPARATOR_HEXA=2C" "-TEXT_SEPARATOR_HEXA=22"
このコマンドを使用して、実行ログをZIPエクスポート・ファイルにエクスポートします。
使用方法
OdiExportLog -TODIR=<toDir> [-EXPORT_TYPE=<logsToExport>] [-ZIPFILE_NAME=<zipFileName>] [-XML_CHARSET=<charset>] [-JAVA_CHARSET=<charset>] [-FROMDATE=<from_date>] [-TODATE=<to_date>] [-AGENT=<agent>] [-CONTEXT=<context>] [-STATUS=<status>] [-USER_FILTER=<user>] [-NAME=<sessionOrLoadPlanName>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
いいえ |
ログをエクスポートする対象を指定します:
|
|
|
はい |
エクスポートのターゲット・ディレクトリ。 |
|
|
いいえ |
圧縮ファイルの名前。 |
|
|
いいえ |
エクスポート・ファイルに指定されるXMLバージョン。XMLファイル・ヘッダーのxml versionパラメータで、
|
|
|
いいえ |
結果ファイルのJava文字エンコーディング。デフォルト値は
|
|
|
いいえ |
エクスポートの開始日。yyyy/MM/dd hh:mm:ssの書式を使用します。この日付以降のすべてのセッションがエクスポートされます。 |
|
|
いいえ |
エクスポートの終了日。yyyy/MM/dd hh:mm:ssの書式を使用します。この日付までのすべてのセッションがエクスポートされます。 |
|
|
いいえ |
指定した名前のエージェント( |
|
|
いいえ |
指定したコンテキスト( |
|
|
いいえ |
指定した状態のセッションのみをエクスポートします。状態の種類は、「完了」、「エラー」、「キュー」、「実行中」、「待機中」および「警告」です。 |
|
|
いいえ |
指定したユーザー( |
|
|
いいえ |
エクスポートするセッションまたはロード計画の名前。 |
例
ログをエクスポートして圧縮し、/temp/log2.zipエクスポート・ファイルを生成します。
OdiExportLog "-EXPORT_TYPE=ALL" "-TODIR=/temp/" "-ZIPFILE_NAME=log2.zip" "-XML_CHARSET=ISO-8859-1" "-JAVA_CHARSET=ISO8859_1"
このコマンドを使用して、マスター・リポジトリをディレクトリまたはzipファイルにエクスポートします。マスター・リポジトリに格納されているバージョンまたはソリューション(あるいはその両方)をエクスポートするオプションがあります。
使用方法
OdiExportMaster -TODIR=<toDir> [-ZIPFILE_NAME=<zipFileName>] [-EXPORT_SOLUTIONS=<yes|no>] [-EXPORT_VERSIONS=<yes|no>] [-XML_CHARSET=<charset>] [-JAVA_CHARSET=<charset>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
エクスポートのターゲット・ディレクトリ。 |
|
|
いいえ |
圧縮ファイルの名前。 |
|
|
いいえ |
リポジトリに格納されているすべてのソリューションをエクスポートします。 |
|
|
いいえ |
リポジトリに格納されているオブジェクトのすべてのバージョンをエクスポートします。 |
|
|
いいえ |
エクスポート・ファイルに指定されるXMLバージョン。XMLファイル・ヘッダーのxml versionパラメータで、 http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
|
|
いいえ |
結果ファイルのJava文字エンコーディング。デフォルト値は http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
例
マスター・リポジトリをエクスポートして圧縮し、export.zipファイルを生成して/temp/ディレクトリに格納します。
OdiExportMaster "-TODIR=/temp/" "-ZIPFILE_NAME=export.zip" "-XML_CHARSET=ISO-8859-1" "-JAVA_CHARSET=ISO8859_1" "-EXPORT_VERSIONS=YES"
このコマンドを使用して、現在のリポジトリからオブジェクトをエクスポートします。このコマンドは、ユーザー・インタフェースで使用可能なエクスポート機能の動作を再現します。
使用方法
OdiExportObject -CLASS_NAME=<class_name> -I_OBJECT=<object_id> [-EXPORT_DIR=<directory>][-EXPORT_NAME=<export_name>|-FILE_NAME=<file_name>] [-FORCE_OVERWRITE=<yes|no>][-RECURSIVE_EXPORT=<yes|no>] [-XML_VERSION=<1.0>] [-XML_CHARSET=<charset>] [-JAVA_CHARSET=<charset>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
エクスポートするオブジェクトのクラス。クラスのリストは次の表を参照してください。 |
|
|
はい |
オブジェクト識別子。オブジェクト編集ウィンドウの「バージョン」タブに表示される内部識別子です。 |
|
|
いいえ |
エクスポート・ファイルの名前。絶対パスまたはEXPORT_DIRからの相対パスを指定できます。 このファイル名は、Oracle Data Integrator標準エクスポート・ファイルの接頭辞および接尾辞に準拠しているかどうかに関係なく指定できます。この標準に完全に準拠する場合は、かわりにEXPORT_NAMEパラメータを使用します。EXPORT_NAMEが設定されている場合、このパラメータは使用できません。 |
|
|
いいえ |
オブジェクトがエクスポートされるディレクトリ。このディレクトリ内に作成されたエクスポート・ファイルには、FILE_NAMEおよびEXPORT_NAMEパラメータに従って名前が指定されます。 FILE_NAMEまたはEXPORT_NAMEが指定されていない場合、エクスポート・ファイルには、<object_prefix>_<object_name>.xmlという名前が自動的に指定されます。たとえば、Datawarehouseというプロジェクトは、PRJ_Datawarehouse.xmlにエクスポートされます。 |
|
|
いいえ |
エクスポート名。このパラメータを使用して、<object_prefix>_<export_name>.xmlという名前のエクスポート・ファイルを生成します。このパラメータはFILE_NAMEとは併用できません。 |
|
|
いいえ |
yesに設定すると、同じ名前の既存のエクスポート・ファイルが強制的に上書きされます。デフォルトは |
|
|
いいえ |
yesに設定すると、すべての子オブジェクトが現在のオブジェクトとともにエクスポートされます。たとえば、プロジェクトをエクスポートしている場合は、そのプロジェクト内のすべてのフォルダ、KMなどが、プロジェクト・エクスポート・ファイルにエクスポートされます。デフォルトは |
|
|
いいえ |
XMLヘッダーに表示するXMLバージョンを設定します。デフォルトは |
|
|
いいえ |
XMLファイル内に http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
|
|
いいえ |
ターゲット・ファイルのエンコーディング。デフォルト値はISO-8859-1です。サポートされているエンコーディングは、次のURLで確認できます。 http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
クラスのリスト
| オブジェクト | クラス名 |
|---|---|
|
列 |
SnpCol |
|
条件/フィルタ |
SnpCond |
|
コンテキスト |
SnpContext |
|
データ・サーバー |
SnpConnect |
|
データストア |
SnpTable |
|
フォルダ |
SnpFolder |
|
インタフェース |
SnpPop |
|
言語 |
SnpLang |
|
モデル |
SnpModel |
|
パッケージ |
SnpPackage |
|
物理スキーマ |
SnpPschema |
|
プロシージャまたはKM |
SnpTrt |
|
プロシージャまたはKMのオプション |
SnpUserExit |
|
プロジェクト |
SnpProject |
|
リファレンス |
SnpJoin |
|
シナリオ |
SnpScen |
|
順序 |
SnpSequence |
|
Step |
SnpStep |
|
Sub-Model |
SnpSubModel |
|
テクノロジ |
SnpTechno |
|
ユーザー関数 |
SnpUfunc |
|
変数 |
SnpVar |
|
オブジェクトのバージョン |
SnpData |
例
内部識別子が10022のDW01プロジェクトとその依存オブジェクトすべてを/temp/dw1.xmlエクスポート・ファイルにエクスポートします。
OdiExportObject -CLASS_NAME=SnpProject -I_OBJECT=10022 -FILE_NAME=/temp/dw1.xml -FORCE_OVERWRITE=yes -RECURSIVE_EXPORT=yes
このコマンドを使用して、現在の作業リポジトリからシナリオをエクスポートします。
使用方法
OdiExportScen -SCEN_NAME=<scenario_name> -SCEN_VERSION=<scenario_version> [-EXPORT_DIR=<directory>][-FILE_NAME=<file_name>|EXPORT_NAME=<export_name>] [-FORCE_OVERWRITE=<yes|no>][-RECURSIVE_EXPORT=<yes|no>] [-XML_VERSION=<1.0>] [-XML_CHARSET=<encoding>] [-JAVA_CHARSET=<encoding>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
エクスポートするシナリオの名前。 |
|
|
はい |
エクスポートするシナリオのバージョン。 |
|
|
はい |
エクスポート・ファイルの名前。絶対パスまたはEXPORT_DIRからの相対パスを指定できます。 このファイル名は、シナリオのOracle Data Integrator標準エクスポート・ファイルの接頭辞および接尾辞に準拠しているかどうかに関係なく指定できます。この標準に完全に準拠する場合は、かわりにEXPORT_NAMEパラメータを使用します。EXPORT_NAMEが設定されている場合、このパラメータは使用できません。 |
|
|
いいえ |
シナリオがエクスポートされるディレクトリ。このディレクトリ内に作成されたエクスポート・ファイルには、FILE_NAMEおよびEXPORT_NAMEパラメータに従って名前が指定されます。 FILE_NAMEまたはEXPORT_NAMEが指定されていない場合、エクスポート・ファイルには、SCEN_<scenario_name> <scenario_version>.xmlという名前が自動的に指定されます。 |
|
|
いいえ |
エクスポート名。このパラメータを使用して、SCEN_<export_name>.xmlという名前のエクスポート・ファイルを生成します。このパラメータはFILE_NAMEとは併用できません。 |
|
|
いいえ |
|
|
|
いいえ |
シナリオの下にあるオブジェクトが強制的にエクスポートされます。デフォルトは |
|
|
いいえ |
生成されたXMLファイル内に |
|
|
いいえ |
XMLファイル内に http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
|
|
いいえ |
ターゲット・ファイルのエンコーディング。デフォルト値はISO-8859-1です。サポートされているエンコーディングは、次のURLで確認できます。 http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
例
LOAD_DWHシナリオとその依存オブジェクトすべてをバージョン1で/temp/load_dwh.xmlエクスポート・ファイルにエクスポートします。
OdiExportScen -SCEN_NAME=LOAD_DWH -SCEN_VERSION=1 -FILE_NAME=/temp/load_dwh.xml -RECURSIVE_EXPORT=yes
このコマンドを使用して、作業リポジトリをディレクトリまたはZIPエクスポート・ファイルにエクスポートします。
使用方法
OdiExportWork -TODIR=<directory> [-ZIPFILE_NAME=<zipFileName>] [-XML_CHARSET=<charset>] [-JAVA_CHARSET=<charset>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
エクスポートのターゲット・ディレクトリ。 |
|
|
いいえ |
圧縮ファイルの名前。 |
|
|
いいえ |
エクスポート・ファイルに指定されるXMLバージョン。XMLファイル・ヘッダーのxml versionパラメータで、 http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
|
|
いいえ |
結果ファイルのJava文字エンコーディング。デフォルト値はISO8859_1です。サポートされているエンコーディングは、次のURLで確認できます。 http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
例
作業リポジトリをエクスポートして圧縮し、/temp/workexport.zipエクスポート・ファイルを生成します。
OdiExportWork "-TODIR=/temp/" "-ZIPFILE_NAME=workexport.zip"
このファイルを使用して、一連のファイルを単一ファイルに連結します。
使用方法
OdiFileAppend -FILE=<file> -TOFILE=<target_file> [-OVERWRITE=<yes|no>] [-CASESENS=<yes|no>] [-HEADER=<n>] [-KEEP_FIRST_HEADER=<yes|no]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
連結するファイルのフル・パス。汎用文字を指定するには「*」を使用します。 例:
|
|
|
はい |
ターゲット・ファイル。 |
|
|
いいえ |
ターゲット・ファイルが存在する場合に上書きするかどうかを示します。デフォルトでは、値はNoに設定されています。 |
|
|
いいえ |
ファイル検索時に、Oracle Data Integratorで大文字と小文字が区別されるかどうかを示します。デフォルトでは、ファイルは大文字で検索されます。 |
|
|
いいえ |
連結前にソース・ファイルから削除するヘッダー行の行数。デフォルトでは、行は削除されません。 HEADERパラメータを省略すると、連結ではファイル編集が不要になるため、より迅速に実行されます。 |
|
|
いいえ |
連結時に最初のファイルのヘッダー行を維持するために使用されます。 |
例
/var/tmpフォルダの*.logファイルを/home/all_files.logファイルに連結します。
OdiFileAppend -FILE=/var/tmp/*.log -TOFILE=/home/all_files.log
各店の日次売上のファイルを、最初のファイルのヘッダーを維持しながら連結します。
OdiFileAppend -FILE=/data/store/sales_*.dat -TOFILE=/data/all_stores.dat -OVERWRITE=yes -HEADER=1 -KEEP_FIRST_HEADER=yes
このコマンドを使用して、ファイルまたはフォルダをコピーします。
使用方法
OdiFileCopy -DIR=<directory> -TODIR=<target_directory> [-OVERWRITE=<yes|no>] [-RECURSE=<yes|no>] [-CASESENS=<yes|no>] OdiFileCopy -FILE=<file> -TOFILE=<target_file>|-TODIR=<target_directory> [-OVERWRITE=<yes|no>] [-RECURSE=<yes|no>] [-CASESENS=<yes|no>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
-FILE省略時は、はい |
コピーするディレクトリ(またはフォルダ)。 |
|
|
-DIR省略時は、はい |
コピーするファイルのフル・パス。汎用文字を指定するには「*」を使用します。 例:
|
|
|
-DIR指定時は、はい |
コピーのターゲット・ディレクトリ。 ディレクトリをコピーする場合(-DIR)、このパラメータは、コピーされるディレクトリの名前を示します。 1つ以上のファイルをコピーする場合(-FILE)、このパラメータは、コピー先ディレクトリを示します。 |
|
|
-TODIR省略時は、はい |
宛先ファイル。このパラメータは、-DIRパラメータとは併用できません。 このパラメータで、次のことを指定します。
TODIRとTOFILEは同時に使用できないパラメータです。両方を指定すると、TODIRのみが考慮され、TOFILEは無視されます。 |
|
|
いいえ |
フォルダのファイルがすでに存在している場合、上書きするかどうかを示します。デフォルトでは、値はNoに設定されています。 |
|
|
いいえ |
ディレクトリに別のディレクトリが含まれている場合に、ファイルを再帰的にコピーするかどうかを示します。 |
|
|
いいえ |
ファイル検索時に、Oracle Data Integratorで大文字と小文字が区別されるかどうかを示します。デフォルトでは、検索対象のファイルはすべて大文字です(Noに設定されます)。 |
例
hostsファイルを/etcディレクトリから/homeディレクトリにコピーします。
OdiFileCopy -FILE=/etc/hosts -TOFILE=/home/hosts
*.csvファイルすべてを/etcディレクトリから/homeディレクトリに上書きでコピーします。
OdiFileCopy -FILE=/etc/*.csv -TODIR=/home -OVERWRITE=yes
*.csvファイルすべてを/etcディレクトリから/homeディレクトリにコピーし、拡張子を.txtに変更します。
OdiFileCopy -FILE=/etc/*.csv -TOFILE=/home/*.txt -OVERWRITE=yes
C:\odiディレクトリとそのサブディレクトリをC:\Program Files\odiディレクトリにコピーします。
OdiFileCopy -DIR=C:\odi "-TODIR=C:\Program Files\odi" -RECURSE=yes
このコマンドを使用して、ファイルまたはディレクトリを削除します。
このツールの最も一般的なユースケースを次の表に示します:
xは指定されていることを意味します。
oは省略されていることを意味します。
| -DIR | -FILE | -RECURSE | 動作 |
|---|---|---|---|
|
x |
x |
x |
名前のあるすべてのファイル、または-FILEで指定されたマスクと一致する名前のファイルがすべて、-DIRとそのすべてのサブディレクトリから削除されます。 |
|
x |
o |
x |
-FILEのサブディレクトリが削除されます。 |
|
x |
x |
o |
名前のあるすべてのファイル、または-FILEで指定されたマスクと一致する名前のファイルがすべて-DIRから削除されます。 |
|
x |
o |
o |
-DIRが削除されます。 |
使用方法
OdiFileDelete -DIR=<directory> | -FILE=<file> [-RECURSE=<yes|no>] [-CASESENS=<yes|no>] [-NOFILE_ERROR=<yes|no>] [-FROMDATE=<from_date>] [-TODATE=<to_date>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
-FILE省略時は、はい |
|
|
|
-DIR省略時は、はい |
削除するファイルの名前またはマスク。-DIRを省略した場合は、フル・パスを指定してください。ワイルドカード文字を指定するには「*」を使用します。 例:
|
|
|
いいえ |
デフォルトはYesです。 |
|
|
いいえ |
Oracle Data Integratorがファイル名を照合する際に、大文字と小文字を区別するかどうかを指定します。 |
|
|
はい |
指定のディレクトリまたはファイルがない場合、エラーを生成するかどうかを指定します。 |
|
|
いいえ |
変更日がこの日付より後のファイルが削除されます。日付は、yyyy/MM/dd hh:mm:ssの書式で指定する必要があります。 FROM_DATEは対象に含まれません。 -FROMDATEを省略した場合は、変更日が-TODATEの日付より前のすべてのファイルが削除されます。 FROMDATEとTODATEの両方のパラメータを省略した場合は、-FILEパラメータ値と一致するすべてのファイルが削除されます。 |
|
|
いいえ |
変更日がこの日付より前のファイルが削除されます。日付は、yyyy/MM/dd hh:mm:ssの書式で指定する必要があります。 TO_DATEは対象に含まれません。 -TODATEを省略した場合は、変更日が-FROMDATEの日付より後のすべてのファイルが削除されます。 FROMDATEとTODATEの両方のパラメータを省略した場合は、-FILEパラメータ値と一致するすべてのファイルが削除されます。 |
|
注意: -DIRパラメータと-FILEパラメータを組み合せてファイルとディレクトリを同時に削除することはできません。その場合は、OdiFileDeleteを2回コールする必要があります。 |
例
c:\data\inputディレクトリからmy_data.datファイルを削除します。ファイルが欠落している場合はエラーを生成します。
OdiFileDelete -FILE=c:\data\input\my_data.dat -NOFILE_ERROR=yes
binディレクトリからすべての.txtファイルを削除します。ただし、.TXTファイルは除きます。
OdiFileDelete "-FILE=c:\Program Files\odi\bin\*.txt" -CASESENS=yes
次の文も同じ結果になります。
OdiFileDelete "-DIR=c:\Program Files\odi\bin" "-FILE=*.txt" -CASESENS=yes
/bin/usr/nothingToDoHereディレクトリを削除します。
OdiFileDelete "-DIR=/bin/usr/nothingToDoHere"
C:\tempディレクトリから、変更時刻が10/01/2008 00:00:00から10/31/2008 22:59:00までの間(10/01/2008から10/31/2008までは対象外)のファイルをすべて削除します。
OdiFileDelete -DIR=C:\temp -FILE=* -NOFILE_ERROR=NO -FROMDATE=FROMDATE=10/01/2008 00:00:00 -TODATE=10/31/2008 22:59:00
C:\tempディレクトリから、変更時刻が10/31/2008 17:00:00より前のすべてのファイルを削除します。ディレクトリ内に日付基準を満たす削除対象ファイルがない場合は、エラーがスローされます。
OdiFileDelete -DIR=C:\temp -FILE=* -NOFILE_ERROR=YES -TODATE=10/31/2008 17:00:00
C:\tempディレクトリから、変更時刻が10/01/2008 08:00:00より後のすべてのファイルを削除します。
OdiFileDelete -DIR=C:\temp -FILE=* -NOFILE_ERROR=NO -FROMDATE=10/01/2008 08:00:00
このコマンドを使用して、ファイルまたはディレクトリを別のファイルまたはディレクトリに移動(または名前を変更)します。
使用方法
OdiFileMove -FILE=<file> -TODIR=<target_directory>|-TOFILE=<target_file> [-OVERWRITE=<yes|no>] [-RECURSE=<yes|no>] [-CASESENS=<yes|no>] OdiFileMove -DIR=<directory> -TODIR=<target_directory> [-OVERWRITE=<yes|no>] [-RECURSE=<yes|no>] [-CASESENS=<yes|no>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
-FILE省略時は、はい |
移動または名前を変更するディレクトリ(またはフォルダ)。 |
|
|
-DIR省略時は、はい |
移動または名前を変更するファイルのフル・パス。汎用文字を指定するには「*」を使用します。 例: /var/tmp/*.log (/var/tmpディレクトリ内にあるlog拡張子のファイルすべて) arch_*.lst (arch_で開始するlst拡張子のファイルすべて) |
|
|
-DIR指定時は、はい |
移動のターゲット・ディレクトリ。 ディレクトリを移動する場合(-DIR)、このパラメータはディレクトリの新しい名前を示します。 1つ以上のファイルを移動する場合(-FILE)、このパラメータは移動先ディレクトリを示します。 |
|
|
-TODIR省略時は、はい |
ターゲット・ファイル。このパラメータは、-DIRパラメータとは併用できません。 このパラメータで、次のことを指定します。 - 単一のファイルを移動する場合は、ターゲット・ファイルの新しい名前(汎用文字は使用不可)。 - 複数のファイルを移動する場合は、新しいファイル名のマスク。 |
|
|
いいえ |
ファイルまたはディレクトリがすでに存在している場合、上書きするかどうかを示します。デフォルトでは、値は |
|
|
いいえ |
ディレクトリに別のディレクトリが含まれている場合に、ファイルを再帰的に移動するかどうかを示します。noの値を指定すると、移動するディレクトリ内のファイルのみが移動し、サブディレクトリは移動しません。 |
|
|
いいえ |
ファイル検索時に、Oracle Data Integratorで大文字と小文字が区別されるかどうかを示します。デフォルトでは、検索対象のファイルはすべて大文字です。 |
例
hostというファイルの名前をhosts.oldに変更します。
OdiFileMove -FILE=/etc/hosts -TOFILE=/etc/hosts.old
hostsファイルを/etcディレクトリから/home/odiディレクトリに移動します。
OdiFileMove -FILE=/etc/hosts -TOFILE=/home/odi/hosts
すべての*.csvファイルを/etcディレクトリから/home/odiディレクトリに上書きで移動します。
OdiFileMove -FILE=/etc/*.csv -TODIR=/home/odi -OVERWRITE=yes
すべての*.csvファイルを/etcディレクトリから/home/odiディレクトリに移動し、拡張子を.txtに変更します。
OdiFileMove -FILE=/etc/*.csv -TOFILE=/home/odi/*.txt -OVERWRITE=yes
C:\odiディレクトリの名前をC:\odi_is_wonderfulに変更します。
OdiFileMove -DIR=C:\odi -TODIR=C:\odi_is_wonderful
C:\odiディレクトリとそのサブフォルダをC:\Program Files\odiディレクトリに移動します。
OdiFileMove -DIR=C:\odi "-TODIR=C:\Program Files\odi" -RECURSE=yes
このコマンドを使用して、ファイル・イベントを管理します。このコマンドは、ディレクトリを定期的にスキャンし、特定の数のファイルがマスクと一致して表示されることを、指定のタイムアウトに達するまで待機します。指定のファイルが見つかると、これらのファイルに対してアクションがトリガーされます。
使用方法
OdiFileWait -DIR=<directory> -PATTERN=<pattern> [-ACTION=<DELETE|COPY|MOVE|APPEND|ZIP|NONE>] [-TODIR=<target_directory>] [-TOFILE=<target_file>] [-OVERWRITE=<yes|no>] [-CASESENS=<yes|no>] [-FILECOUNT=<n>] [-TIMEOUT=<n>] [-POLLINT=<n>] [-HEADER=<n>] [-KEEP_FIRST_HEADER=<yes|no>] [-NOFILE_ERROR=<yes|no>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
いいえ |
見つかったファイルに対するアクション:
|
|
|
はい |
スキャンするディレクトリ(またはフォルダ) |
|
|
はい |
スキャンするファイル名のマスク。汎用文字を指定するには「*」を使用します。 例: *.log (log拡張子のファイルすべて) arch_*.lst (arch_で開始するlst拡張子のファイルすべて) |
|
|
いいえ |
アクションのターゲット・ディレクトリ。アクションによって次のようになります:
|
|
|
いいえ |
宛先ファイル。アクションによって次のようになります:
|
|
|
いいえ |
宛先ファイルが存在する場合に、そのファイルを上書きするかどうかを示します。デフォルトでは、値は このオプションを |
|
|
いいえ |
ファイル検索で大文字と小文字が区別されるかどうかを示します。デフォルトでは、検索対象のファイルは大文字です。 |
|
|
いいえ |
待機するファイルの最大数(デフォルトは0)。この数に到達すると、コマンドは終了します。 0の値では、タイムアウトに到達するまで、すべてのファイルを待機します。 このパラメータが0で、タイムアウトも0の場合、このパラメータは暗黙的に1に設定されます。 |
|
|
いいえ |
ミリ秒単位の最大待機時間(デフォルトは0)。 この待機時間に到達すると、 0の値は、待機時間が無制限であることを示します( |
|
|
いいえ |
新規ファイルを検索する間隔(ミリ秒単位)。デフォルトは1000 (1秒)に設定されています。これは、Oracle Data Integratorが1秒間隔で新しいメッセージを検索することを意味します。OdiFileWaitの最中に書き込まれたファイルは、この間隔の合間に(ファイル・サイズ未変更で)閉じた後でのみ検索の対象となります。 |
|
|
いいえ |
このパラメータは 連結前にファイルから削除するヘッダー行の行数。デフォルトでは削除されません( |
|
|
いいえ |
このパラメータは 連結時に最初のファイルのヘッダー行を維持するために使用されます。デフォルトはYesです。 |
|
|
いいえ |
ファイルが見つからない場合の動作を示します。 No (デフォルト)の値は、ファイルが見つからない場合もエラーを生成しないことを示します。 |
例
c:\eventsディレクトリのflag.txtファイルを時間制限なしで待機し、ファイルが検出された場合は先に進みます。
OdiFileWait -ACTION=NONE -DIR=c:\events -PATTERN=flag.txt -FILECOUNT=1 -TIMEOUT=0 -POLLINT=1000
c:\eventsディレクトリのflag.txtファイルを時間制限なしで待機し、ファイルが検出された場合はそのファイルを削除します。
OdiFileWait -ACTION=DELETE -DIR=c:\events -PATTERN=flag.txt -FILECOUNT=1 -TIMEOUT=0 -POLLINT=1000
売上ファイル(*.dat)を5分間待機し、c:\sales_inディレクトリを1秒間隔でスキャンして、C:\sales_okディレクトリのsales.datファイルに連結します。その際、最初のファイルのヘッダーは維持します。
OdiFileWait -ACTION=APPEND -DIR=c:\sales_in -PATTERN=*.dat TOFILE=c:\sales_ok\sales.dat -FILECOUNT=0 -TIMEOUT=350000 -POLLINT=1000 -HEADER=1 -KEEP_FIRST_HEADER=yes -OVERWRITE=yes
売上ファイル(*.dat)を5分間待機し、c:\sales_inディレクトリを1秒間隔でスキャンして、C:\sales_okディレクトリにファイルをコピーします。その際、ファイルは上書きしません。
OdiFileWait -ACTION=COPY -DIR=c:\sales_in -PATTERN=*.dat -TODIR=c:\sales_ok -FILECOUNT=0 -TIMEOUT=350000 -POLLINT=1000 -OVERWRITE=no
売上ファイル(*.dat)を5分間待機し、c:\sales_inディレクトリを1秒間隔でスキャンして、これらのファイルをzipファイルにアーカイブします。
OdiFileWait -ACTION=ZIP -DIR=c:\sales_in -PATTERN=*.dat -TOFILE=c:\sales_ok\sales.zip -FILECOUNT=0 -TIMEOUT=350000 -POLLINT=1000 -OVERWRITE=yes
売上ファイル(*.dat)を5分間待機し、c:\sales_inディレクトリを1秒間隔でスキャンして、C:\sales_okディレクトリにファイルを移動します。その際、ファイルは上書きしません。ファイル名に.bakを追加します。
OdiFileWait -ACTION=MOVE -DIR=c:\sales_in -PATTERN=*.dat -TODIR=c:\sales_ok -TOFILE=*.bak -FILECOUNT=0 -TIMEOUT=350000 -POLLINT=1000 -OVERWRITE=no
このコマンドを使用して、FTPサーバーからファイルをダウンロードします。
使用方法
OdiFtpGet -HOST=<ftp server host name> -USER=<ftp user> [PASSWORD=<ftp user password>] -REMOTE_DIR=<remote dir on ftp host> [-REMOTE_FILE=<file name under the -REMOTE_DIR>] -LOCAL_DIR=<local dir> [-LOCAL_FILE=<file name under the –LOCAL_DIR>] [-PASSIVE_MODE=<yes|no>] [-TIMEOUT=<time in seconds>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
FTPサーバーのホスト名。 |
|
|
はい |
FTPサーバーのユーザー。 |
|
|
いいえ |
FTPユーザーのパスワード。 |
|
|
はい |
リモートFTPホスト上のディレクトリ・パス。 |
|
|
いいえ |
-REMOTE_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_FILEファイル名を使用してファイルがコピーされます。-LOCAL_FILE引数も欠落している場合は、-LOCAL_DIRが-REMOTE_DIRに再帰的にコピーされます。 |
|
|
はい |
ローカル・マシン上のディレクトリ・パス。 |
|
|
いいえ |
-LOCAL_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_DIRにあるすべてのファイルおよびディレクトリが、-REMOTE_DIRに再帰的にコピーされます。 コピーするファイルをフィルタ処理するには、「*」を使用して汎用文字を指定します。 例:
|
|
|
いいえ |
Noに設定すると、FTPセッションでアクティブ・モードが使用されます。デフォルト値はyesで、パッシブ・モードで実行されます。 |
|
|
いいえ |
ソケット接続がタイムアウトするまでの秒数。 |
例
FTPサーバー・マシン上のリモート・ディレクトリ/test_copy555をローカル・ディレクトリC:\temp\test_copyに再帰的にコピーします。
OdiFtpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp\test_copy -REMOTE_DIR=/test_copy555
FTPサーバー・マシン上のリモート・ディレクトリ/にあるSales*.txtパターンと一致するすべてのファイルをローカル・ディレクトリC:\temp\にコピーします。また、FTP接続にはアクティブ・モードを使用します。
OdiFtpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales*.txt -REMOTE_DIR=/ -PASSIVE_MODE=NO
このコマンドを使用して、ローカル・ファイルをFTPサーバーにアップロードします。
使用方法
OdiFtpPut -HOST=<ftp server host name> -USER=<ftp user> [PASSWORD=<ftp user password>] -REMOTE_DIR=<remote dir on ftp host> [-REMOTE_FILE=<file name under the -REMOTE_DIR>] -LOCAL_DIR=<local dir> [-LOCAL_FILE=<file name under the –LOCAL_DIR>] [-PASSIVE_MODE=<yes|no>] [-TIMEOUT=<time in seconds>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
FTPサーバーのホスト名。 |
|
|
はい |
FTPサーバーのユーザー。 |
|
|
いいえ |
FTPユーザーのパスワード。 |
|
|
はい |
リモートFTPホスト上のディレクトリ・パス。 |
|
|
いいえ |
-REMOTE_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_FILEファイル名を使用してファイルがコピーされます。-LOCAL_FILE引数も欠落している場合は、-LOCAL_DIRが-REMOTE_DIRに再帰的にコピーされます。 |
|
|
はい |
ローカル・マシン上のディレクトリ・パス。 |
|
|
いいえ |
-LOCAL_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_DIRにあるすべてのファイルおよびディレクトリが、-REMOTE_DIRに再帰的にコピーされます。 コピーするファイルをフィルタ処理するには、「*」を使用して汎用文字を指定します。 例:
|
|
|
いいえ |
Noに設定すると、FTPセッションでアクティブ・モードが使用されます。デフォルト値はyesで、パッシブ・モードで実行されます。 |
|
|
いいえ |
ソケット接続がタイムアウトするまでの秒数。 |
例
ローカル・ディレクトリC:\temp\test_copyをFTPサーバー・マシン上のリモート・ディレクトリ/test_copy555に再帰的にコピーします。
OdiFtpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp\test_copy -REMOTE_DIR=/test_copy555"
ローカル・ディレクトリC:\temp\にあるSales*.txtパターンと一致するすべてのファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にコピーします。
OdiFtpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales*.txt -REMOTE_DIR=/
ローカル・ディレクトリC:\temp\にあるSales1.txtファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にSample1.txtファイルとしてコピーします。
OdiFtpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales1.txt -REMOTE_DIR=/Sample1.txt
このコマンドを使用して、フォルダまたはプロジェクトに含まれ、マーカーによってフィルタ処理された設計時コンポーネント(パッケージ、インタフェース、プロシージャまたは変数)から一連のシナリオを生成します。
使用方法
OdiGenerateAllScen -PROJECT=<project_id> [-FOLDER=<folder_id>] [-MODE=<REPLACE|CREATE>] [-GRPMARKER=<marker_group_code> -MARKER=<marker_code>] [-GENERATE_PACK=<YES|NO>] [-GENERATE_POP=<YES|NO>] [-GENERATE_TRT=<YES|NO>] [-GENERATE_VAR=<YES|NO>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
シナリオを生成するコンポーネントが含まれているプロジェクトのID。 |
|
|
いいえ |
シナリオを生成するコンポーネントが含まれているフォルダのID。 |
|
|
いいえ |
シナリオ生成モード:
|
|
|
いいえ |
シナリオを生成するコンポーネントのフィルタ処理に使用するマーカーが含まれているグループ。 GRPMARKERとMARKERを指定すると、マーカー・コードとマーカー・グループ・コードで識別され、マーカーにフラグが指定されているコンポーネントに対してのみシナリオが(再)生成されます。 |
|
|
いいえ |
シナリオを生成するコンポーネントのフィルタ処理に使用するマーカー。 GRPMARKERとMARKERを指定すると、マーカー・コードとマーカー・グループ・コードで識別され、マーカーにフラグが指定されているコンポーネントに対してのみシナリオが(再)生成されます。 |
|
|
いいえ |
パッケージに関連付けられているシナリオを(再)生成するかどうかを指定します。デフォルト値はYESです。 |
|
|
いいえ |
インタフェースに関連付けられているシナリオを(再)生成するかどうかを指定します。デフォルト値はNOです。 |
|
|
いいえ |
プロシージャに関連付けられているシナリオを(再)生成するかどうかを指定します。デフォルト値はNOです。 |
|
|
いいえ |
変数に関連付けられているシナリオを(再)生成するかどうかを指定します。デフォルト値はNOです。 |
例
OdiGenerateAllScen -PROJECT=1003は、現在のリポジトリでIDが1003のプロジェクトに、すべてのシナリオを生成します。
このコマンドを使用して、エクスポート・ファイルの内容をリポジトリにインポートします。このコマンドは、ユーザー・インタフェースから使用可能なインポート機能の動作を再現します。
このツールを使用する際は注意が必要です。リポジトリに存在しないオブジェクトに依存するオブジェクトをインポートすると、正しく機能しない可能性があります。このAPIは、上位レベルのオブジェクト(プロジェクト、モデルなど)をインポートする目的で使用することをお薦めします。
使用方法
OdiImportObject -FILE_NAME=<FileName> [-WORK_REP_NAME=<workRepositoryName>] -IMPORT_MODE=<DUPLICATION | SYNONYM_INSERT | SYNONYM_UPDATE | SYNONYM_INSERT_UPDATE> [-IMPORT_SCHEDULE=<yes|no>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
インポートするXMLエクスポート・ファイルの名前。 |
|
|
いいえ |
オブジェクトのインポート先作業リポジトリの名前。この作業リポジトリは、接続しているマスター・リポジトリに定義されている必要があります。このパラメータの指定を省略すると、オブジェクトは現在のマスター・リポジトリまたは作業リポジトリにインポートされます。 |
|
|
はい |
オブジェクトのインポート・モード。デフォルト値は |
|
|
いいえ |
選択したファイルがシナリオ・エクスポート・ファイルの場合は、そのファイルに格納されているスケジュールをインポートします。デフォルトはnoです。 |
例
/temp/DW01.xmlエクスポート・ファイル(プロジェクト)をWORKREP作業リポジトリにDUPLICATIONモードを使用してインポートします。
OdiImportObject -FILE_NAME=/temp/DW01.xml -WORK_REP_NAME=WORKREP -IMPORT_MODE=DUPLICATION
このコマンドを使用して、エクスポート・ファイルから現在の作業リポジトリにシナリオをインポートします。
使用方法
OdiImportScen -FILE_NAME=<FileName> [-IMPORT_MODE=<DUPLICATION | SYNONYM_INSERT | SYNONYM_UPDATE | SYNONYM_INSERT_UPDATE>] [IMPORT_SCHEDULE=<yes|no>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
エクスポート・ファイルの名前。 |
|
|
いいえ |
シナリオのインポート・モード。デフォルト値は |
|
|
いいえ |
シナリオ・エクスポート・ファイルに格納されているスケジュールをインポートします。デフォルトはnoです。 |
例
/temp/load_dwh.xmlエクスポート・ファイル(シナリオ)を現在の作業リポジトリにDUPLICATIONモードを使用してインポートします。
OdiImportScen -FILE_NAME=/temp/load_dwh.xml -IMPORT_MODE=DUPLICATION
|
注意: このツールはOdiExecuteWebServiceツールに代わるものです。 |
このコマンドを使用して、HTTP/HTTPSを介してWebサービスを呼び出し、レスポンスをXMLファイルに書き込みます。
このツールは、記述ファイル(WSDL)のURLが提供されているWebサービスのポートで、特定の操作を呼び出します。
この操作にWebサービス・リクエストが必要な場合は、リクエスト・ファイルで、またはツール・コール(<XML Request>)に直接書き込まれて提供されます。このリクエスト・ファイルには、2つの異なる形式(XML本文のみに対応するXML、またはSOAPのヘッダーと本文が格納された完全なSOAPエンベロープに対応するSOAP)をRESPONSE_FILE_FORMATパラメータで指定できます。Webサービス・リクエストのレスポンスは、後でOracle Data Integratorで処理できるXMLファイルに書き込まれます。Webサービス操作が一方向でレスポンスを返さない場合、レスポンス・ファイルは生成されません。
|
注意: このツールは、コマンドラインでstartcmdを使用して実行できません。 |
使用方法
OdiInvokeWebService -URL=<url> -PORT=<port> -OPERATION=<operation> [<XML Request>][-REQUEST_FILE=<xml_request_file>] [-RESPONSE_MODE=<NO_FILE|NEW_FILE|FILE_APPEND>] [-RESPONSE_FILE=<xml_response_file>] [-RESPONSE_XML_ENCODING=<charset>] [-RESPONSE_FILE_CHARSET=<charset>] [-RESPONSE_FILE_FORMAT=<XML|SOAP>][-HTTP_USER=<user>] [-HTTP_PASS=<password>] [-TIMEOUT=<timeout>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
Webサービスを記述しているWebサービス記述ファイル(WSDL)のURL。 |
|
|
はい |
呼び出すWSDLポート・タイプの名前。 |
|
|
はい |
呼び出すWebサービス操作の名前。 |
|
|
いいえ |
SOAP (Simple Object Access Protocol)形式のリクエスト・メッセージ。このメッセージは、OdiInvokeWebServiceコールの直後の行に指定する必要があります。 このリクエストは、場所がREQUEST_FILEパラメータで指定されているファイルを介して渡すこともできます。 |
|
|
いいえ |
SOAP (Simple Object Access Protocol)形式のリクエスト・メッセージが含まれているXMLファイルの場所。 このリクエストは、ツール・コール( |
|
|
いいえ |
レスポンス・ファイルの生成モード。このパラメータの値は、次のいずれかです。
|
|
|
場合による |
結果を書き込むファイルの名前。-RESPONSE_MODEがNEW_FILEまたはAPPENDの場合は必須です。 |
|
|
場合による |
レスポンス・ファイルの文字エンコーディング。次の表を参照してください。-RESPONSE_MODEがNEW_FILEまたはAPPENDの場合は必須です。 |
|
|
場合による |
レスポンス・ファイルのXML宣言ヘッダーに示される文字エンコーディング。次の表を参照してください。-RESPONSE_MODEがNO_FILEでない場合は必須です。 |
|
|
いいえ |
リクエストおよびレスポンス・ファイルの形式。
|
|
|
いいえ |
HTTPサーバーで認証するユーザー・アカウント。 |
|
|
いいえ |
HTTPユーザーのパスワード。 |
|
|
いいえ |
Webサービス・リクエストは、この時間が経過するまで応答を待機した後、サーバーがレスポンスを戻さないと判断してエラーを生成します。デフォルトは15秒。 |
次の表に、最も一般的なXML/Java文字エンコーディングの一部を示します。より完全なリストは、次の場所から入手できます。
http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html
| XMLキャラクタ・セット | Javaキャラクタ・セット |
|---|---|
|
US-ASCII |
ASCII |
|
UTF-8 |
UTF8 |
|
UTF-16 |
UTF-16 |
|
ISO-8859-1 |
ISO8859_1 |
例
次のWebサービス・コールは、指定された国の首都を戻します(ISO国別コードはリクエストで送信されます)。リクエストおよびレスポンスの形式と、使用できるポートおよび操作が、URLパラメータで渡されるWSDLに定義されていることに注意してください。
OdiInvokeWebService - -URL=http://www.oorsprong.org/websamples.countryinfo/CountryInfoService.wso ?WSDL -PORT_TYPE=CountryInfoServiceSoapType -OPERATION=CapitalCity -RESPONSE_MODE=NEW_FILE -RESPONSE_XML_ENCODING=ISO-8859-1 "-RESPONSE_FILE=/temp/result.xml" -RESPONSE_FILE_CHARSET=ISO8859_1 -RESPONSE_FILE_FORMAT=XML <CapitalCityRequest> <sCountryISOCode>US</sCountryISOCode> </CapitalCityRequest>
生成した/temp/result.xmlファイルの内容は、次のようになります。
<CapitalCityResponse> <m:CapitalCityResponse> <m:CapitalCityResult>Washington</m:CapitalCityResult> </m:CapitalCityResponse> </CapitalCityResponse>
パッケージ
Oracle Data Integratorには、パッケージ内でOdiInvokeWebServiceをコールするための特別なグラフィカル・インタフェースが用意されています。詳細は、第15章「Oracle Data IntegratorでのWebサービスの使用」を参照してください。
このコマンドを使用して、スタンドアロン・エージェントを停止します。
アプリケーション・サーバーにデプロイされているJava EEエージェントは、このツールでは停止できません。アプリケーション・サーバーのユーティリティを使用して停止する必要があります。
使用方法
OdiKillAgent (-PORT=<TCP/IP Port>|-NAME=<physical_agent_name>) [-IMMEDIATE=<yes|no>] [-MAX_WAIT=<timeout>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
いいえ |
このパラメータを指定すると、ローカル・マシンの指定ポートで実行中のエージェントが停止されます。 |
|
|
はい |
このパラメータを指定すると、指定した名前の物理エージェントが停止されます。このエージェントには、ローカルまたはリモートのエージェントを指定できます。エージェントはマスター・リポジトリで宣言する必要があります。 |
|
|
いいえ |
このパラメータをyesに設定すると、実行中のセッションの完了を待機せずにエージェントが停止されます。noに設定すると、実行中のセッションがすべて完了した後、またはMAX_WAITタイムアウトに到達した後で、エージェントが停止されます。デフォルト値はNoです。 |
|
|
いいえ |
このパラメータは、IMMEDIATEがNoに設定されている場合に使用できます。このパラメータには、実行中のセッションに関係なくエージェントを停止するタイムアウトをミリ秒単位で定義します。デフォルトは0です。これは、タイムアウトが発生せず、実行中のセッションすべてが完了した後で、エージェントが停止されることを意味します。 |
例
ODI_AGT_001物理エージェントをただちに停止します。
OdiKillAgent -NAME=ODI_AGT_001 -IMMEDIATE=yes
このコマンドを使用して、ディレクトリ構造を作成します。
親ディレクトリが存在しない場合、このコマンドは親ディレクトリを再帰的に作成します。
使用方法
OdiMkDir -DIR=<directory>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
-DIR=<directory> |
はい |
作成するディレクトリ(またはフォルダ)。 |
例
C:\tempにodiディレクトリを作成します。C:\tempがない場合はそのディレクトリも作成されます。
OdiMkDir "-DIR=C:\temp\odi"
このコマンドを使用して、コマンドを実行するオペレーティング・システムのコマンド・シェルを呼び出し、出力結果をファイルにリダイレクトします。
次のオペレーティング・システムがサポートされます。
Windows 95、98、ME (command.comを使用)
Windows NT、2000、XP (cmdを使用)
POSIX準拠のOS (shを使用)
次のオペレーティング・システムはサポートされていません。
Mac OS
使用方法
OdiOSCommand [-OUT_FILE=<stdout_file>] [-ERR_FILE=<stderr_file>] [-FILE_APPEND=<yes|no>] [-WORKING_DIR=<workingdir>] [-SYNCHRONOUS=<yes|no>]] [CR/LF <command> | -COMMAND=<command>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
実行するコマンド。スペースを使用する引数はコマンド・シェルで適切に解釈されるように引用符で囲みます。複数行コマンドの場合は、OdiOSCommand行の後に-COMMANDパラメータを指定せずに、コマンド全体をRAWテキストとして渡します。 |
|
|
いいえ |
標準出力のリダイレクト先ファイルの絶対名。 |
|
|
いいえ |
標準エラー出力のリダイレクト先ファイルの絶対名。 |
|
|
いいえ |
出力ファイルを上書きせずに追加するかどうか。 |
|
|
いいえ |
コマンドが実行されるディレクトリ。 |
|
|
いいえ |
yesの場合、セッションはコマンドの終了を待機します。noの場合、セッションはエラー・コード0で即時に続行します。デフォルトでは、同期モードで実行されます。 |
例
次のコマンドは、c:\work\load.batファイル(Windowsマシン)を実行し、出力ストリームをファイルに追加します。
OdiOSCommand "-OUT_FILE=c:\work\load-out.txt" "-ERR_FILE=c:\work\load-err.txt" "-FILE_APPEND=YES" "-WORKING_DIR=c:\work" c:\work\load.bat
このコマンドを使用して、テキスト・ファイルに内容を書き込むか追加します。
使用方法
OdiOutFile -FILE=<file_name> [-APPEND] [-CHARSET_ENCODING=<encoding>] [-XROW_SEP=<hexadecimal_line_break>] [CR/LF <text> | -TEXT=<text>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
ターゲット・ファイル。パスは、絶対パスまたは実行エージェントの場所に対する相対パスを指定できます。 |
|
|
いいえ |
<Text>をファイルの最後に追加するかどうかを示します。このパラメータが指定されていない場合は、現存するファイルが上書きされます。 |
|
|
いいえ |
ターゲット・ファイルのエンコーディング。デフォルト値はISO-8859-1です。サポートされているエンコーディングは、次のURLで確認できます。 http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
|
|
いいえ |
行セパレータ(改行)として使用する文字の16進コード。0A (UNIXの改行)がデフォルトになります。Windowsの改行の場合は値を0D0Aにします。 |
|
|
はい |
ファイルに書き込むテキスト。このテキストは、OdiOutFileコマンドの次の行(改行の |
例
次のコマンドは、コマンドを実行したエージェントのUNIXマシンに/var/tmp/my_file.txtファイルを生成します。
OdiOutFile -FILE=/var/tmp/my_file.txt
Welcome to Oracle Data Integrator
This file has been overwritten by <%=odiRef.getSession("SESS_NAME")%>
次のコマンドは、コマンドを実行するエージェントのNTマシンのhostsファイルにPLUTONエントリを追加します。
OdiOutFile -FILE=C:\winnt\system32\drivers\etc\hosts -APPEND 195.10.10.6 PLUTON pluton
このコマンドを使用して、指定のエージェントに対してテストを実行します。このコマンドは、エージェントが開始されていないとエラーになります。
使用方法
OdiPingAgent -AGENT_NAME=<physical_agent_name>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
テストする物理エージェントの名前。 AGENT_NAMEを使用する古い構文も有効ですが、非推奨です。 |
例
物理エージェントAGENT_SOLARIS_DEVをテストします。
OdiPingAgent -AGENT_NAME=AGENT_SOLARIS_DEV
このコマンドを使用して、実行ログをパージします。
OdiPurgeLogツールは、フィルタ基準と一致するすべてのセッション・ログまたはロード計画実行(あるいはその両方)をパージします。
PURGE_TYPEパラメータは、パージするオブジェクトを定義します。
SESSIONを選択すると、基準と一致するすべてのセッション・ログがパージされます。親セッションが基準と一致すると、子セッションと孫セッションがパージされます。ロード計画の実行によって起動されたセッションは子セッションも含めて、パージされません。
LOAD_PLAN_RUNを選択すると、基準と一致するすべてのロード計画ログがパージされます。ロード計画実行から起動されたセッションは、ロード計画実行自体に関連付けられているセッションが基準と一致しない場合でもすべてパージされることに注意してください。
ALLを選択すると、基準と一致するセッション・ログとロード計画実行の両方がパージされます。
COUNTパラメータを使用すると、ログに保持する(フィルタ処理後の)セッションまたはロード計画実行(あるいはその両方)の件数を定義できます。ARCHIVEパラメータを使用すると、パージしたセッションまたはロード計画実行(あるいはその両方)を自動的にアーカイブできます。
|
注意: 「実行中」、「待機中」または「キュー」ステータスのロード計画およびセッションはパージされません。 |
使用方法
OdiPurgeLog [-PURGE_TYPE=<SESSION|LOAD_PLAN_RUN|ALL>] [-COUNT=<session_number>][-FROMDATE=<from_date>] [TODATE=<to_date>] [-CONTEXT_CODE=<context_code>] [-USER_NAME=<user_name>] [-AGENT_NAME=<agent_name>] [-PURGE_REPORTS=<Yes|No>] [-STATUS=<D|E|M>][-NAME=<session_or_load_plan_name>][-ARCHIVE=<Yes|No>][-TODIR=<directory>][-ZIPFILE_NAME=<zipfile_name>] [-XML_CHARSET=<charset>][-JAVA_CHARSET=<charset>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
いいえ |
フィルタ基準: セッション・ログのみ、ロード計画ログのみ、または両方をパージします。デフォルトはSESSIONです。 |
|
|
いいえ |
指定したフィルタ基準と一致するセッションまたはロード計画実行(あるいはその両方)の最新件数を保持し、残りをパージします。このパラメータが未指定またはゼロの場合は、フィルタ基準と一致するすべてのセッションまたはロード計画実行(あるいはその両方)をパージします。 |
|
|
いいえ |
フィルタ基準: パージの開始日。yyyy/MM/dd hh:mm:ssの書式を使用します。 -FROMDATEを省略すると、最も古いセッションまたはロード計画実行(あるいはその両方)からパージが実行されます。 |
|
|
いいえ |
フィルタ基準: パージの終了日。yyyy/MM/dd hh:mm:ssの書式を使用します。 -TODATEを省略すると、最新のセッションまたはロード計画実行(あるいはその両方)までパージが実行されます。 |
|
|
いいえ |
フィルタ基準: <context_code>で実行されたセッションまたはロード計画実行(あるいはその両方)のみをパージします。
|
|
|
いいえ |
フィルタ基準: <user_name>で起動されたセッションまたはロード計画実行(あるいはその両方)のみをパージします。 |
|
|
いいえ |
フィルタ基準: <agent_name>で実行されたセッションまたはロード計画実行(あるいはその両方)のみをパージします。 |
|
|
いいえ |
1の場合は、シナリオ・レポート(各シナリオの実行ノードの下に表示)もパージされます。 |
|
|
いいえ |
フィルタ基準: 指定した状態のセッションまたはロード計画実行(あるいはその両方)のみをパージします。
このパラメータが指定されていない場合は、前述のすべての状態のセッションまたはロード計画実行(あるいはその両方)がパージされます。 |
|
|
いいえ |
フィルタ基準: セッション名またはロード計画名のフィルタ。 |
|
|
いいえ |
Yesに設定すると、パージする前にセッションまたはロード計画実行(あるいはその両方)をエクスポートします。 |
|
|
いいえ |
エクスポートのターゲット・ディレクトリ。このパラメータは、ARCHIVEがyesに設定されている場合は必須です。 |
|
|
いいえ |
圧縮ファイルの名前。 エクスポートのターゲット・ディレクトリ。このパラメータは、ARCHIVEがyesに設定されている場合は必須です。 |
|
|
いいえ |
エクスポート・ファイルのXMLエンコーディング。デフォルト値はISO-8859-1です。サポートされているエンコーディングは、次のURLで確認できます。
|
|
|
いいえ |
エクスポート・ファイルのエンコーディング。デフォルト値は
|
例
2001/03/25 00:00:00から2001/08/31 21:59:00に実行されたすべてのセッションをパージします。
OdiPurgeLog "-FROMDATE=2001/03/25 00:00:00" "-TODATE=2001/08/31 21:59:00"
内部エージェントによってGLOBALコンテキストで実行され、現在はエラー・ステータスのロード計画実行すべてをパージします。
OdiPurgeLog "-PURGE_TYPE=LOAD_PLAN_RUN" "-CONTEXT_CODE=GLOBAL" "-AGENT_NAME=Internal" "-STATUS=E"
このコマンドを使用して、電子メールおよび添付ファイルをPOPまたはIMAPアカウントから読み取ります。
このコマンドは、USERとPASSで指定された接続パラメータを使用して、メール・サーバーMAILHOSTに接続します。実行エージェントは、MAX_MSG件のメッセージを受信するまで、またはTIMEOUTで指定された最大待機時間に達するまで、メールボックスからメッセージを読み取ります。抽出されたメッセージは、SUBJECTおよびSENDERのパラメータで指定されているようなフィルタと一致している必要があります。これらの基準を満たすメッセージは、その内容と添付ファイルがFOLDERパラメータで指定されたディレクトリに抽出されます。KEEPパラメータがnoに設定されている場合、取得したメッセージはメールボックスから削除されます。
使用方法
OdiReadMail -MAILHOST=<mail_host> -USER=<mail_user> -PASS=<mail_user_password> -FOLDER=<folder_path> [-PROTOCOL=<pop3|imap>] [-FOLDER_OPT=<none|sender|subject>] [-KEEP=<no|yes>] [-EXTRACT_MSG=<yes|no>] [-EXTRACT_ATT=<yes|no>] [-MSG_PRF=<my_prefix>] [-ATT_PRF=<my_prefix>] [-USE_UCASE=<no|yes>] [-NOMAIL_ERROR=<no|yes>] [-TIMEOUT=<timeout>] [-POLLINT=<pollint>] [-MAX_MSG=<max_msg>] [-SUBJECT=<subject_filter>] [-SENDER=<sender_filter>] [-TO=<to_filter>] [-CC=<cc_filter>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
POPまたはIMAPメール・サーバーのIPアドレス。 |
|
|
はい |
有効なメール・サーバーのアカウント。 |
|
|
はい |
メール・サーバー・アカウントのパスワード。 |
|
|
はい |
添付ファイルおよびメッセージ用のストレージ・フォルダのフル・パス。 |
|
|
いいえ |
メール・アクセスのタイプ(POP3またはIMAP)。デフォルトはPOP3です。 |
|
|
いいえ |
次のパラメータに従ってFOLDERディレクトリにサブディレクトリを作成できます。
senderおよびsubjectフォルダ・オプションでは、スペースと、英数字以外の文字(@など)は、生成されたフォルダ名ではアンダースコアに置き換えられます。 |
|
|
いいえ |
yes: フィルタと一致するメッセージを読み込んだ後、そのメッセージをメールボックス内に保持します。 no (デフォルト): フィルタと一致するメッセージを読み込んだ後、そのメッセージをメールボックスから削除します。 |
|
|
いいえ |
yes (デフォルト): メッセージの本文をファイルに抽出します。 no: メッセージの本文をファイルに抽出しません。 |
|
|
いいえ |
yes (デフォルト): 添付ファイルをファイルに抽出します。 no: 添付ファイルを抽出しません。 |
|
|
いいえ |
メッセージ本文を格納するファイルの接頭辞。デフォルトはMSGです。 |
|
- |
いいえ |
添付ファイルを格納するファイルの接頭辞。元のファイル名は維持されます。 |
|
|
いいえ |
yes: ファイル名を強制的に大文字にします。 no (デフォルト): 元の大文字と小文字を維持します。 |
|
|
いいえ |
yes: メールが指定の基準と一致しない場合は、エラーを生成します。 no (デフォルト): 指定の基準に対応するメールがない場合は、エラーを生成しません。 |
|
|
いいえ |
ミリ秒単位の最大待機時間(デフォルトは0)。 この待機時間に到達すると、コマンドは終了します。 0の値(デフォルト)は、待機時間が無制限であることを示します(MAX_MSGパラメータで指定された最大メッセージ数に達するまで)。 |
|
|
いいえ |
新しいメッセージをスキャンする検索間隔(ミリ秒単位)。デフォルトは1000 (1秒)です。 |
|
|
いいえ |
抽出するメッセージの最大数(デフォルトは1)。この数に到達すると、コマンドは終了します。 |
|
|
いいえ |
件名に応じたメッセージのフィルタ処理に使用するパラメータ。 |
|
|
いいえ |
送信者に応じたメッセージのフィルタ処理に使用するパラメータ。 |
|
|
いいえ |
アドレスに応じたメッセージのフィルタ処理に使用するパラメータ。このオプションを繰り返し使用すると、複数のフィルタを作成できます。 |
|
|
いいえ |
コピーのアドレスに応じたメッセージのフィルタ処理に使用するパラメータ。このオプションを繰り返し使用すると、複数のフィルタを作成できます。 |
例
supportのメールを自動受信します。添付ファイルは切り離してエージェントのマシンのC:\supportフォルダに格納します。10秒の最大待機時間で、すべてのメッセージを待機します。
OdiReadMail -MAILHOST=mail.mymail.com -USER=myaccount -PASS=mypass -KEEP=no -FOLDER=c:\support -TIMEOUT=0 -MAX_MSG=0 -SENDER=support@mycompany.com -EXTRACT_MSG=yes -MSG_PRF=TXT -EXTRACT_ATT=yes
1分間隔で新しいメッセージをチェックし、メッセージが10件になるまで無期限で待機します。
OdiReadMail -MAILHOST=mail.mymail.com -USER=myaccount -PASS=mypass -KEEP=no -FOLDER=c:\support -TIMEOUT=0 -MAX_MSG=10 -POLLINT=60000 -SENDER=support@mycompany.com -EXTRACT_MSG=yes -MSG_PRF=TXT -EXTRACT_ATT=yes
このコマンドを使用して、指定のジャーナル化サブスクライバについて、指定の表リストまたはCDCセットに対して消費する行の数をリフレッシュします。このリフレッシュは、論理スキーマと指定のコンテキスト上で実行されるため、制限されることがあります。
|
注意: このコマンドは、簡易モードまたは一貫モードでジャーナル化された表に適しています。また、コマンドラインでstartcmdを使用して実行することはできません。 |
使用方法
OdiRefreshJournalCount -LSCHEMA=<logical_schema> -SUBSCRIBER_NAME=<subscriber_name> (-TABLE_NAME=<table_name> | -CDC_SET_NAME=<cdc set name>) [-CONTEXT=<context>] [-MAX_JRN_DATE=<to_date>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
ジャーナル化された表が格納されている論理スキーマ。 |
|
|
簡易CDCでは必須 |
チェックするジャーナル化表の名前、マスクまたはリスト。このパラメータでは3つの書式を使用できます。
このオプションは簡易モードでジャーナル化されたモデルの表でのみ機能します。 このパラメータは |
|
|
一貫性セットCDCでは必須 |
チェックするCDCセットの名前。 このオプションは一貫性モードでジャーナル化されたモデルの表でのみ機能します。 このパラメータは |
|
|
はい |
カウントをリフレッシュするサブスクライバの名前。 |
|
|
いいえ |
論理スキーマを解決するコンテキスト。コンテキストの指定を省略すると、実行コンテキストが使用されます。 |
|
|
いいえ |
ジャーナル化イベントが考慮される最終日(日時)。 |
例
SALES_APPLICATIONスキーマのCUSTOMERS表で、SALES_SYNCサブスクライバについて記録されている変更数をリフレッシュします。このデータストアは簡易モードでジャーナル化されます。
OdiRefreshJournalCount -LSCHEMA=SALES_APPLICATION -TABLE_NAME=CUSTOMERS -SUBSCRIBER_NAME=SALES_SYNC
SALES_APPLICATIONスキーマのSALES CDCセットのすべての表で、SALES_SYNCサブスクライバについて記録されている変更数をリフレッシュします。このデータストアは一貫性のセットCDCでジャーナル化されます。
OdiRefreshJournalCount -LSCHEMA=SALES_APPLICATION -SUBSCRIBER_NAME=SALES_SYNC -CDC_SET_NAME=SALES
このコマンドを使用して、Oracle Data Integrator順序を再初期化します。
使用方法
OdiReinitializeSeq -SEQ_NAME=<sequence_name> -CONTEXT=<context> -STD_POS=<position>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
再初期化する順序の名前。グローバル順序の場合はGLOBAL、プロジェクト順序の場合は<project code>を接頭辞として使用する必要があります。 |
|
|
はい |
順序の再初期化が必要なコンテキスト。 |
|
|
はい |
順序の再初期化が必要な位置。 |
例
GLOBALコンテキストのグローバル順序SEQ_Iをゼロにリセットします。
OdiReinitializeSeq -SEQ_NAME=GLOBAL.SEQ_I -CONTEXT=GLOBAL -STD_POS=0
このコマンドを使用して、指定したジャーナル化サブスクライバについて、指定の表リストまたはCDCセットのジャーナル化イベントを取得します。この取得は、表を格納しているテクノロジに固有の方法で実行されます。この取得は、論理スキーマと指定のコンテキスト上で実行されます。
|
注意: このツールは、簡易モードまたは一貫性セット・モードでジャーナル化された表に対して機能します。また、コマンドラインでstartcmdを使用して実行することはできません。 |
使用方法
OdiRetrieveJournalData -LSCHEMA=<logical_schema> -SUBSCRIBER_NAME=<subscriber_name> (-TABLE_NAME=<table_name> | -CDC_SET_NAME=<cdc_set_name>) [-CONTEXT=<context>] [-MAX_JRN_DATE=<to_date>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
ジャーナル化された表が格納されている論理スキーマ。 |
|
|
いいえ |
チェックするジャーナル化表の名前、マスクまたはリスト。このパラメータでは3つの書式を使用できます。
このオプションは簡易モードでジャーナル化されたモデルの表でのみ機能します。 このパラメータは |
|
|
いいえ |
更新するCDCセットの名前。 このオプションは一貫性モードでジャーナル化されたモデルの表でのみ機能します。 このパラメータは |
|
|
はい |
データを取得するサブスクライバの名前。 |
|
|
いいえ |
論理スキーマを解決するコンテキスト。コンテキストの指定を省略すると、実行コンテキストが使用されます。 |
|
|
いいえ |
ジャーナル化イベントが考慮される最終日(日時)。 |
例
SALES_APPLICATIONスキーマのCUSTOMERS表で、SALES_SYNCサブスクライバのジャーナル化イベントを取得します。
OdiRetrieveJournalData -LSCHEMA=SALES_APPLICATION -TABLE_NAME=CUSTOMERS -SUBSCRIBER_NAME=SALES_SYNC
このコマンドを使用して、リバース表内の指定モデルのメタデータをJDBCドライバの機能を介してリバースエンジニアリングします。通常、このコマンドの前にはOdiReverseResetTable、後にはOdiReverseSetMetaDataがあります。
|
注意:
|
使用方法
OdiReverseGetMetaData -MODEL=<model_id>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
リバースエンジニアリングするモデル。 |
例
RKMの現在のモデルをリバースします。
OdiReverseGetMetaData -MODEL=<%=odiRef.getModel("ID")%>
このコマンドは、モデル内でショートカットがリバースエンジニアリングされたときに、ショートカットをどのように処理するかを定義するために使用します。
使用方法
OdiReverseManageShortcut "-MODEL=<model_id>" "-MODE=MATERIALIZING_MODE"
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
リバースするモデルの内部識別子。 |
|
|
はい |
このオプションには、次の値を使用できます:
|
例
OdiReverseManageShortcut -MODEL=125880 -MODE=ALWAYS_MATERIALIZE
このコマンドを使用して、指定のモデルに対するリバース表の内容をリセットします。このコマンドは、通常、カスタマイズされたリバースエンジニアリング・プロセスの最初に使用されます。
使用方法
OdiReverseResetTable -MODEL=<model_id>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
リバースするモデルの内部識別子。 |
例
OdiReverseResetTable -MODEL=123001
このコマンドを使用して、指定のデータ・モデルについて、リバース表のメタデータをリポジトリに統合します。
使用方法
OdiReverseSetMetaData -MODEL=<model_id> [-USE_TABLE_NAME_FOR_UPDATE=<true|false>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
リバースするモデルの内部識別子。 |
|
|
いいえ |
|
例
OdiReverseSetMetaData -MODEL=123001 -USE_TABLE_NAME_FOR_UPDATE=true
このコマンドを使用して、XMLソース・ファイルからSAP Internal Documents (IDoc)を生成し、これらのIDocをALE (Application Link Enabling)を使用してリモートtRFC Server (SAP R/3 Server)に転送します。
|
注意: OdiSAPALEClientツールは、SAP Java Connector 2.xをサポートしています。SAP Java Connectors 3.xを使用する場合は、OdiSAPALEClient3ツールを使用してください。 |
OdiSAPALEClientの使用方法
OdiSAPALEClient -USER=<sap_logon> -ENCODED_PASSWORD=<password> -GATEWAYHOST=<gateway_host> -SYSTEMNR=<system_number> -MESSAGESERVERHOST=<message_server> -R3NAME=<system_name> -APPLICATIONSERVERSGROUP=<group_name> [-DIR=<directory>] [-FILE=<file>] [-CASESENS=<yes|no>] [-MOVEDIR=<target_directory>] [-DELETE=<yes|no>] [-POOL_KEY=<pool_key>] [-LANGUAGE=<language>] [-CLIENT=<client>] [-MAX_CONNECTIONS=<n>] [-TRACE=<no|yes>]
OdiSAPALEClient3の使用方法
OdiSAPALEClient3 -USER=<sap_logon> -ENCODED_PASSWORD=<password> -GATEWAYHOST=<gateway_host> -SYSTEMNR=<system_number> -MESSAGESERVERHOST=<message_server> -R3NAME=<system_name> -APPLICATIONSERVERSGROUP=<group_name> [-DIR=<directory>] [-FILE=<file>] [-CASESENS=<yes|no>] [-MOVEDIR=<target_directory>] [-DELETE=<yes|no>] [-POOL_KEY=<pool_key>] [-LANGUAGE=<language>] [-CLIENT=<client>] [-MAX_CONNECTIONS=<n>] [-TRACE=<no|yes>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
SAPログオン。このユーザーはシステム・ユーザーの場合があります。 |
|
|
非推奨 |
SAPログオン・パスワード。このコマンドは非推奨です。かわりに |
|
|
はい |
暗号化されたSAPログオン・パスワード。このパスワードはOSコマンド |
|
|
いいえ |
ゲートウェイ・ホスト。 |
|
|
いいえ |
SAPシステム番号。 |
|
|
いいえ |
メッセージ・サーバーのホスト名。 |
|
|
いいえ |
SAPシステムの名前(r3name)。 |
|
|
いいえ |
アプリケーション・サーバーのグループ名。 |
|
|
いいえ |
XMLソース・ファイル・ディレクトリ。このパラメータは、 |
|
|
いいえ |
ソースXMLファイルの名前。このパラメータを省略すると、 |
|
|
いいえ |
ソース・ファイル名の大文字と小文字が区別されるかどうかを示します。デフォルトは |
|
|
いいえ |
このパラメータを指定すると、処理後にソース・ファイルがこのディレクトリに移動します。 |
|
|
いいえ |
処理後にソース・ファイルを削除します。デフォルトは |
|
|
いいえ |
接続プールの名前。デフォルトは |
|
|
いいえ |
エラー・メッセージで使用する言語コード。デフォルトは |
|
|
いいえ |
クライアント識別子。デフォルトは |
|
|
いいえ |
プールの最大接続数。デフォルトは3です。 |
|
|
いいえ |
生成されたIDocファイルをソース・ファイル・ディレクトリにアーカイブします。ソース・ファイルが( |
例
/sapディレクトリのすべてのファイルを処理し、SAPサーバーにIDocsとして送信します。処理後に、オリジナルのXMLと生成されたファイルは/logディレクトリに格納されます。
OdiSAPALEClient -USER=ODI -ENCODED_PASSWORD=xxx -SYSTEMNR=002 -GATEWAYHOST=GW001 -DIR=/sap -MOVEDIR=/log -TRACE=yes
このコマンドを使用して、ALE (Application Link Enabling)を介して転送されたSAP IDocsを受信するtRFCリスナーを起動します。このリスナーにより、着信IDocsが指定されたディレクトリのXMLファイルに変換されます。
|
注意: OdiSAPALEServerツールは、SAP Java Connector 2.xをサポートしています。SAP Java Connectors 3.xを使用する場合は、OdiSAPALEServer3ツールを使用してください。 |
OdiSAPALEServerの使用方法
OdiSAPALEServer -USER=<sap_logon> -ENCODED_PASSWORD=<password> -GATEWAYHOST=<gateway_host> -SYSTEMNR=<system_number> -GATEWAYNAME=<gateway_name> -PROGRAMID=<program_id> -DIR=<target_directory> [-TIMEOUT=<n>] [-POOL_KEY=<pool_key>] [-LANGUAGE=<Language>] [-CLIENT=<client>] [-MAX_CONNECTIONS=<n>] [-INTERREQUESTTIMEOUT=<n>] [-MAXREQUEST=<n>] [-TRACE=<no|yes>]
OdiSAPALEServer3の使用方法
OdiSAPALEServer3 -USER=<sap_logon> -ENCODED_PASSWORD=<password> -GATEWAYHOST=<gateway_host> -SYSTEMNR=<system_number> -GATEWAYNAME=<gateway_name> -PROGRAMID=<program_id> -DIR=<target_directory> [-TIMEOUT=<n>] [-POOL_KEY=<pool_key>] [-LANGUAGE=<Language>] [-CLIENT=<client>] [-MAX_CONNECTIONS=<n>] [-INTERREQUESTTIMEOUT=<n>] [-MAXREQUEST=<n>] [-TRACE=<no|yes>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
SAPログオン。このユーザーはシステム・ユーザーの場合があります。 |
|
|
はい |
暗号化されたSAPログオン・パスワード。このパスワードはOSコマンド |
|
|
はい |
ゲートウェイ・ホスト。 |
|
|
はい |
SAPシステム番号。 |
|
|
はい |
ゲートウェイ名。 |
|
|
はい |
プログラムID。tRFCサーバーによって使用される外部名です。 |
|
|
はい |
ターゲットXMLファイルを格納するディレクトリ。これらのファイルの名前は、 |
|
|
はい |
接続プールの名前。デフォルトは |
|
- |
はい |
エラー・メッセージで使用する言語コード。デフォルトは |
|
|
はい |
SAPクライアント識別子。デフォルトは001です。 |
|
|
いいえ |
サーバーの存続期間(ミリ秒単位)。この期間の終了時にサーバーは自動的に停止します。このタイムアウトがゼロに設定されている場合、サーバーの存続期間は無限です。デフォルトは0です。 |
|
|
はい |
接続のプールに対する最大許容接続数。デフォルトは3です。 |
|
|
いいえ |
nミリ秒の間隔の合間にIDOCを受信しない場合、リスナーは停止します。このタイムアウトがゼロに設定されている場合、タイムアウトは無限です。デフォルトは0です。 |
|
|
いいえ |
リスナーが停止するまでの最大リクエスト数。このパラメータがゼロに設定されている場合、サーバーで予期されるリクエスト数は無限です。デフォルトは0です。 注意: |
|
|
いいえ |
デバッグ・トレースをアクティブにします。デフォルトは |
例
2つのIDocファイルを待機し、/tempディレクトリにターゲットXMLファイルを生成します。
OdiSAPALEServer -POOL_KEY=ODI -MAX_CONNECTIONS=3 -CLIENT=001 -USER=ODI -ENCODED_PASSWORD=xxx -LANGUAGE=EN -GATEWAYHOST=SAP001 -SYSTEMNR=002 -GATEWAYNAME=GW001 -PROGRAMID=ODI01 -DIR=/tmp -MAXREQUEST=2
このコマンドを使用して、SSHサーバーからファイルをダウンロードします。
使用方法
OdiScpGet -HOST=<ssh server host name> -USER=<ssh user> [-PASSWORD=<ssh user password>] -REMOTE_DIR=<remote dir on ftp host> [-REMOTE_FILE=<file name under the REMOTE_DIR>] -LOCAL_DIR=<local dir> [-LOCAL_FILE=<file name under the LOCAL_DIR>][-PASSIVE_MODE=<yes|no>] -TIMEOUT=<time in seconds>] [-IDENTITY_FILE=<full path to the private key file of the user>] [-KNOWNHOSTS_FILE=<full path to known hosts file>][COMPRESSION=<yes|no>][-STRICT_HOSTKEY_CHECKING=<yes|no>][-PROXY_HOST=<proxy server host name>] [-PROXY_PORT=<proxy server port>] [-PROXY_TYPE=<HTTP|SOCKS5>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
SSHサーバーのホスト名。 |
|
|
はい |
SSHサーバーのユーザー。 |
|
|
いいえ |
SSHユーザーのパスワードまたはパスワードで保護されたアイデンティティ・ファイルのパスフレーズ。–IDENTITY_FILE引数が指定されている場合、この値はパスワードで保護された秘密鍵ファイルのパスフレーズとして使用されます。公開鍵認証に失敗した場合は、通常のユーザー・パスワード認証になります。 |
|
|
はい |
リモートFTPホスト上のディレクトリ・パス。 |
|
|
いいえ |
-REMOTE_DIR引数で指定されたディレクトリのファイル名。リモート・ファイル名と一致するサブディレクトリもすべてローカル・フォルダに転送されます。 この引数が欠落している場合は、-LOCAL_FILEファイル名を使用してファイルがコピーされます。-LOCAL_FILE引数も欠落している場合は、-LOCAL_DIRが-REMOTE_DIRに再帰的にコピーされます。 |
|
|
はい |
ローカル・マシン上のディレクトリ・パス。 |
|
|
いいえ |
-LOCAL_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_DIRにあるすべてのファイルおよびディレクトリが、-REMOTE_DIRに再帰的にコピーされます。 コピーするファイルをフィルタ処理するには、「*」を使用して汎用文字を指定します。 例:
|
|
|
いいえ |
ローカル・ユーザーの秘密鍵ファイル。この引数を指定すると、公開鍵認証が実施されます。–PASSWORD引数は、パスワードで保護された秘密鍵ファイルのパスワードとして使用されます。公開鍵認証に失敗した場合は、通常のユーザー・パスワード認証になります。 |
|
|
いいえ |
ローカル・マシンのKnown_Hostsファイルのフル・パス。Known_Hostsファイルには、ユーザーが信頼しているリモート・マシンのホスト・キーがすべて格納されます。この引数が欠落している場合は、Known_Hostsファイルとして<user home dir>/.ssh/Known_hostsファイル(存在する場合)が使用されます。 |
|
|
いいえ |
データ圧縮を使用する場合はYesに設定します。デフォルトはNoです。 |
|
|
いいえ |
この引数の値はYESまたはNOです。YES値が渡されると、厳密なホストキー・チェックが実行され、リモートSSHホスト・キーが–KNOWNHOSTS_FILEパラメータで指定された既知のホストに存在しない場合は、認証に失敗します。デフォルト値はYESです。 |
|
|
いいえ |
接続に使用されるプロキシ・サーバーのホスト名。 |
|
|
いいえ |
プロキシ・サーバーのポート番号。 |
|
|
いいえ |
接続するプロキシ・サーバーのタイプ。可能な値はHTTPまたはSOCKS5のみです。 |
|
|
いいえ |
ソケット接続がタイムアウトするまでの秒数。 |
例
SSHサーバー・マシン上のリモート・ディレクトリ/test_copy555をローカル・ディレクトリC:\temp\test_copyに再帰的にコピーします。
OdiScpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp\test_copy -REMOTE_DIR=/test_copy555
SSHサーバー・マシン上のリモート・ディレクトリ/にあるSales*.txtパターンと一致するすべてのファイルをローカル・ディレクトリC:\temp\にコピーします。
OdiScpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -REMOTE_FILE=Sales*.txt -REMOTE_DIR=/
SSHサーバー・マシン上のリモート・ディレクトリ/にあるSales1.txtファイルをローカル・ディレクトリC:\temp\にSample1.txtファイルとしてコピーします。
OdiScpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -REMOTE_DIR=/ REMOTE_FILE=Sales1.txt -LOCAL_DIR=C:\temp -LOCAL_FILE=Sample1.txt
SSHサーバー・マシン上のリモート・ディレクトリ/にあるSales1.txtファイルをローカル・ディレクトリC:\temp\にSample1.txtファイルとしてコピーします。アイデンティティ・ファイルのパスおよび既知のホスト・ファイルのパスを指定して、公開鍵認証を実施します。
OdiScpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -REMOTE_DIR=/ -REMOTE_FILE=Sales1.txt -LOCAL_DIR=C:\temp -LOCAL_FILE=Sample1.txt -IDENTITY_FILE=C:\Documents and Settings\username\.ssh\id_dsa -KNOWNHOSTS_FILE= C:\Documents and Settings\username\.ssh\Known_Hosts
SSHサーバー・マシン上のリモート・ディレクトリ/にあるSales1.txtファイルをローカル・ディレクトリC:\temp\にSample1.txtファイルとしてコピーします。アイデンティティ・ファイルのパスを指定して、公開鍵認証を実施します。STRICT_HOSTKEY_CHECKINGパラメータにNOの値を渡すことで、すべてのホストを信頼します。
OdiScpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -REMOTE_DIR=/ -REMOTE_FILE=Sales1.txt -LOCAL_DIR=C:\temp -LOCAL_FILE=Sample1.txt -IDENTITY_FILE=C:\Documents and Settings\username\.ssh\id_dsa -STRICT_HOSTKEY_CHECKING=NO
このコマンドを使用して、ファイルをSSHサーバーにアップロードします。
使用方法
OdiScpPut -HOST=<SSHserver host name> -USER=<SSH user> [-PASSWORD=<SSH user password>] -LOCAL_DIR=<local dir> [-LOCAL_FILE=<file name under the LOCAL_DIR>] -REMOTE_DIR=<remote dir on ftp host> [-REMOTE_FILE=<file name under the REMOTE_DIR>] [-PASSIVE_MODE=<yes|no>] [-TIMEOUT=<time in seconds>] [-IDENTITY_FILE=<full path to the private key file of the user>][-KNOWNHOSTS_FILE=<full path to known hosts file>][-COMPRESSION=<yes|no>][-STRICT_HOSTKEY_CHECKING=<yes|no>] <-PROXY_HOST=<proxy server host name>][-PROXY_PORT=<proxy server port>] [-PROXY_TYPE=<HTTP|SOCKS5>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
SSHサーバーのホスト名。 |
|
|
はい |
SSHサーバーのユーザー。 |
|
|
いいえ |
SSHユーザーのパスワードまたはパスワードで保護されたアイデンティティ・ファイルのパスフレーズ。–IDENTITY_FILE引数が指定されている場合、この値はパスワードで保護された秘密鍵ファイルのパスフレーズとして使用されます。公開鍵認証に失敗した場合は、通常のユーザー・パスワード認証になります。 |
|
|
はい |
リモートFTPホスト上のディレクトリ・パス。 |
|
|
いいえ |
-REMOTE_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_FILEファイル名を使用してファイルがコピーされます。-LOCAL_FILE引数も欠落している場合は、-LOCAL_DIRが-REMOTE_DIRに再帰的にコピーされます。 |
|
|
はい |
ローカル・マシン上のディレクトリ・パス。 |
|
|
いいえ |
-LOCAL_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_DIRにあるすべてのファイルおよびディレクトリが、-REMOTE_DIRに再帰的にコピーされます。 コピーするファイルをフィルタ処理するには、「*」を使用して汎用文字を指定します。 例:
|
|
|
いいえ |
ローカル・ユーザーの秘密鍵ファイル。この引数を指定すると、公開鍵認証が実施されます。–PASSWORD引数は、パスワードで保護された秘密鍵ファイルのパスワードとして使用されます。公開鍵認証に失敗した場合は、通常のユーザー・パスワード認証になります。 |
|
|
いいえ |
ローカル・マシンのKnown_Hostsファイルのフル・パス。Known_Hostsファイルには、ユーザーが信頼しているリモート・マシンのホスト・キーがすべて格納されます。この引数が欠落している場合は、Known_Hostsファイルとして<user home dir>/.ssh/Known_hostsファイル(存在する場合)が使用されます。 |
|
|
いいえ |
データ圧縮を使用する場合はYesに設定します。デフォルトはNoです。 |
|
|
いいえ |
この引数の値はYESまたはNOです。YES値が渡されると、厳密なホストキー・チェックが実行され、リモートSSHホスト・キーが–KNOWNHOSTS_FILEパラメータで指定された既知のホストに存在しない場合は、認証に失敗します。デフォルト値はYESです。 |
|
|
いいえ |
接続に使用されるプロキシ・サーバーのホスト名。 |
|
|
いいえ |
プロキシ・サーバーのポート番号。 |
|
|
いいえ |
接続するプロキシ・サーバーのタイプ。可能な値はHTTPまたはSOCKS5のみです。 |
|
|
いいえ |
ソケット接続がタイムアウトするまでの秒数。 |
例
ローカル・ディレクトリC:\temp\test_copyをFTPサーバー・マシン上のリモート・ディレクトリ/test_copy555に再帰的にコピーします。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp\test_copy -REMOTE_DIR=/test_copy555
ローカル・ディレクトリC:\temp\にあるSales*.txtパターンと一致するすべてのファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にコピーします。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales*.txt -REMOTE_DIR=/
ローカル・ディレクトリC:\temp\にあるSales1.txtファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にSample1.txtファイルとしてコピーします。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales1.txt -REMOTE_DIR=/ -REMOTE_FILE=Sample1.txt
ローカル・ディレクトリC:\temp\にあるSales1.txtファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にSample1.txtファイルとしてコピーします。アイデンティティ・ファイルのパスおよび既知のホスト・ファイルのパスを指定して、公開鍵認証を実施します。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales1.txt -REMOTE_DIR=/ -REMOTE_FILE=Sample1.txt -IDENTITY_FILE=C:\Documents and Settings\username\.ssh\id_dsa -KNOWNHOSTS_FILE= C:\Documents and Settings\username\.ssh\Known_Hosts
ローカル・ディレクトリC:\temp\にあるSales1.txtファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にSample1.txtファイルとしてコピーします。アイデンティティ・ファイルのパスを指定して、公開鍵認証を実施します。STRICT_HOSTKEY_CHECKINGパラメータにNOの値を渡すことで、すべてのホストを信頼します。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales1.txt -REMOTE_DIR=/ -REMOTE_FILE=Sample1.txt -IDENTITY_FILE=C:\Documents and Settings\username\.ssh\id_dsa -STRICT_HOSTKEY_CHECKING=NO
このコマンドを使用して、電子メールをSMTPサーバーに送信します。
使用方法
OdiSendMail -MAILHOST=<mail_host> -FROM=<from_user> -TO=<address_list> [-CC=<address_list>] [-BCC=<address_list>] [-SUBJECT=<subject>] [-ATTACH=<file_path>]* [-MSGBODY=<message_body> | CR/LF<message_body>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
SMTPサーバーのIPアドレス。 |
|
|
はい |
メッセージの送信者のアドレス。 例: support@mycompany.com 送信者の外部名を送信するには、次の表記法を使用できます。 "-FROM=Support center <support@mycompany.com>" |
|
|
はい |
受信者の電子メール・アドレス・リスト(カンマ区切り)。 例: "-TO=sales@mycompany.com, support@mycompany.com" |
|
|
いいえ |
コピー(CC)受信者の電子メール・アドレス・リスト(カンマ区切り)。 例: -CC=info@mycompany.com |
|
|
いいえ |
コピー(BCC)受信者の電子メール・アドレス・リスト(カンマ区切り)。 例: -BCC=manager@mycompany.com |
|
|
いいえ |
メッセージの目的(件名)。 |
|
|
いいえ |
メッセージに結合するファイルの実行エージェントに対する相対パス。複数のファイルを結合するには、-ATTACH=...を繰り返す必要があります。 例: ファイル.profileおよび.cshrcをメールに添付する場合は、次のようにします。 -ATTACH=/home/usr/.profile -ATTACH=/home/usr/.cshrc |
|
または |
いいえ |
メッセージ本文(テキスト)。このテキストは、OdiSendMailコマンドの次の行(改行の |
例
OdiSendMail -MAILHOST=mail.mymail.com "-FROM=Application Oracle Data Integrator<odi@mymail.com>" -TO=admin@mymail.com "-SUBJECT=Execution OK" -ATTACH=C:\log\job.log -ATTACH=C:\log\job.bad Hello Administrator ! Your process finished successfully. Attached are your files. Have a nice day! Oracle Data Integrator.
このコマンドを使用して、SFTPサブシステムが有効なSSHサーバーからファイルをダウンロードします。
使用方法
OdiSftpGet -HOST=<ssh server host name> -USER=<ssh user> [-PASSWORD=<ssh user password>] -REMOTE_DIR=<remote dir on ftp host> [-REMOTE_FILE=<file name under the REMOTE_DIR>] -LOCAL_DIR=<local dir> [-LOCAL_FILE=<file name under the LOCAL_DIR>] [-PASSIVE_MODE=<yes|no>] [-TIMEOUT=<time in seconds>] [-IDENTITY_FILE=<full path to the private key file of the user>] [-KNOWNHOSTS_FILE=<full path to known hosts file>][COMPRESSION=<yes|no>][-STRICT_HOSTKEY_CHECKING=<yes|no>][-PROXY_HOST=<proxy server host name>][-PROXY_PORT=<proxy server port>] [-PROXY_TYPE=<HTTP| SOCKS5>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
SSHサーバーのホスト名。 コロン( ポートが指定されていない場合、デフォルトでポート22が使用されます。 |
|
|
はい |
SSHサーバーのユーザー。 |
|
|
いいえ |
SSHユーザーのパスワード。 |
|
|
はい |
リモートSSHホスト上のディレクトリ・パス。 |
|
|
いいえ |
-REMOTE_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_FILEファイル名を使用してファイルがコピーされます。-LOCAL_FILE引数も欠落している場合は、-LOCAL_DIRが-REMOTE_DIRに再帰的にコピーされます。 |
|
|
はい |
ローカル・マシン上のディレクトリ・パス。 |
|
|
いいえ |
-LOCAL_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_DIRにあるすべてのファイルおよびディレクトリが、-REMOTE_DIRに再帰的にコピーされます。 コピーするファイルをフィルタ処理するには、「*」を使用して汎用文字を指定します。 例:
|
|
|
いいえ |
ローカル・ユーザーの秘密鍵ファイル。この引数を指定すると、公開鍵認証が実施されます。–PASSWORD引数は、パスワードで保護された秘密鍵ファイルのパスワードとして使用されます。公開鍵認証に失敗した場合は、通常のユーザー・パスワード認証になります。 |
|
|
いいえ |
ローカル・マシンのKnown_Hostsファイルのフル・パス。Known_Hostsファイルには、ユーザーが信頼しているリモート・マシンのホスト・キーがすべて格納されます。この引数が欠落している場合は、Known_Hostsファイルとして<user home dir>/.ssh/Known_hostsファイル(存在する場合)が使用されます。 |
|
|
いいえ |
データ圧縮を使用する場合はYesに設定します。デフォルトはNoです。 |
|
|
いいえ |
この引数の値はYESまたはNOです。YES値が渡されると、厳密なホストキー・チェックが実行され、リモートSSHホスト・キーが–KNOWNHOSTS_FILEパラメータで指定された既知のホストに存在しない場合は、認証に失敗します。デフォルト値はYESです。 |
|
|
いいえ |
接続に使用されるプロキシ・サーバーのホスト名。 |
|
|
いいえ |
プロキシ・サーバーのポート番号。 |
|
|
いいえ |
接続するプロキシ・サーバーのタイプ。可能な値はHTTPまたはSOCKS5のみです。 |
|
|
いいえ |
ソケット接続がタイムアウトするまでの秒数。 |
例
SSHサーバー・マシン上のリモート・ディレクトリ/test_copy555をローカル・ディレクトリC:\temp\test_copyに再帰的にコピーします。
OdiSftpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp\test_copy -REMOTE_DIR=/test_copy555
SSHサーバー・マシン上のリモート・ディレクトリ/にあるSales*.txtパターンと一致するすべてのファイルをローカル・ディレクトリC:\temp\にコピーします。
OdiSftpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -REMOTE_FILE=Sales*.txt -REMOTE_DIR=/
SSHサーバー・マシン上のリモート・ディレクトリ/にあるSales1.txtファイルをローカル・ディレクトリC:\temp\にSample1.txtファイルとしてコピーします。
OdiSftpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -REMOTE_DIR=/ -LOCAL_FILE=Sales1.txt -LOCAL_DIR=C:\temp -LOCAL_FILE=Sample1.txt
SSHサーバー・マシン上のリモート・ディレクトリ/にあるSales1.txtファイルをローカル・ディレクトリC:\temp\にSample1.txtファイルとしてコピーします。アイデンティティ・ファイルのパスおよび既知のホスト・ファイルのパスを指定して、公開鍵認証を実施します。
OdiSftpGet -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -REMOTE_DIR=/ -REMOTE_FILE=Sales1.txt -LOCAL_DIR=C:\temp -LOCAL_FILE=Sample1.txt -IDENTITY_FILE=C:\Documents and Settings\username\.ssh\id_dsa -KNOWNHOSTS_FILE= C:\Documents and Settings\username\.ssh\Known_Hosts
SSHサーバー・マシン上のリモート・ディレクトリ/にあるSales1.txtファイルをローカル・ディレクトリC:\temp\にSample1.txtファイルとしてコピーします。アイデンティティ・ファイルのパスを指定して、公開鍵認証を実施します。STRICT_HOSTKEY_CHECKINGパラメータにNOの値を渡すことで、すべてのホストを信頼します。
OdiSftpGet -HOST=dev3 -USER=test_ftp -PASSWORD=<password> -REMOTE_DIR=/ -REMOTE_FILE=Sales1.txt -LOCAL_DIR=C:\temp -LOCAL_FILE=Sample1.txt -IDENTITY_FILE=C:\Documents and Settings\username\.ssh\id_dsa -STRICT_HOSTKEY_CHECKING=NO
このコマンドを使用して、SFTPサブシステムが有効なSSHサーバーにファイルをアップロードします。
使用方法
OdiSftpPut -HOST=<ftp server host name> -USER=<ftp user> [-PASSWORD=<ftp user password>] -LOCAL_DIR=<local dir> [-LOCAL_FILE=<file name under the LOCAL_DIR>] -REMOTE_DIR=<remote dir on ftp host> [-REMOTE_FILE=<file name under the REMOTE_DIR>] [-PASSIVE_MODE=<yes | no>][-TIMEOUT=<time in seconds>] [-IDENTITY_FILE=<full path to the private key file of the user>] [-KNOWNHOSTS_FILE=<full path to known hosts file>][COMPRESSION=<yes|no>][-STRICT_HOSTKEY_CHECKING=<YES | NO>][-PROXY_HOST=<proxy server host name>][-PROXY_PORT=<proxy server port>][-PROXY_TYPE=<HTTP | SOCKS5>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
SSHサーバーのホスト名。 コロン( ポートが指定されていない場合、デフォルトでポート22が使用されます。 |
|
|
はい |
SSHサーバーのユーザー。 |
|
|
いいえ |
SSHユーザーのパスワードまたはパスワードで保護されたアイデンティティ・ファイルのパスフレーズ。–IDENTITY_FILE引数が指定されている場合、この値はパスワードで保護された秘密鍵ファイルのパスフレーズとして使用されます。公開鍵認証に失敗した場合は、通常のユーザー・パスワード認証になります。 |
|
|
はい |
リモートFTPホスト上のディレクトリ・パス。 |
|
|
いいえ |
-REMOTE_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_FILEファイル名を使用してファイルがコピーされます。-LOCAL_FILE引数も欠落している場合は、-LOCAL_DIRが-REMOTE_DIRに再帰的にコピーされます。 |
|
|
はい |
ローカル・マシン上のディレクトリ・パス。 |
|
|
いいえ |
-LOCAL_DIR引数で指定されたディレクトリのファイル名。この引数が欠落している場合は、-LOCAL_DIRにあるすべてのファイルおよびディレクトリが、-REMOTE_DIRに再帰的にコピーされます。 コピーするファイルをフィルタ処理するには、「*」を使用して汎用文字を指定します。 例:
|
|
|
いいえ |
ローカル・ユーザーの秘密鍵ファイル。この引数を指定すると、公開鍵認証が実施されます。–PASSWORD引数は、パスワードで保護された秘密鍵ファイルのパスワードとして使用されます。公開鍵認証に失敗した場合は、通常のユーザー・パスワード認証になります。 |
|
|
いいえ |
ローカル・マシンのKnown_Hostsファイルのフル・パス。Known_Hostsファイルには、ユーザーが信頼しているリモート・マシンのホスト・キーがすべて格納されます。この引数が欠落している場合は、Known_Hostsファイルとして<user home dir>/.ssh/Known_hostsファイル(存在する場合)が使用されます。 |
|
|
いいえ |
データ圧縮を使用する場合はYesに設定します。デフォルトはNoです。 |
|
|
いいえ |
この引数の値はYESまたはNOです。YES値が渡されると、厳密なホストキー・チェックが実行され、リモートSSHホスト・キーが–KNOWNHOSTS_FILEパラメータで指定された既知のホストに存在しない場合は、認証に失敗します。デフォルト値はYESです。 |
|
|
いいえ |
接続に使用されるプロキシ・サーバーのホスト名。 |
|
|
いいえ |
プロキシ・サーバーのポート番号。 |
|
|
いいえ |
接続するプロキシ・サーバーのタイプ。可能な値はHTTPまたはSOCKS5のみです。 |
|
|
いいえ |
ソケット接続がタイムアウトするまでの秒数。 |
例
ローカル・ディレクトリC:\temp\test_copyをFTPサーバー・マシン上のリモート・ディレクトリ/test_copy555に再帰的にコピーします。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp\test_copy -REMOTE_DIR=/test_copy555
ローカル・ディレクトリC:\temp\にあるSales*.txtパターンと一致するすべてのファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にコピーします。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales*.txt -REMOTE_DIR=/
ローカル・ディレクトリC:\temp\にあるSales1.txtファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にSample1.txtファイルとしてコピーします。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales1.txt -REMOTE_DIR=/Sample1.txt
ローカル・ディレクトリC:\temp\にあるSales1.txtファイルをFTPサーバー・マシン上のリモート・ディレクトリ/にSample1.txtファイルとしてコピーします。アイデンティティ・ファイルのパスおよび既知のホスト・ファイルのパスを指定して、公開鍵認証を実施します。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales1.txt -REMOTE_DIR=/Sample1.txt -IDENTITY_FILE=C:\Documents and Settings\username\.ssh\id_dsa -KNOWNHOSTS_FILE= C:\Documents and Settings\username\.ssh\Known_Hosts
ローカル・ディレクトリC:\temp\にあるSales1.txtファイルを、FTPサーバー・マシン上のリモート・ディレクトリ/にSample1.txtファイルとしてコピーします。アイデンティティ・ファイルのパスを指定して、公開鍵認証を実施します。STRICT_HOSTKEY_CHECKINGパラメータにNOの値を渡すことで、すべてのホストを信頼します。
OdiSftpPut -HOST=machine.oracle.com -USER=test_ftp -PASSWORD=<password> -LOCAL_DIR=C:\temp -LOCAL_FILE=Sales1.txt -REMOTE_DIR=/Sample1.txt -IDENTITY_FILE=C:\Documents and Settings\username\.ssh\id_dsa -STRICT_HOSTKEY_CHECKING=NO
このコマンドを使用して、<delay>ミリ秒間待機します。
使用方法
OdiSleep -DELAY=<delay>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
待機するミリ秒数。 |
例
OdiSleep -DELAY=5000
このコマンドを使用して、SQL問合せの結果をファイルに書き込みます。
このコマンドは、接続パラメータが<driver>、<url>、<user>および<encoded_pass>によって指定されたデータ・サーバーに対してSQL問合せ<sql_query>を実行します。その結果セットは<file_name>に書き込まれます。
使用方法
OdiSqlUnload -FILE=<file_name> -DRIVER=<driver> -URL=<url> -USER=<user> -PASS=<password> [-FILE_FORMAT=<file_format>] [-FIELD_SEP=<field_sep> | -XFIELD_SEP=<field_sep>] [-ROW_SEP=<row_sep> | -XROW_SEP=<row_sep>] [-DATE_FORMAT=<date_format>][-CHARSET_ENCODING=<encoding>] [-XML_CHARSET_ENCODING=<encoding>][-FETCH_SIZE=<array_fetch_size>] ( CR/LF <sql_query> | -QUERY=<sql_query> | -QUERY_FILE=<sql_query_file> )
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
実行エージェントに対して相対的な出力ファイルへのフル・パス |
|
|
はい |
データ・サーバーへの接続に使用するJDBCドライバの名前。 |
|
|
はい |
データ・サーバーへのJDBC URL。 |
|
|
はい |
SQL問合せの実行に使用されるデータ・サーバー上のユーザーのログイン。 |
|
|
はい |
データ・サーバーにログインするための暗号化されたパスワード。このパスワードは、システム・コマンド エージェント(.batまたは.sh)は、Oracle Data Integratorインスール・ディレクトリの |
|
|
いいえ |
次の3種類のいずれかのファイル形式を指定します。
<file_format>の指定を省略すると、形式はvariable.にデフォルト設定されます。 <file_format>がxmlの場合は、次の構造のXMLノードが生成されます。
...
....
|
|
|
いいえ |
FILE_FORMAT=variableの場合のASCII形式のフィールド・セパレータ文字。デフォルトの<field_sep>はタブ文字です。 |
|
|
いいえ |
FILE_FORMAT=variableの場合の16進形式のフィールド・セパレータ文字。デフォルトの<field_sep>はタブ文字です。 |
|
|
いいえ |
ASCII形式のレコード・セパレータ文字。デフォルトの<row_sep>はWindowsの改行です。たとえば、次の値を使用できます。
|
|
|
いいえ |
16進形式のレコード・セパレータ文字。例: 0A。 |
|
|
いいえ |
日付データ型に使用する出力書式。この日付書式はJavaの日時書式パターンを使用して指定されます。これらのパターンのリストは、 |
|
|
いいえ |
ターゲット・ファイルのエンコーディング。デフォルト値は
|
|
|
いいえ |
XMLファイル内に
|
|
|
いいえ |
データ・サーバーとの通信ごとに、Data Integratorによってリクエストされる(レコードの読取り)行数。 |
|
|
はい |
データ・サーバーに対して実行するSQL問合せ。問合せは、有効なレコードセットを戻す
|
例
次のコマンドは、Customers表での問合せの結果が格納されているカンマ区切りのC:\temp\clients.csvファイルを生成します。
OdiSqlUnload -FILE=C:\temp\clients.csv -DRIVER=sun.jdbc.odbc.JdbcOdbcDriver -URL=jdbc:odbc:NORTHWIND_ODBC -USER=sa -PASS=NFNEKKNGGJHAHBHDHEHJDBGBGFDGGH -FIELD_SEP=; "-DATE_FORMAT=dd/MM/yyyy hh:mm:ss" select cust_id, cust_name, cust_creation_date from Northwind.dbo.Customers
このコマンドを使用して、ロード計画を開始します。
使用方法
OdiStartLoadPlan -LOAD_PLAN_NAME=<load_plan_name> [-LOG_LEVEL=<log_level>] [-CONTEXT=<context_code>] [-AGENT_URL=<agent_url>] [-AGENT_CODE=<logical_agent_code>] [-ODI_USER=<ODI User>] [-ODI_PASS=<ODI Password>] [-KEYWORDS=<Keywords>] [-<PROJECT_CODE>.<VARIABLE>=<var_value> ...]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
開始するロード計画の名前。 |
|
|
いいえ |
保持するロギング情報のレベル。この値以下のログ・レベルが定義されているすべてのセッションは、セッション完了時に、セッション・ログに保持されます。ただし、オブジェクトの実行が異常終了した場合は、この設定にかかわらず、すべてのタスクが保持されます。 ログ・レベル6は、ログ・レベル5と動作は同じですが、変数と順序の追跡が追加されていることに注意してください。詳細は、12.2.3.11項「変数と順序の追跡」を参照してください。 |
|
|
はい |
実行コンテキストのコード。このパラメータを省略すると、コール元セッションの実行コンテキストで、ロード計画が開始されます(ある場合)。 |
|
|
いいえ |
ロード計画を開始するリモート・エージェントのURL。 |
|
|
いいえ |
このロード計画の開始を担当する論理エージェントのコード。このパラメータと-AGENT_URLを省略すると、現在のエージェントがこのロード計画を開始します。エージェントURLが指定されている場合、無視されます。 |
|
|
いいえ |
ロード計画の開始に使用するOracle Data Integratorユーザー。このユーザーの権限が使用されます。このパラメータを省略すると、ロード計画は、親セッションを起動したユーザーの権限を使用して開始されます。 |
|
|
いいえ |
Oracle Data Integratorユーザーのパスワード。このパスワードはエンコードされている必要があります。-ODI_USERを指定した場合、このパラメータは必須です。 |
|
|
いいえ |
このロード計画に関連付けられているキーワードのリスト。これらのキーワードによって、ロード計画実行の識別が容易になります。このリストは、カンマ区切りのキーワード・リストです。 |
|
|
いいえ |
値がロード計画の実行に対するデフォルトとして設定されているプロジェクト変数またはグローバル変数のリスト。プロジェクト変数は<project_code>.<variable_name>、グローバル変数はGLOBAL.<variable_name>で指定します。このリストは、-<variable>=<value>という形式です。 |
例
同じエージェントのグローバル・コンテキストでロード計画LOAD_DWHを開始します:
OdiStartLoadPlan -LOAD_PLAN_NAME=LOAD_DWH -CONTEXT=GLOBAL
このコマンドを使用して、シナリオを開始します。
オプションのAGENT_CODEパラメータは、このシナリオを現在のエージェント以外の別のエージェントに適用する場合に使用します。
SYNC_MODEパラメータを使用すると、同期モードまたは非同期モードでシナリオを開始できます。
|
注意: 開始するシナリオは、コマンドが起動されるリポジトリに存在している必要があります。シナリオを本番に移行する場合は、このコマンドを使用して、コールされるシナリオをすべて取り込みます。ソリューションは、この目的でシナリオをグループ化するのに役立ちます。 |
使用方法
OdiStartScen -SCEN_NAME=<scenario> -SCEN_VERSION=<version> [-CONTEXT=<context>] [-ODI_USER=<odi user> -ODI_PASS=<odi password>] [-SESSION_NAME=<session_name>] [-LOG_LEVEL=<log_level>] [-AGENT_CODE=<logical_agent_name>] [-SYNC_MODE=<1|2>] [-KEYWORDS=<keywords>] [-<VARIABLE>=<value>]*
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
開始するシナリオの名前。 |
|
|
はい |
開始するシナリオのバージョン。 |
|
|
いいえ |
実行コンテキストのコード。このパラメータを省略すると、コール元セッションの実行コンテキストで、シナリオが実行されます。 |
|
|
いいえ |
シナリオの実行に使用するOracle Data Integratorユーザー。このユーザーの権限が使用されます。このパラメータを省略すると、シナリオは、親セッションを起動したユーザーの権限を使用して実行されます。 |
|
|
いいえ |
Oracle Data Integratorユーザーのパスワード。このパスワードはエンコードされている必要があります。ユーザーを指定した場合、このパラメータは必須です。 |
|
|
いいえ |
実行ログに表示するセッションの名前。 |
|
|
いいえ |
実行ログに保持するトレース・レベル(0から5)。デフォルト値は5。 |
|
|
いいえ |
このシナリオの実行を担当する論理エージェントの名前。このパラメータを省略すると、現在のエージェントがこのシナリオを実行します。 |
|
|
いいえ |
シナリオの同期モード。
|
|
|
いいえ |
このセッションに関連付けられているキーワードのリスト。これらのキーワードによって、セッションの識別が容易になります。このリストは、カンマ区切りのキーワード・リストです。 |
|
|
いいえ |
シナリオの実行時に値が設定される変数のリスト。このリストは「PROJECT.VARIABLE=値」または「GLOBAL.VARIABLE=値」の形式で指定します。 |
例
本番コンテキストでシナリオLOAD_DWHのバージョン2を開始します(同期モード)。
OdiStartScen -SCEN_NAME=LOAD_DWH -SCEN_VERSION=2 -CONTEXT=CTX_PRODUCTION
エージェント「UNIX Agent」が現在のコンテキストでシナリオLOAD_DWHのバージョン2を非同期モードで開始します。その際は、START_DATE (ローカル)変数とCOMPANY_CODE (グローバル)変数の値を渡します。
OdiStartScen -SCEN_NAME=LOAD_DWH -SCEN_VERSION=2 -SYNC_MODE=2 "-AGENT_CODE=UNIX Agent" -MY_PROJECT.START_DATE=10-APR-2002 -GLOBAL.COMPANY_CODE=SP4356
このコマンドを使用して、アーカイブ・ファイルをディレクトリに解凍します。
使用方法
OdiUnZip -FILE=<file> -TODIR=<target_directory> [-OVERWRITE=<yes|no>] [-ENCODING=<file_name_encoding>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
解凍するZIPファイルへのフル・パス。 |
|
|
はい |
宛先ディレクトリまたはフォルダ。 |
|
|
いいえ |
解凍先ディレクトリにファイルがすでに存在している場合に、上書きするかどうかを示します。デフォルトはNoです。 |
|
|
いいえ |
アーカイブ・ファイル内部でファイル名に使用される文字エンコーディング。可能な値のリストは、次を参照してください:
デフォルトは、プラットフォームのデフォルトの文字エンコーディングです。 |
例
C:\archive\ディレクトリのarchive_001.zipファイルをC:\TEMPディレクトリに解凍します。
OdiUnZip "-FILE=C:\archive\archive_001.zip" -TODIR=C:\TEMP\
このコマンドを使用して、エージェントがタスクのスケジュールを強制的に再計算するようにします。
使用方法
OdiUpdateAgentSchedule -AGENT_NAME=<physical_agent_name>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
更新する物理エージェントの名前。 |
例
この例では、agt_s1という名前の物理エージェントがスケジュールを更新します。
OdiUpdateAgentSchedule -AGENT_NAME=agt_s1
このコマンドを使用して、現在のセッションの(OdiStartScenツールを使用して開始された)子セッションが完了するまで待機します。
このコマンドは、<parent_sess_number>で指定したセッションから起動されたセッションの終了を<polling_interval>秒間隔でチェックします。これらのすべての子セッション(場合によっては名前やキーワードでフィルタ処理される)が終了すると(ステータスは完了、警告またはエラー)、このコマンドは終了します。
使用方法
OdiWaitForChildSession [-PARENT_SESS_NO=<parent_sess_number>] [-POLL_INT=<polling_interval>] [-SESSION_NAME_FILTER=<session_name_filter>] [-SESSION_KEYWORDS=<session_keywords>] [-MAX_CHILD_ERROR=ALL|<error_number>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
いいえ |
親セッションのID。このパラメータの指定を省略すると、現在のセッションIDが使用されます。 |
|
|
いいえ |
一連の子セッションの各終了テストの間隔(秒単位)。デフォルトは1です。 |
|
|
いいえ |
名前がこのフィルタと一致する子セッションのみがテストされます。このフィルタには、SQL LIKE形式のパターンを使用できます。 |
|
|
いいえ |
このカンマ区切りリストのすべてのキーワードと一致する子セッションのみがテストされます。リストの各要素には、SQL LIKE形式のパターンを使用できます。 |
|
|
いいえ |
このパラメータを使用すると、特定の数の子セッションがエラーで終了した場合に、OdiWaitForChildSessionを終了できます。
このパラメータがゼロ、負数または未指定の場合、OdiWaitForChildSessionは、障害が発生した子セッションの数に関係なく、エラー・ステータスで終了することはありません。 |
例
5秒のポーリング間隔で、現在のセッションの子セッションの中で、名前が「LOADxxx」に類似し、「MANDATORY」と「CRITICAL」のキーワードがある子セッションすべての終了を待機します。
OdiWaitForChildSession -PARENT_SESS_NO=<%=odiRef.getSession("SESS_NO")%>
-POLL_INT=5 -SESSION_NAME_FILTER=LOAD%
-SESSION_KEYWORDS=MANDATORY,CRITICAL
このコマンドを使用して、表または一連の表について特定の数の行を待機します。このコマンドは、データが格納されている特定の数のオブジェクト(ビューなど)にも適用できます。
OdiWaitForDataコマンドは、表または一連の表に特定の数のレコードが移入されているかどうかをテストします。このテストは、いずれかの表で目的の数の行(-UNIT_ROWCOUNT)が検出されるか、すべての表を対象として累積で目的の数の行(-GLOBAL_ROWCOUNT)が検出されるか、またはタイムアウト(-TIMEOUT)に到達するかの、いずれかの条件が満たされるまで一定の間隔で(-POLLINT)繰り返されます。
検出された一連の行には、フィルタを適用できます。フィルタは、明示的なSQL where句(-SQLFILTER)、またはフィールド値と演算句を決定する-RESUME_KEY_xxxパラメータ(あるいはその両方)で指定されます。この2つの方法は累積(AND)されます。
行数は、絶対条件(表内の合計行数に対する)または差分条件(格納された参照値と現在の行数値の差異)のいずれかで判断できます。
複数の表を扱う場合は、次のようになります。
-SQLFILTERパラメータと-RESUME_KEY_xxxパラメータは、関係するすべての表に適用されます。
-UNIT_ROWCOUNTパラメータは、特定の表の個々について想定される行数を判断します。-GLOBAL_ROWCOUNTパラメータは、一連の表全体で累積された行数の合計を判断します。関係している表が1つのみの場合、-UNIT_ROWCOUNTパラメータと-GLOBAL_ROWCOUNTパラメータは同等です。
使用方法
OdiWaitForData -LSCHEMA=<logical_schema> -TABLE_NAME=<table_name> [-OBJECT_TYPE=<list of object types>] [-CONTEXT=<context>] [-RESUME_KEY_VARIABLE=<resumeKeyVariable> -RESUME_KEY_COL=<resumeKeyCol> [-RESUME_KEY_OPERATOR=<resumeKeyOperator>]|-SQLFILTER=<SQLFilter>] [-TIMEOUT=<timeout>] [-POLLINT=<pollInt>] [-GLOBAL_ROWCOUNT=<globalRowCount>] [-UNIT_ROWCOUNT=<unitRowCount>] [-TIMEOUT_WITH_ROWS_OK=<yes|no>] [-INCREMENT_DETECTION=<no|yes> [-INCREMENT_MODE=<M|P|I>] [-INCREMENT_SEQUENCE_NAME=<incrementSequenceName>]]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
表が格納されている論理スキーマ。 |
|
|
はい |
チェックする表の名前、マスクまたは表名のリスト。このパラメータでは3つの書式を使用できます。
|
|
|
いいえ |
チェックするオブジェクトのタイプ。デフォルトでは、表のみがチェックされます。他のオブジェクトをチェック対象とするには、オブジェクト・タイプのカンマ区切りリストを指定します。次のオブジェクト・タイプがサポートされています。
|
|
|
いいえ |
論理スキーマを解決するコンテキスト。コンテキストの指定を省略すると、実行コンテキストが使用されます。 |
|
|
いいえ |
表に適用する明示的なSQLフィルタ。この文は、チェックされた表を格納しているテクノロジで有効な文である必要があります。 この文にはWHEREキーワードを使用できません。 |
|
|
いいえ |
|
|
|
いいえ |
データをポーリングする最大期間(ミリ秒単位)。この値がゼロの場合、タイムアウトは無限です。デフォルトは0です。 |
|
|
いいえ |
データの各ポーリング間で待機する期間(ミリ秒単位)。デフォルト1000です。 |
|
|
いいえ |
コマンドを終了するためにポーリング対象の表で必要とされる行数。デフォルトは1です。 |
|
|
いいえ |
コマンドを終了するために一連の表全体で累積的に必要とされる合計行数。指定しないと、デフォルト値の 1 が使用されます。 |
|
|
いいえ |
コマンドで行数が考慮されるモードを、絶対条件(表内の合計行数に対する)または差分条件(格納された参照値と現在の行数値の差異)のいずれかで定義します。
デフォルトは |
|
|
いいえ |
このパラメータは、連続するOdiWaitForDataコール間の参照値の永続性モードを指定します。 可能な値は次のとおりです。
デフォルトは マスクまたは表のリストがポーリングされた場合、永続または初期モードの使用はサポートされません。 |
|
|
いいえ |
このパラメータは、参照値の永続性のために使用する自動的に割り当てられた記憶領域の名前を指定します。この増分順序はリポジトリに格納されます。この名前の指定を省略すると、表の名前が使用されます。 この増分順序はOracle Data Integratorの順序ではありません。OdiWaitForDataへのコールの外部では順序として使用できません。 |
|
|
いいえ |
このパラメータが |
例
ORA_WAITFORDATAスキーマのDE1P1表に、フィルタと一致するレコードが200件格納されるまで待機します。
OdiWaitForData -LSCHEMA=ORA_WAITFORDATA -TABLE_NAME=DE1P1
-GLOBAL_ROWCOUNT=200 "-SQLFILTER=DATMAJ >
to_date('#MAX_DE1_DATMAJ_ORACLE_CHAR', 'DD/MM/YYYY HH24:MI:SS')"
SQLSRV_SALESのCITY_SRC表またはCITY_TRG表に新しいデータが表示されるまで最大4時間待機します。
OdiWaitForData LSCHEMA=SQLSRV_SALES TABLE_NAME=CITY% -TIMEOUT=14400000 -INCREMENT_DETECTION=yes
このコマンドを使用して、ジャーナル化された表またはそのリストで、変更が特定の件数に達するまで待機します。
OdiWaitForLogDataコマンドは、表または表のグループで行が変更されたかどうかを判断します。この変更は、Oracle Data Integratorのチェンジ・データ・キャプチャ(CDC)を簡易モード(-TABLE_NAMEパラメータを使用)または一貫性モード(-CDC_SET_NAMEパラメータを使用)で使用して検出されます。テストは、いずれかの表で目的の数(-UNIT_ROWCOUNT)の行変更が検出されるか、すべての表を対象として累積で目的の数(-GLOBAL_ROWCOUNT)の行変更が検出されるか、またはタイムアウト(-TIMEOUT)に到達するかの、いずれかの条件が満たされるまで、-POLLINTミリ秒間隔で繰り返されます。
|
注意: このコマンドでは、ジャーナル化されたすべての操作(挿入、更新および削除)が考慮されます。 このコマンドは、簡易モードまたは一貫性モードでジャーナル化された表にのみ適しています。 |
使用方法
OdiWaitForLogData -LSCHEMA=<logical_schema> -SUBSCRIBER_NAME=<subscriber_name> (-TABLE_NAME=<table_name> | -CDC_SET_NAME=<cdcSetName>) [-CONTEXT=<context>] [-TIMEOUT=<timeout>] [-POLLINT=<pollInt>] [-GLOBAL_ROWCOUNT=<globalRowCount>] [-UNIT_ROWCOUNT=<unitRowCount> [-OPTIMIZED_WAIT=<yes|no|AUTO>] [-TIMEOUT_WITH_ROWS_OK=<yes|no>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
いいえ |
論理スキーマを解決するコンテキスト(コンテキスト・コード)。コンテキストの指定を省略すると、実行コンテキストが使用されます。 |
|
|
いいえ |
コマンドを終了するために、表またはCDCセットで必要とされる変更の合計数。デフォルトは1です。 |
|
|
はい |
ジャーナル化された表が格納されている論理スキーマ。 |
|
|
いいえ |
ジャーナルへのアクセスに使用する方法。
デフォルトは |
|
|
いいえ |
各ポーリング間で待機する期間(ミリ秒単位)。デフォルト2000です。 |
|
|
はい |
ジャーナル化情報の取得に使用するサブスクライバの名前。 |
|
|
はい |
チェックするジャーナル化表の名前、マスクまたはリスト。このパラメータでは3つの書式を使用できます。
このオプションは簡易モードでジャーナル化されたモデルの表でのみ機能します。 このパラメータは |
|
|
はい |
チェックするCDCセットの名前。このCDCセット名は完全修飾のモデル・コードで、通常は
このオプションは一貫性モードでジャーナル化されたモデルの表でのみ機能します。 このパラメータは |
|
|
いいえ |
変更をポーリングする最大期間(ミリ秒単位)。この値がゼロの場合、タイムアウトは無限です。デフォルトは0です。 |
|
|
いいえ |
このパラメータがyesに設定されている場合に、少なくとも1行が検出され、事前定義の行数がポーリングされる前にタイムアウトが発生すると、リターン・コード0でAPIが終了します。それ以外の場合はエラーが発生します。デフォルトは |
|
|
いいえ |
コマンドを終了するためにポーリングされる表のいずれかで必要とされる変更の数。デフォルトは1です。
|
例
SALES_APPLICATIONスキーマのCUSTOMERS表で、SALES_SYNCサブスクライバについて記録されている行の変更が200になるまで待機します。
OdiWaitForLogData -LSCHEMA=SALES_APPLICATION -TABLE_NAME=CUSTOMERS -GLOBAL_ROWCOUNT=200 -SUBSCRIBER_NAME=SALES_SYNC
このコマンドを使用して、表が作成されて事前定義の行数が移入されるまで待機します。
OdiWaitForTableコマンドは、指定の表が作成され、その表に特定の数のレコードが移入されたかどうかを定期的にテストします。このテストは、表が存在して目的の数の行(-GLOBAL_ROWCOUNT)が格納されるか、タイムアウト(-TIMEOUT)に到達するかの、いずれかの条件が満たされるまで-POLLINTミリ秒間隔で繰り返されます。
使用方法
OdiWaitForTable -CONTEXT=<context> -LSCHEMA=<logical_schema> -TABLE_NAME=<table_name> [-TIMEOUT=<timeout>] [-POLLINT=<pollInt>] [-GLOBAL_ROWCOUNT=<globalRowCount>] [-TIMEOUT_WITH_ROWS_OK=<yes|no>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
いいえ |
論理スキーマを解決するコンテキスト。コンテキストの指定を省略すると、実行コンテキストが使用されます。 |
|
|
いいえ |
コマンドを終了するために表に必要とされる合計行数。デフォルトは1です。未指定の場合、表に新規行が挿入されたときにコマンドは終了します。 |
|
|
はい |
表を検索する論理スキーマ。 |
|
|
いいえ |
各テスト間で待機する期間(ミリ秒単位)。デフォルト1000です。 |
|
|
はい |
検索する表の名前。 |
|
|
いいえ |
表を検索する最大期間(ミリ秒単位)。この値がゼロの場合、タイムアウトは無限です。デフォルトは0です。 |
|
|
いいえ |
このパラメータが |
例
ORA_WAITFORDATAスキーマのDE1P1表に、少なくとも1件のレコードが格納されるまで待機します。
OdiWaitForTable -LSCHEMA=ORA_WAITFORDATA -TABLE_NAME=DE1P1 -GLOBAL_ROWCOUNT=1
このコマンドを使用して、複数のXMLファイルから単一のファイルに要素を連結します。
このツールは、一連のソースXMLファイルから指定要素のインスタンスをすべて抽出し、単一のターゲットXMLファイルに連結します。このツールは、適格なXMLを解析して生成します。生成されたファイルに対するDTDの変更または生成は処理しません。既存のDTDへの参照は、HEADERパラメータで指定するか、-KEEP_XML_PROLOGUEを使用して元のファイルから保持できます。
|
注意: このツールでは、XMLネームスペースはサポートされません。 |
使用方法
OdiXMLConcat -FILE=<file_filter> -TOFILE=<target_file> -XML_ELEMENT=<element_name> [-CHARSET_ENCODING=<encoding>] IF_FILE_EXISTS=<overwrite|skip|error>] [-KEEP_XML_PROLOGUE=<all|xml|doctype|none>] [-HEADER=<header>] [-FOOTER=<footer>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
ソースXMLファイルのフィルタ。このフィルタでは、ファイルの標準的なワイルドカード( 次に、有効なファイル・フィルタを示します。
|
|
- |
はい |
要素の連結先ターゲット・ファイル。 |
|
|
はい |
ソース・ファイルから内容および子要素とともに抽出するXML要素(囲んでいる<>文字、接頭辞およびネームスペース情報を除く)のローカル名。 この要素の検出は再帰的ではありません。 |
|
|
いいえ |
ターゲット・ファイルのエンコーディング。デフォルト値は |
|
|
いいえ |
ターゲット・ファイルが存在する場合の動作を定義します。
|
|
|
いいえ |
ソース・ファイルのXMLプロローグをターゲット・ファイルにコピーします。このパラメータの値に従って、XMLプロローグの次の部分が保持されます。
注意: すべてまたは一部のプロローグを保持しない場合は、HEADERパラメータで指定する必要があります。 |
|
|
いいえ |
各ターゲット・ファイルのプロローグ(ある場合)の後に追加する文字列。このパラメータを使用すると、カスタマイズしたXMLプロローグまたはルート要素を作成できます。 |
|
|
いいえ |
各ターゲット・ファイルの終わりに追加する文字列。このパラメータを使用すると、ヘッダーに追加されたルート要素を閉じることができます。 |
例
次の例では、ord_iサブフォルダにあるord1.xml、ord2.xmlなどのファイルのIDOC要素の内容をMDSLS.TXT.XMLというファイルに連結します。その際、ターゲット・ファイルには<WMMBID02>というルート要素も追加されます。
OdiXMLConcat "-FILE=./ord_i/ord*.xml" "-TOFILE=./MDSLS.TXT.XML" -XML_ELEMENT=IDOC "-CHARSET_ENCODING=UTF-8" -IF_FILE_EXISTS=overwrite -KEEP_XML_PROLOGUE=xml "-HEADER=<WMMBID02>" "-FOOTER=</WMMBID02>" OdiXMLConcat "-FILE=./o?d_*/ord*.xml" "-TOFILE=./MDSLS.TXT.XML" -XML_ELEMENT=IDOC "-CHARSET_ENCODING=UTF-8" -IF_FILE_EXISTS=overwrite -KEEP_XML_PROLOGUE=none "-HEADER=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<WMMBID02>" "-FOOTER=</WMMBID02>"
次の例では、ord_iサブフォルダにあるord1.xml、ord2.xmlなどのファイルのEDI要素をMDSLS2.XMLというファイルに連結します。このファイルには、すべての<EDI>要素の上にEDI_BATCHという新しいルート要素が追加されます。
OdiXMLConcat "-FILE=./o?d_?/ord*.xml" "-TOFILE=./MDSLS2.XML" -XML_ELEMENT=EDI "-CHARSET_ENCODING=UTF-8" -IF_FILE_EXISTS=overwrite -KEEP_XML_PROLOGUE=xml "-HEADER= <EDI_BATCH>" "-FOOTER=</EDI_BATCH>"
このコマンドを使用して、単一のXMLファイルを複数のファイルに分割します。
このツールは、単一のソースXMLファイルに保存されている指定要素のインスタンスをすべて抽出し、複数のターゲットXMLファイルに分割します。このツールは、適格なXMLを解析して生成します。生成されたファイルに対するDTDの変更または生成は処理しません。既存のDTDへの参照は、HEADERパラメータで指定するか、-KEEP_XML_PROLOGUEを使用して元のファイルから保持できます。
|
注意: このツールでは、XMLネームスペースはサポートされません。 |
使用方法
OdiXMLSplit -FILE=<file> -TOFILE=<file_pattern> -XML_ELEMENT=<element_name> [-CHARSET_ENCODING=<encoding>] [-IF_FILE_EXISTS=<overwrite|skip|error>] [-KEEP_XML_PROLOGUE=<all|xml|doctype|none>] [-HEADER=<header>] [-FOOTER=<footer>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
はい |
分割するソースXMLファイル。 |
|
- |
はい |
ターゲット・ファイルのファイル・パターン。各ファイルは、生成される番号順序または分割の実行に使用されるXML要素の属性値を表すマスクを含んだパターンに従って命名されます。
パターンを使用して、単一のディレクトに異なるファイルを作成することも、異なるディレクトリに各ファイルを作成することもできます。次に、有効なパターンを示します。
|
|
|
はい |
ソース・ファイルから内容および子要素とともに抽出するXML要素(囲んでいる この要素の検出は再帰的ではありません。 |
|
|
いいえ |
ターゲット・ファイルのエンコーディング。デフォルト値は |
|
|
いいえ |
ターゲット・ファイルが存在する場合の動作を定義します。
|
|
|
いいえ |
ソース・ファイルのXMLプロローグをターゲット・ファイルにコピーします。このパラメータの値に従って、XMLプロローグの次の部分が保持されます。
注意: すべてまたは一部のプロローグを保持しない場合は、 |
|
|
いいえ |
各ターゲット・ファイルのプロローグ(ある場合)の後に追加する文字列。このパラメータを使用すると、カスタマイズしたXMLプロローグまたはルート要素を作成できます。 |
|
|
いいえ |
各ターゲット・ファイルの終わりに追加する文字列。このパラメータを使用すると、ヘッダーに追加されたルート要素を閉じることができます。 |
例
次の例では、MDSLS.TXT.XMLというファイルを複数のファイルに分割します。ord1.xml、ord2.xmlなどのファイルが作成され、ソース・ファイルに保存されているIDOC要素の各インスタンスが格納されます。
OdiXMLSplit "-FILE=./MDSLS.TXT.XML" "-TOFILE=./ord_i/ord*.xml" -XML_ELEMENT=IDOC "-CHARSET_ENCODING=UTF-8" -IF_FILE_EXISTS=overwrite -KEEP_XML_PROLOGUE=xml "-HEADER= <WMMBID02>" "-FOOTER= </WMMBID02>"
次の例では、前述の例と同様の方法でMDSLS.TXT.XMLというファイルを分割します。ただし、分割するIDOC要素のBEGIN属性の値を使用してファイル名が指定される点が前述の例とは異なります。この例ではXMLプロローグが保持されませんが、すべてヘッダーに生成されています。
OdiXMLSplit "-FILE= ./MDSLS.TXT.XML" "-TOFILE=./ord_i/ord[BEGIN].xml" -XML_ELEMENT=IDOC "-CHARSET_ENCODING=UTF-8" -IF_FILE_EXISTS=overwrite -KEEP_XML_PROLOGUE=none "-HEADER= <?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<WMMBID02>" "-FOOTER=</WMMBID02>"
このコマンドを使用して、ディレクトリまたは複数のファイルからZIPファイルを作成します。
使用方法
OdiZip -DIR=<directory> -FILE=<file> -TOFILE=<target_file> [-OVERWRITE=<yes|no>] [-RECURSE=<yes|no>] [-CASESENS=<yes|no>] [-ENCODING=<file_name_encoding>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
|
|
FILEを指定しない場合は、はい |
生成するZIPファイルのルートになるベース・ディレクトリ(またはフォルダ)。-DIRのみを指定して-FILEを指定しないと、このディレクトリの下にあるすべてのファイルが圧縮されます。 |
|
|
DIRを指定しない場合は、はい |
アーカイブするファイルのベース・ディレクトリからのパス。-FILEのみを指定して-DIRを指定しないと、-FILEが相対パスの場合は、現在の作業ディレクトリがデフォルトのディレクトリになります。 汎用文字を指定するには「*」を使用します。 例:
|
|
|
はい |
ターゲットZIPファイル。 |
|
|
いいえ |
ターゲットZIPファイルがすでに存在している場合は、上書きするか(yes)、単に更新するか(no)を示します。デフォルトでは、既存のZIPファイルがある場合は更新されます。 |
|
|
いいえ |
他のディレクトリが含まれるディレクトリの場合に、アーカイブを再帰的に実行するかどうかを示します。noの値を指定すると、コピーするディレクトリに含まれるファイルのみ(サブフォルダを含まない)がアーカイブされます。 |
|
|
いいえ |
ファイル検索で大文字と小文字が区別されるかどうかを示します。デフォルトでは、ファイルは大文字で検索されます。 |
|
|
いいえ |
アーカイブ・ファイル内部でファイル名に使用される文字エンコーディング。 サポートされているエンコーディングは、次のURLで確認できます。
デフォルトは、プラットフォームのデフォルトの文字エンコーディングです。 |
例
C:\Program files\odiディレクトリのアーカイブを作成します。
OdiZip "-DIR=C:\Program Files\odi" -FILE=*.* -TOFILE=C:\TEMP\odi_archive.zip
C:\Program files\odiディレクトリのアーカイブを作成します。このアーカイブにはodiディレクトリが保持されます。
OdiZip "-DIR=C:\Program Files" -FILE=odi\*.* -TOFILE=C:\TEMP\odi_archive.zip
