# tSingleStoreOutputBulkExec

JDBC APIで接続したデータベースのテーブルにファイルからのデータをロードする時のパフォーマンスを向上させます。

tSingleStoreOutputBulkコンポーネントとtSingleStoreBulkExecコンポーネントは、通常、次の2段階のプロセスで連携して機能します。

1. tSingleStoreOutputBulkコンポーネントは、受信データをストレージにアップロードします。
2. tSingleStoreBulkExecコンポーネントは、ストレージからデータベーステーブルにデータをロードします。

この2段階のプロセスで、データベーステーブルにロードする前にデータを変換できます。これら2つのステップは、tSingleStoreOutputBulkExecコンポーネント内で融合しています。

## tSingleStoreOutputBulkExecの標準プロパティ

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

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

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

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

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| データベース | 目的のデータベースタイプをリストから選択し、[Apply] (適用)をクリックします。 |
| [Property Type] (プロパティタイプ) | 接続の詳細を設定する方法を選択します。<br><br><ul> <li> <span>[Built-In] (組み込み)</span>: このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。 </li> <li> <span>[Repository] (リポジトリー)</span>: <span><span>[Repository] (リポジトリー)</span> &gt; <span>[Metadata] (メタデータ)</span></span>で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。このチェックボックスの横にある <span>[...]</span> ボタンをクリックし、表示された <span>[Repository Content] (リポジトリーのコンテンツ)</span>ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。 </li> </ul><br><br>このプロパティは、[Connection Component] (接続コンポーネント)ドロップダウンリストから、[Use this Component] (このコンポーネントを使用)を選択した場合に利用できます。 |
| [Connection Component] (接続コンポーネント) | このコンポーネントで再利用するデータベース接続を開くコンポーネントを選択します。 |
| JDBC URL | 使用するデータベースのJDBC URL。たとえば、Amazon RedshiftデータベースのJDBC URLはjdbc:redshift://endpoint:port/databaseです。 |
| [Drivers] (ドライバー) | 必要なドライバーJARをロードするには、このテーブルに入力してください。これを行うには、テーブルの下の[+]ボタンをクリックして、必要に応じてドライバーJAR用行数を増やします。セルを選択し、セルの右側にある[...]ボタンをクリックして、[Module] (モジュール)ダイアログボックスを開くと使用するドライバーJARを選択できます。たとえば、RedshiftデータベースのドライバーjarはRedshiftJDBC41-1.1.13.1013.jarです。<br><br>詳細は、[\[Importing a database driver\] (データベースドライバのインポート)](https://help.qlik.com/talend/r/ja-JP/8.0/components/jdbc/importing-database-driver)をご覧ください。 |
| [Driver Class] (ドライバークラス) | 指定したドライバーのクラス名を二重引用符で囲んで入力します。たとえば、RedshiftJDBC41-1.1.13.1013.jarドライバーの場合、入力する名前はcom.amazon.redshift.jdbc41.Driverになります。 |
| [User Id] (ユーザーID)と[Password] (パスワード) | データベースユーザー認証データ。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br><ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul><br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。<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><br><br>このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)をご覧ください。<br><br>ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。 |
| [Table Name] (テーブル名) | データが書き込まれるテーブルの名前を入力します。 |
| [Bulk file] (バルクファイル) | ロードするバルクファイルの名前。 |
| Append | 受信データを既存のバルクファイルに追加する場合はこのオプションを選択します。<br><br>このオプションによって既存ファイルのデータは上書きされないようになります。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Row Separator] (行区切り) | 行の終端を識別するために使用される区切り。 |
| [Field separator] (フィールド区切り) | 転送されたデータのフィールドを区切る場合は、文字、文字列、正規表現のいずれかを入力します。 |
| [Set text enclosure] (テキストエンクロージャーを設定) | このオプションを選択するとテキストエンクロージャーが設定されます。右のテキストフィールドに、エンクロージャー文字(1文字のみ)を二重引用符で囲んで入力します。たとえばエンクロージャー文字として二重引用符( " )を使用する場合は、"""と入力します。<br><br>標準エスケープ文字("\")を使用することをお勧めします。これを使用しない場合は、[Escape char] (エスケープ文字)と[Text enclosure] (テキストエンクロージャー)に同じ文字を設定する必要があります。エスケープ文字を"\"に設定した場合は、テキストエンクロージャーを他の文字に設定できます。エスケープ文字を"\"以外の文字に設定した場合は、テキストエンクロージャーと同じ文字に変更されます。たとえばエスケープ文字が"#"に、テキストエンクロージャーが"@"にそれぞれ設定されている場合、エスケープ文字は"@"に変更されます。 |
| [Set null value] (Null値を設定) | このオプションを選択するとNull値が設定されます。右側のフィールドにNull値を設定できます。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、データベースにロードするデータが特定の変換を必要としない場合に主に使います。 |