# tOracleCDC

前回の抽出以降に変更されたソースシステムデータを抽出し、別のシステムに転送します。

tOracleCDCは、データの抽出と転送のニーズに対応します。ソース運用データに対して行われた変更のみを抽出し、データベースCDCビューを使用して、ターゲットシステムで使用できるようにします。

情報メモ注: ジョブでバッチ処理が有効になっている場合、コンポーネントは変更の順序をキャプチャーできず、ソースとターゲットのデータベースは同期されません。

## tOracleCDCの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtOracleCDCを設定するために使われます。

標準のtOracleCDCコンポーネントは、データベースファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で利用できます。

情報メモ注: このコンポーネントは、動的データベースコネクターの特定のバージョンです。データベース設定に関連するプロパティは、データベースタイプの選択に応じて異なります。動的データベースコネクターについては、[DB Genericコンポーネント](https://help.qlik.com/talend/r/ja-JP/8.0/components/db-generic/db-generic-component)をご覧ください。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| データベース | 目的のデータベースタイプをリストから選択し、[Apply] (適用)をクリックします。 |
| [Property of the CDC connection] (CDC接続のプロパティ) | <ul> <li> <p><span>[Built-in] (組み込み)</span>と<span>[Repository] (リポジトリー)</span>のいずれかです。</p> </li> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul> |
| [Use an existing connection] (既存の接続を使用) | 定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。<br><br>WALLETタイプの接続は、tCreateTableコンポーネント、tOracleInputコンポーネント、tOracleOutputコンポーネントでのみ使用されます。起こりうるエラーを防止できるよう、選択した接続がWALLETタイプでないことを確認してください。<br><br>情報メモ注: ジョブに親ジョブと子ジョブが含まれている時は、親ジョブと子ジョブの間の既存の接続を共有したい場合(たとえば、親ジョブで作成した接続を子ジョブと共有するなど)には、次のように実行します。<br><br><ol> <li>親レベルで、共有するデータベース接続を、そのデータベース接続そのものを作成する接続コンポーネントの<span>[Basic settings] (基本設定)</span>ビューに登録します。 </li> <li>子レベルで、登録済みのそのデータベース接続を読み取るために専用の接続コンポーネントを使用します。 </li> </ol><br><br>ジョブレベル全体でデータベース接続を共有する方法の例は、[データベース接続を共有](https://help.qlik.com/talend/r/ja-JP/7.3/studio-user-guide/sharing-database-connection)をご覧ください。 |
| [Connection Type] (接続タイプ) | 接続タイプをドロップダウンリストから選択します。<br><br><ul> <li> <p> <span>Oracle SID</span>: システムの特定のデータベースを一意識別するには、この接続タイプを選択します。</p> </li> <li> <p> <span>[Oracle Service Name] (Oracleサービス名)</span>: リモートデータベースへの接続時に指定するTNSエイリアスを使用するには、この接続タイプを選択します。</p> </li> <li> <p> <span>Oracle OCI</span>: Oracleデータベースへのインターフェイスを提供する一連のC言語ソフトウェアAPIでOracle Callインターフェイスを使用するには、この接続タイプを選択します。</p> </li> <li> <p> <span>Oracle CUSTOM</span>: クラスター化されたデータベースにアクセスするには、この接続タイプを選択します。</p> </li> </ul> |
| [DB Version] (データベースバージョン) | 使用するOracleデータベースのバージョンを選択します。 |
| [Host] (ホスト) | Oracleデータベースのホスト名またはIPアドレスを指定します。<br><br>このフィールドは、[Connection Type] (接続タイプ)ドロップダウンリストでOracle SIDまたは[Oracle Service Name] (Oracleサービス名)を選択している場合にのみ表示されます。 |
| [Port] (ポート) | Oracleデータベースのリスニングポート番号を指定します。<br><br>このフィールドは、[Connection Type] (接続タイプ)ドロップダウンリストでOracle SIDまたは[Oracle Service Name] (Oracleサービス名)を選択している場合にのみ表示されます。 |
| [Database] (データベース) | Oracleデータベース名を指定します。<br><br>このフィールドは、[Connection Type] (接続タイプ)ドロップダウンリストでOracle SIDまたは[Oracle Service Name] (Oracleサービス名)を選択している場合にのみ表示されます。 |
| [Local Service Name] (ローカルサービス名) | Oracleデータベースのローカルサービス名を指定します。<br><br>このフィールドは、[Connection Type] (接続タイプ)ドロップダウンリストでOracle OCIを選択している場合にのみ表示されます。 |
| URL | リモートOracleデータベースのURLを指定します。<br><br>このフィールドは、[Connection Type] (接続タイプ)ドロップダウンリストでOracle CUSTOMを選択している場合にのみ表示されます。 |
| [Oracle schema] (Oracleスキーマ) | Oracleスキーマの名前を指定します。 |
| [Username] (ユーザー名)と[Password] (パスワード) | Oracleデータベースユーザー認証データを指定します。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [Schema using CDC] (CDCを使うスキーマ)および[Edit schema] (スキーマを編集) | <ul> <li> <p>スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは<span>[Built-in] (組み込み)</span>か、<span>[Repository] (リポジトリー)</span>にリモートで保存されます。 </p> <p>スキーマを変更するには<span>[Edit schema] (スキーマを編集)</span>をクリックします。現在のスキーマが<span>リポジトリー</span>タイプの場合は、3つのオプションを利用できます。</p> <ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> <p>スキーマは、使用しているCDCモードに従ってデフォルトで設定されます。</p> </li> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul> |
| [CDC mode] (CDCモード) | 使用するCDCモードを選択します。<br><br><ul> <li><span>[Trigger] (トリガー)</span>: CDCトリガーモード。</li> <li><span>[log] (ログ)</span>: CDC再実行/アーカイブログモード。このモードは、Oracle Database Enterprise Editionを必要とし 、<span>Oracle 12</span>以降のバージョンでサポートされていません。</li> <li><span>XStream</span>: CDC XStreamモード。このモードは、<span>[Connection Type] (接続タイプ)</span>が<span>Oracle OCI</span>で<span>[DB Version] (データベースバージョン)</span>が<span>Oracle 12-7</span> (以降)の場合にのみ使用できます。</li> </ul> |
| [Generate LCR type] (LCRタイプを生成) | 生成するLCRのタイプとして、[LCR Object] (LCRオブジェクト)または[LCR XML Document] (LCR XMLドキュメント)のどちらかを選択します。<br><br>このリストは、CDCモードがXStreamの場合にのみ表示されます。 |
| [Table using CDC] (CDCを使用するテーブル) | データに加えた変更のキャプチャー先とするソーステーブルを指定します。 |
| [Set data table schema] (データテーブルスキーマの設定) | CDCテーブルのスキーマを指定する場合は、このチェックボックスをオンにします。<br><br>このチェックボックスは、CDCモードが[Trigger] (トリガー)または[log] (ログ)の場合にのみ表示されます。 |
| [Subscriber] (サブスクライバー) | データに対して実行された変更のキャプチャーに[Trigger] (トリガー)モードを使用する場合は、変更テーブルを使用するアプリケーションの名前を指定します。<br><br>このフィールドは、CDCモードが[Trigger] (トリガー)の場合にのみ表示されます。 |
| [Events to catch] (取得するイベント) | [Insert] (挿入): このチェックボックスをオンにすると、前回の抽出以降に変更テーブルに挿入されたデータを取得できます。<br><br>[Update] (アップデート): このチェックボックスをオンにすると、前回の抽出以降に変更テーブルでアップデートされたデータを取得できます。<br><br>[Delete] (削除): このチェックボックスをオンにすると、前回の抽出以降に変更テーブルで削除されたデータを取得できます。<br><br>これらのチェックボックスは、CDCモードが[Trigger] (トリガー)または[log] (ログ)の場合にのみ表示されます。 |
| [Limit] (制限事項) | サブスクライバーが変更テーブルから復元できる消費済み行数の最大値を実行ごとに指定します。<br><br>このフィールドは、CDCモードが[Trigger] (トリガー)の場合にのみ表示されます。 |
| [Outbound server name] (アウトバウンドサーバー名) | XStreamのアウトバウンドサーバー名を指定します。<br><br>このフィールドは、CDCモードがXStreamの場合にのみ表示されます。 |
| [Keep listening] (リスニングの継続) | アウトバウンドサーバーにデータの変更がないか監視を続けるには、このチェックボックスをオンにします。必要な時に手動で停止するまで、ジョブは停止しません。<br><br>このチェックボックスは、CDCモードがXStreamの場合にのみ表示されます。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Keep data in CDC Table] (CDCテーブルにデータを保持) | このチェックボックスを選択すると、CDCテーブルの変更が保持され、取り込み後でも1つ以上のターゲットシステムがデータを参照できるようになります。このオプションを有効にすると、参照されたCDCデータの削除が防止され、代わりにフィールドCDC\_STATEの値が'x'に更新されます。このメカニズムにより、ユーザーはCDC\_STATE = 'x'のレコードをフィルタリングして(例: MYSQLInputコンポーネントを使用)以前に取り込んだデータを再確認し、必要に応じて自分で削除を管理できます。このオプションは、チェックボックスがCDC\_STATEにどのように影響するかを理解するためにジョブを再実行したりプロセスをリバースエンジニアリングしたりすることなく、取り込まれたデータを監査または再確認する必要があるユーザーにとって特に便利です。<br><br>このフィールドは、CDCモードが[Trigger] (トリガー)または[log] (ログ)の場合にのみ表示されます。 |
| [Use cursor] (カーソルの使用) | このチェックボックスをオンにすると、いつでも作業する行数を指定できます。このオプションにより、パフォーマンスを最適化できます。<br><br>このフィールドは、CDCモードが[Trigger] (トリガー)または[log] (ログ)の場合にのみ表示されます。 |
| [Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング) | 文字列を含むすべてのカラムでフィールドの先頭または末尾にあるスペースを削除するには、このチェックボックスをオンにします。<br><br>このフィールドは、CDCモードが[Trigger] (トリガー)または[log] (ログ)の場合にのみ表示されます。 |
| [Trim column] (カラムをトリミング) | 定義されたカラムから先頭や末尾の空白を削除します。<br><br>情報メモ注: [Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング)チェックボックスをオフにし、テーブルのトリムカラムを有効にします。<br><br>このテーブルは、CDCモードが[Trigger] (トリガー)または[log] (ログ)の場合にのみ表示されます。 |
| [Acknowledge interval(seconds)] (応答間隔（秒）) | アウトバウンドサーバーにOCI\_ATTR\_XSTREAM\_ACK\_INTERVALの属性値を指定します。デフォルト値は*30*秒です。<br><br>この属性の詳細は、http://docs.oracle.com/cd/E18283\_01/server.112/e16545/xstrm\_oci\_intro.htm#CEGDICBBをご覧ください。<br><br>このフィールドは、CDCモードがXStreamの場合にのみ表示されます。 |
| [Idle timeout(seconds)] (待ち時間（秒）) | アウトバウンドサーバーにOCI\_ATTR\_XSTREAM\_IDLE\_TIMEOUTの属性値を指定します。デフォルト値は*1*秒です。<br><br>この属性の詳細は、http://docs.oracle.com/cd/E18283\_01/server.112/e16545/xstrm\_oci\_intro.htm#CEGDICBBをご覧ください。<br><br>このフィールドは、CDCモードがXStreamの場合にのみ表示されます。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ログデータがコンポーネントレベルで収集されます。 |
| [Support NLS] (NLSをサポート) | このオプションをオンにすると、グローバリゼーションサポートが有効にできます。関連情報は、[Overview of Globalization Support](https://docs.oracle.com/en/database/oracle/oracle-database/21/nlspg/overview-of-globalization-support.html)をご覧ください。<br><br>このオプションは、[Use an existing connection] (既存の接続を使用)が選択されておらず、[Basic settings] (基本設定)ビューの[DB Version] (データベースバージョン)ドロップダウンリストから、[Oracle 18 and above] (Oracle 18以降)オプションが選択されている場合に利用できます。<br><br>情報メモ注: このオプションは、Talendが提供する8.0.1-R2022-09以降のTalend Studioマンスリーアップデートをインストール済みである時のみ利用可能です。詳細は管理者にお問い合わせください。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | NB\_LINE: 処理された行の数。これはAfter変数で、整数を返します。<br><br>ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、開始コンポーネントとして使用されます。出力コンポーネントと行&gt;メインのリンクが必要です。 |

**関連概念**

* [XStreamモードを使用してデータの変更を抽出および同期する](https://help.qlik.com/talend/ja-JP/components/8.0/change-data-capture/toraclecdc-toraclecdcoutput-toracleinput-toracleoutput-extracting-and-synchronizing-data-changes-using-xstream-mode-standard-component-enterprise-this)
* [Oracle CDC再実行ログモードを使用した変更データの取得](https://help.qlik.com/talend/ja-JP/components/8.0/change-data-capture/toraclecdc-tlogrow-tmap-toracleoutput-retrieving-modified-data-using-oracle-cdc-redo-log-mode-standard-component-enterprise-before)