tOracleSP標準プロパティ - 7.3

Oracle

Version
7.3
Language
日本語 (日本)
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > DBコンポーネント > Oracle
データガバナンス > サードパーティーシステム > DBコンポーネント > Oracle
データクオリティとプレパレーション > サードパーティーシステム > DBコンポーネント > Oracle

このプロパティは[Standard] (標準)ジョブフレームワークで実行するtOracleSPの設定で使用されます。

[Standard] (標準)tOracleSPコンポーネントはデータベースファミリーのコンポーネントです。

このフレームワーク内のコンポーネントは、すべてのTalend製品で使用できます。

注: このコンポーネントは、動的データベースコネクターの特定のバージョンです。データベース設定に関連するプロパティは、データベースタイプの選択に応じて異なります。動的データベースコネクターについては、../reuse/../standard/dynamic-database-components_c.htmlを参照してください。

基本設定

データベース

データベースのタイプをリストから選択し、[Apply] (適用)をクリックします。

Use an existing connection (既存の接続を使用)

定義済みの接続の詳細を再利用するには、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストで目的の接続コンポーネントを選択します。

注: ジョブに親ジョブと子ジョブが含まれている時は、2つのレベルの間の既存の接続を共有する必要がな場合(たとえば、親ジョブで作成した接続を子ジョブと共有するなど)には、以下を実行する必要があります。
  1. 親レベルで、共有するデータベース接続を、そのデータベース接続そのものを作成する接続コンポーネントの[Basic settings] (基本設定)ビューに登録します。

  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] (DBバージョン)

使用中のOracleバージョンを選択します。

[Host] (ホスト)

データベースサーバーのIPアドレス。

[Port] (ポート)

DBサーバーのリスニングポート番号。

[Database] (データベース)

データベースの名前。

[Schema] (スキーマ)

スキーマの名前。

[Username] (ユーザー名)[Password] (パスワード)

DBユーザー認証データ。

パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、[OK] をクリックして設定を保存します。

[Schema] (スキーマ)[Edit schema] (スキーマを編集)

スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを使用できます。

  • [View schema] (スキーマの表示): スキーマのみを表示する場合は、このオプションを選択します。

  • [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

  • [Update repository connection] (リポジトリー接続を更新): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーのコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

 

[Built-in] (組み込み): そのコンポーネントのみのスキーマを作成して、ローカルに保存します。

 

[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

[SP Name] (SP名)

ストアドプロシージャー(またはファンクション)の正確な名前を入力します

[Is Function] (関数として使用) /[Return result in] (結果を返す)

ストアドプロシージャーがファンクションであり、1つの値のみが返されるようにするには、このチェックボックスをオンにします。

スキーマカラムのリストから返す値を選択します。

[Parameters] (パラメーター)

[+]ボタンをクリックして、プロシージャーで必要となる各種[Schema Columns] (スキーマカラム)を選択します。SPスキーマには、プロシージャーで使用されているパラメーターを超える数のカラムを含めることができます。

 

パラメーターの[Type] (タイプ)を選択します:

IN: 入力パラメーター。

OUT: 出力パラメーター/戻り値。

IN OUT: 通常、入力パラメーターはプロシージャー(ファンクション)によって変更された後に値として返されます。

[RECORDSET]: 入力パラメーターは単一の値ではなく、値のセットとして返されます。

注:

データベーステーブルまたはDBクエリーから一連のレコードを分析し、単一のレコードを返す場合は、tmysqlconnection-tmysqlrollback-tfileinputdelimited_inserting-data-in-mother-daughter-tables_standard_component_the-follow_c.htmlをチェックします。

 

使用する[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パラメーター)

作成するDB接続の追加の接続プロパティを指定します。このオプションは、[Basic settings] (基本設定)[Use an existing connection] (既存の接続の使用)チェックボックスをオンにしている場合は使用できません。

[NLS Language] (NLS言語)

Unicodeで使用されていないデータに使用する言語をリストで選択します。

[NLS Territory] (NLS地域)

日付と時刻の形式に使用する規則を選択します。デフォルト値はオペレーティングシステムのデフォルト値です。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスをオンにすると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。

使用方法

[Usage rule] (使用ルール)

このコンポーネントは、中間コンポーネントとして使用されます。開始コンポーネントとしても使用できますが、その場合は入力パラメーターになります。

[Dynamic settings] (ダイナミック設定)

[+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブ内で計画した複数の接続からデータベース接続をダイナミックに選択します。この機能は、データ構造が同じでデータベースが異なるデータベーステーブルにアクセスする必要がある場合、特に、Talend Studioを介さずにジョブをデプロイおよび実行する必要がある時など、ジョブの設定を変更できない環境で作業している場合に役立ちます。

[Dynamic settings] (動的設定)テーブルは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)チェックボックスが選択されている場合にのみ使用できます。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは使用できなくなります。

動的パラメーターの使用サンプルは、../reuse/../standard/reading-data-from-databases-through-context-based-dynamic-connect_c.htmlおよび../reuse/../standard/tcontextload_tlogrow-tfileinputdelimited-tmysqlinput_reading-data-from-different-mysql-databases-using-dynamically-loa_standard_component_the-job-in_c.htmlを参照してください。[Dynamic settings] (動的設定)とコンテキスト変数については、『Talend Studioユーザーガイド』を参照してください。

[Limitation] (制限事項)

ストアドプロシージャーの構文は、データベースの構文とマッチしている必要があります。

このコンポーネントに設定したパラメーターが[Custom Type] (カスタムタイプ)のパラメーターである場合は、ユーザーがカスタムタイプパラメーターの値を定義するために、tJavaファミリーのコンポーネントをコンポーネントの前に置きます。または、Outタイプのカスタムパラメーターを読み込んで出力するために、コンポーネントの後に置きます。