tOracleSPの標準プロパティ
これらのプロパティは、標準ジョブのフレームワークで実行されているtOracleSPを設定するために使われます。
標準のtOracleSPコンポーネントは、データベースファミリーに属しています。
このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。
基本設定
[Database] (データベース) |
データベースのタイプをリストから選択し、[Apply] (適用)をクリックします。 |
[Use an existing connection] (既存の接続を使用) |
定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。 WALLETタイプの接続は、tCreateTableコンポーネント、tOracleInputコンポーネント、tOracleOutputコンポーネントでのみ使用されます。起こりうるエラーを防止できるよう、選択した接続がWALLETタイプでないことを確認してください。 情報メモ注: ジョブに親ジョブと子ジョブが含まれている時は、2つのレベルの間の既存の接続を共有する必要がな場合(たとえば、親ジョブで作成した接続を子ジョブと共有するなど)には、以下を実行する必要があります。
ジョブレベル全体でデータベース接続を共有する方法の例は、Talend Studioユーザーガイドをご覧ください。 |
[Connection type] (接続タイプ) |
使用できるドライバーのドロップダウンリスト: Oracle OCI: Oracleデータベースへのインターフェイスを提供する一連のC言語ソフトウェアAPIでOracle Callインターフェイスを使用するには、この接続タイプを選択します。 [Oracle Service Name] (Oracleサービス名): リモートデータベースへの接続時に指定するTNSエイリアスを使用するには、この接続タイプを選択します。 Oracle SID: システムの特定のデータベースを一意識別するには、この接続タイプを選択します。 Oracle Custom: クラスター化されたデータベースにアクセスするには、この接続タイプを選択します。 |
[Property type] (プロパティタイプ) |
[Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。 |
|
[Built-In] (組み込み): 一元的に保存されるプロパティデータはありません。 |
|
[Repository] (リポジトリー): プロパティが保管されるリポジトリーファイルを選択します。後続フィールドは、取得されたデータを使用して自動的に入力されます。 |
[DB Version] (データベースバージョン) |
使用中のOracleバージョンを選択します。 |
[Host] (ホスト) |
データベースサーバーのIPアドレス。 |
[Port] (ポート) |
データベースサーバーのリスニングポート番号。 |
[Database] (データベース) |
データベースの名前。 |
[Schema] (スキーマ) |
スキーマの名前。 |
[Username] (ユーザー名)と[Password] (パスワード) |
データベースユーザー認証データ。 パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、OKをクリックして設定を保存します。 |
[Schema] (スキーマ)と[Edit schema] (スキーマを編集) |
スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。 スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。
|
|
[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。 |
|
[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。 |
[SP Name] (ストアドプロシージャー名) |
ストアドプロシージャー(またはファンクション)の正確な名前を入力します |
[Is Function] (ファンクションとして使用) /[Return result in] (結果を返す) |
ストアドプロシージャーがファンクションであり、1つの値のみが返されるようにするには、このチェックボックスをオンにします。 スキーマカラムのリストから返す値を選択します。 |
[Parameters] (パラメーター) |
[+]ボタンをクリックして、プロシージャーで必要となる各種[Schema Columns] (スキーマカラム)を選択します。SPスキーマには、プロシージャーで使用されているパラメーターを超える数のカラムを含めることができます。 |
|
パラメーターの[Type] (タイプ)を選択します。 IN: 入力パラメーター。 OUT: 出力パラメーター/戻り値。 IN OUT: 通常、入力パラメーターはプロシージャー(ファンクション)によって変更された後に値として返されます。 [RECORDSET]: 入力パラメーターは単一の値ではなく、値のセットとして返されます。 |
|
使用する[Schema Column] (スキーマカラム)がユーザー定義の場合は、[Custom Type] (カスタムタイプ)が使用されます。[Parameters] (パラメーター)テーブルでは、2つの[Custom Type] (カスタムタイプ)カラムが使用できます。最初の[Custom Type] (カスタムタイプ)カラムで、次の手順を実行します。 - 対応する[Schema Column] (スキーマカラム)のうちで使用するものがユーザー定義タイプの場合は、[Custom Type] (カスタムタイプ)カラムのチェックボックスをオンにします。 - [Parameters] (パラメーター)テーブルにリスト表示されている[Schema Columns] (スキーマカラム)がすべてカスタムタイプの場合は、[Custom Type] (カスタムタイプ)の前にあるチェックボックスを一括でオンにできます。 |
|
[DB Type] (DBタイプ)リストからデータベースタイプを選択し、ソースデータベースタイプをターゲットデータベースタイプにマップします。 [- Auto-Mapping] (自動マッピング): ソースデータベースタイプをターゲットデータベースタイプに自動的にマップします。(デフォルト) - CLOB: キャラクターラージオブジェクト。 - BLOB: バイナリラージオブジェクト。 - DECIMAL: 10進数オブジェクト。 - NUMERIC: 0から9までの数字。 - XMLTYPE: XMLスキーマタイプ。 情報メモ警告:
[Return result in] (結果の返却先)リストボックスから選択したカラム、またはパラメーターのINまたはOUTタイプに設定したカラムをXMLTYPEにマップする時は、スキーマでカラムのタイプが[String] (文字列)タイプであることを確認します。 |
|
2番目の[Custom Type] (カスタムタイプ)カラムで、カスタムタイプを詳細に設定できます。タイプは次のようになります: - STRUCT: 1つのエレメントに使用します。 - ARRAY: エレメントのコレクションに使用します。 |
|
[Custom name] (ユーザー定義の名前)カラムで、このタイプに与えたカスタムタイプの名前を指定します。 情報メモ警告:
OUTパラメーターがカスタムタイプを使用している場合は、対応するスキーマカラムでスキーマテーブルのオブジェクトタイプが選択されていることを確認します。 |
[Specify a data source alias] (データソースエイリアスを指定) |
このチェックボックスをオンにして、データソース設定で定義した共有接続プールを使用するために、 Talend Runtime 側で作成したデータソースのエイリアスを指定します。このオプションは、 Talend Runtime 内にジョブをデプロイして実行する時にのみ機能します。 |
詳細設定
[Additional JDBC parameters] (追加のJDBCパラメーター) |
作成するデータベース接続の接続の追加プロパティを指定します。このオプションは、[Basic settings] (基本設定)の[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は利用できません。 |
[NLS Language] (NLS言語) |
Unicodeで使用されていないデータに使用する言語をリストで選択します。 |
[NLS Territory] (NLS地域) |
日付と時刻の形式に使用する規則を選択します。デフォルト値はオペレーティングシステムのデフォルト値です。 |
[tStatCatcher Statistics] (tStatCatcher統計) |
このチェックボックスを選択すると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。 |
使用方法
使用ルール |
このコンポーネントは、中間コンポーネントとして使用されます。開始コンポーネントとしても使用できますが、その場合は入力パラメーターになります。 |
[Dynamic settings] (ダイナミック設定) |
[+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブ内で計画した複数の接続からデータベース接続をダイナミックに選択します。この機能は、データストラクチャーが同じでデータベースが異なるデータベーステーブルにアクセスする必要がある場合、特に、Talend Studioを介さずにジョブをデプロイおよび実行する必要がある時など、ジョブの設定を変更できない環境で作業している場合に役立ちます。 [Dynamic settings] (ダイナミック設定)テーブルは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合のみ利用できます。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは利用できなくなります。 ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。[Dynamic settings] (ダイナミック設定)とコンテキスト変数については、Talend Studioユーザーガイドをご覧ください。 |
制限事項 |
ストアドプロシージャーの構文は、データベースの構文とマッチしている必要があります。 このコンポーネントに設定したパラメーターが[Custom Type] (カスタムタイプ)のパラメーターである場合は、ユーザーがカスタムタイプパラメーターの値を定義するために、tJavaファミリーのコンポーネントをコンポーネントの前に置きます。または、Outタイプのカスタムパラメーターを読み取って出力するために、コンポーネントの後に置きます。 |