# tMSSQLCDC

ソース運用データに加えられた変更を抽出し、データベースCDCビューを使ってターゲットシステムで利用できるようにします。

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

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

## tMSSqlCDCの標準プロパティ

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

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

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

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

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| データベース | 目的のデータベースタイプをリストから選択し、[Apply] (適用)をクリックします。 |
| [Use an existing connection] (既存の接続を使用) | 定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。<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)をご覧ください。 |
| [Property type] (プロパティタイプ) | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。<br><br><ul> <li> <span>[Built-in] (組み込み)</span>: 一元的に保存されるプロパティデータはありません。</li> <li> <span>[Repository] (リポジトリー)</span>: プロパティが保管されるリポジトリーファイルを選択します。後続フィールドは、取得されたデータを使用して自動的に入力されます。</li> </ul><br><br>情報メモ警告: 関連するボタンをクリックしてDBタイプをリセットし、CDC接続を選択します。 |
| [JDBC Provider] (JDBCプロバイダー) | 使うJDBCドライバーのプロバイダー、[Microsoft] (マイクロソフト) (デフォルト、推奨)または[Open source JTDS] (オープンソースJTDS)を選択します。<br><br>Microsoftを選択した場合は、SQL Server用Microsoft JDBCドライバーを[\[Microsoftダウンロードセンター\]](https://www.microsoft.com/en-us/download/details.aspx?id=11774)からダウンロードし、ダウンロードしたzipファイルを解凍し、解凍したフォルダーからお使いのJREバージョンに基づいてjarを選択し、jarの名前を*mssql-jdbc.jar*に変更し、手動でインストールする必要があります。jarの選択については、[Microsoftダウンロードセンター](https://www.microsoft.com/en-us/download/details.aspx?id=11774)でシステム要件情報をご覧ください。<br><br>このコンポーネントを Talend Runtimeでデータソースと併用する場合は、[Open source JTDS] (オープンソースJTDS)ドライバーを使用する必要があります。 |
| [Host] (ホスト) | 使うデータベースサーバーかAzure Synapse AnalyticsのIPアドレスまたはホスト名を指定します。<br><br>サーバーが存在するマシンでSQL Server Browserサービスが実行中である場合は、このフィールドにホスト名とインスタンス名を{host\_name}\{instance\_name}という形式で指定すれば、TCPダイナミックポートを通じてネームドインスタンスに接続できるようになります。この場合は[Port] (ポート)フィールドを空白のまましておきます。関連情報は、[SQL Server Browser service](https://docs.microsoft.com/ja-jp/sql/tools/configuration-manager/sql-server-browser-service?view=sql-server-ver16)をご覧ください。 |
| [Port] (ポート) | 使うデータベースサーバーかAzure Synapse Analyticsのリスニングポート番号を入力します。<br><br>サーバーが存在するマシンでSQL Server Browserサービスが実行中である場合は、[Host] (ホスト)フィールドにホスト名とインスタンス名を入力し、このフィールドを空にしておけば、TCPダイナミックポートを通じてネームドインスタンスに接続できるようになります。関連情報は、[SQL Server Browser service](https://docs.microsoft.com/ja-jp/sql/tools/configuration-manager/sql-server-browser-service?view=sql-server-ver16)をご覧ください。 |
| データベース | データベースの名前を入力します。 |
| [Schema] (スキーマ) | スキーマの名前を入力します。 |
| [Username] (ユーザー名)と[Password] (パスワード) | 認証データを入力します。<br><br>パスワードを入力するためには、[Password] (パスワード)フィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。<br><br>[Additional JDBC Parameters] (追加のJDBCパラメーター)フィールドにintegratedSecurity=trueを追加し、これら2つのフィールドを空にしておけば、Windowsで[Type 2 integrated authentication] (タイプ2のインテグレーション認証)を使用できるようになります。関連情報は、[Building the connection URL](https://docs.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url?redirectedfrom=MSDN)で*Connecting with integrated authentication On Windows*というセクションをご覧ください。 |
| [Schema using CDC] (CDCを使うスキーマ)および[Edit Schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。<br><br>[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。<br><br>[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。<br><br>情報メモ警告: 関連するボタンをクリックしてDBタイプをリセットし、CDC接続のスキーマを選択します。<br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><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> |
| [Table name] (テーブル名) | データに加えられた変更を取り込むソーステーブルを選択します。 |
| [Subscriber] (サブスクライバー) | 変更テーブルを使用するアプリケーションの名前を入力します。 |
| [Events to catch] (取得するイベント) | <ul> <li> <span>[Insert] (挿入)</span>: このチェックボックスをオンにすると、前回の抽出以降に変更テーブルに挿入されたデータを取得できます。</li> <li> <span>[Update] (アップデート)</span>: このチェックボックスをオンにすると、前回の抽出以降に変更テーブルでアップデートされたデータを取得できます。</li> <li> <span>[Delete] (削除)</span>: このチェックボックスをオンにすると、前回の抽出以降に変更テーブルで削除されたデータを取得できます。</li> </ul> |
| [Limit] (制限事項) | サブスクライバーが変更テーブルから実行するたびに復元できる、消費される行の最大数。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Additional JDBC parameters] (追加のJDBCパラメーター) | 作成するデータベース接続の接続の追加プロパティを指定します。このオプションは、[Basic settings] (基本設定)の[Use an existing connection] (既存の接続を使用)チェックボックスをオンにしている場合は使用できません。 |
| [Keep data in CDC Table] (CDCテーブルにデータを保持) | このチェックボックスを選択すると、CDCテーブルの変更が保持され、取り込み後でも1つ以上のターゲットシステムがデータを参照できるようになります。このオプションを有効にすると、参照されたCDCデータの削除が防止され、代わりにフィールドCDC\_STATEの値が'x'に更新されます。このメカニズムにより、ユーザーはCDC\_STATE = 'x'のレコードをフィルタリングして(例: MYSQLInputコンポーネントを使用)以前に取り込んだデータを再確認し、必要に応じて自分で削除を管理できます。このオプションは、チェックボックスがCDC\_STATEにどのように影響するかを理解するためにジョブを再実行したりプロセスをリバースエンジニアリングしたりすることなく、取り込まれたデータを監査または再確認する必要があるユーザーにとって特に便利です。 |
| [Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング) | 文字列を含むすべてのカラムでフィールドの先頭または末尾にあるスペースを削除するには、このチェックボックスをオンにします。 |
| [Trim column] (カラムをトリミング) | 定義されたカラムから先頭や末尾の空白を削除します。<br><br>情報メモ注: [Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング)の選択を解除して、このフィールドのトリミングカラムを有効にします。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。 |
| [Enable parallel execution] (並列実行を有効化) | このチェックボックスをオンにすると、複数のデータフローを同時に処理することにより、高速データ処理を実行できます。このフィーチャーは、データベースまたは複数の挿入を並行して処理するアプリケーションの機能と、関係するCPUの数に依存していることにご注意ください。[Number of parallel executions] (並列実行の数)フィールドで次のいずれかの操作を行います。<br><br><ul> <li>実行する並列実行の数を入力します。</li> <li><span>Ctrl + スペース</span>を押し、リストから適切なコンテキスト変数を選択します。コンテキスト変数の詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables" target="_blank">コンテキストと変数を使用</a>をご覧ください。 </li> </ul><br><br>並列実行を有効にすると、グローバル変数を使ってサブジョブで戻り値を取得することはできないことにご注意ください。<br><br><ul><li> <span>[Action on table] (テーブルでのアクション)</span>フィールドは、並列化ファンクションでは利用できません。したがって、テーブルを作成する場合は、<span>tCreateTable</span>のコンポーネントを使用する必要があります。 </li><li> 						            並列実行を有効にすると、グローバル変数を使ってサブジョブで戻り値を取得できません。 </li> </ul> |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | 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;メインのリンクが必要です。 |