tOracleSPの標準プロパティ - Cloud - 8.0

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

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

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

WALLETタイプの接続は、tCreateTableコンポーネント、tOracleInputコンポーネント、tOracleOutputコンポーネントでのみ使用されます。起こりうるエラーを防止できるよう、選択した接続がWALLETタイプでないことを確認してください。

[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つのオプションを利用できます。

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

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

• [Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

  変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーのコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

[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スキーマタイプ。

2番目の[Custom Type] (カスタムタイプ)カラムで、カスタムタイプを詳細に設定できます。タイプは次のようになります:

- STRUCT: 1つのエレメントに使用します。

- ARRAY: エレメントのコレクションに使用します。

[Custom name] (ユーザー定義の名前)カラムで、このタイプに与えたカスタムタイプの名前を指定します。

このチェックボックスをオンにして、データソース設定で定義した共有接続プールを使用するために、 Talend Runtime 側で作成したデータソースのエイリアスを指定します。このオプションは、 Talend Runtime 内にジョブをデプロイして実行する時にのみ機能します。

[Additional JDBC parameters] (追加のJDBCパラメーター)

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

[NLS Language] (NLS言語)

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

[NLS Territory] (NLS地域)

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

[tStatCatcher Statistics] (tStatCatcher統計)

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

[Support NLS] (NLSをサポート)

このオプションを選択すると、グローバリゼーションサポートが有効にできます。関連情報は、Overview of Globalization Supportをご覧ください。

このオプションは、[Use an existing connection] (既存の接続を使用)が選択されておらず、[Basic settings] (基本設定)ビューの[DB Version] (データベースバージョン)ドロップダウンリストから、[Oracle 18 and above] (Oracle 18以降)オプションが選択されている場合に利用できます。

使用ルール

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

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

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

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

ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。ダイナミック設定とコンテキスト変数の詳細は、ダイナミックスキーマとコンテキストグループを作成し、その中でコンテキスト変数を定義をご覧ください。

制限事項

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

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