# tExasolRow

ExasolデータベースでSQLクエリーを実行します。

tExasolRowは、クエリーとデータベースの性質に応じて、データベースの実際のストラクチャー、または実際のデータに対してアクションを行います。ただし、変更は行いません。行サフィックスは、出力データを生成しないものの、ジョブ内のフローをチャネルするために使われることを示します。

## tExasolRowの標準プロパティ

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

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

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

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

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| データベース | 目的のデータベースタイプをリストから選択し、[Apply] (適用)をクリックします。 |
| プロパティタイプ | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。<br><br><ul> <li> <p> <span>[Built-In] (組み込み)</span>: 一元的に保存されるプロパティデータはありません。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: プロパティが保管されるリポジトリーファイルを選択します。続くデータベース接続フィールドは、取得されたデータを使用して自動的に入力されます。</p> </li> </ul> |
| [Use an existing connection] (既存の接続を使用) | このチェックボックスを選択して、表示されたリストから、定義済みの接続詳細を再利用する、該当する接続コンポーネントを選択します。<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)をご覧ください。 |
| [Host] (ホスト) | Exasolデータベースサーバーのホストまたはホストリストを入力します。Exasolはクラスター環境で実行できます。有効な値は、シンプルなIPアドレス(*172.16.173.128*など)、IP範囲のリスト(*172.16.173.128*、*172.16.173.129*、*172.16.173.130*という3つのサーバーを表す*172.16.173.128..130*など)、Exasolデータベースクラスターのコンマで区切られたホストのリスト(*server1,server2,server3*など)のいずれかとなります。 |
| [Port] (ポート) | Exasolデータベースクラスターのリスニングポート番号を入力します。 |
| [Schema name] (スキーマ名) | 使うスキーマの名前を入力します。 |
| Username (ユーザー名)とPassword (パスワード) | Exasolデータベースにアクセスするためのユーザー認証データを入力します。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | <ul> <li> <p>スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語の<kbd>line</kbd>を避けます。</p> <ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul> </li> <li> <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> </li> </ul> |
| [Table Name] (テーブル名) | 処理するテーブルの名前を入力します。 |
| [Query Type] (クエリータイプ) | [Built-In] (組み込み)または[Repository] (リポジトリー)のいずれか。<br><br><ul> <li> <p> <span>[Built-In] (ビルトイン)</span>: 手動で、またはSQLBuilderを使ってクエリーを入力します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: <span>[Repository] (リポジトリー)</span>から適切なクエリーを選択します。次に、<span>[Query] (クエリー)</span>フィールドが自動的に入力されます。</p> </li> </ul> |
| [Guess Query] (クエリーを推測) | [Guess Query] (クエリーを推測)ボタンをクリックして、[Query] (クエリー)フィールド内のテーブルスキーマに対応するクエリーを生成します。 |
| クエリー | スキーマ定義と一致させるように、フィールドの順序に特に注意を払いつつ、データベースクエリーを入力します。 |
| [Die on error] (エラー発生時に強制終了) | このチェックボックスを選択すると、エラー発生時にジョブの実行が停止されます。<br><br>エラーの発生した行をスキップし、エラーが発生していない行の処理を完了するには、このチェックボックスをオフにします。エラーをスキップしたら、[Row] (行)&gt; [Reject] (リジェクト)リンクを使用してエラーの発生した行を収集できます。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Additional JDBC parameters] (追加のJDBCパラメーター) | 作成するデータベース接続に接続の追加プロパティを指定します。プロパティはセミコロンで区切られ、各プロパティはキー-値ペアです。たとえば、*encryption=1;clientname=Talend*になります。<br><br>このフィールドは、[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は利用できません。 |
| [Propagate QUERY's recordset] (QUERYのレコードセットをプロパゲート) | クエリーの結果をフローのカラムの1つに入力するには、このチェックボックスをオンにします。特定のカラムを[use column] (カラムの使用)リストから選択します。 |
| [Use PreparedStatement] (PreparedStatementの使用) | このチェックボックスをオンにして準備済みステートメントを使い、表示された[Set PreparedStatement Parameters] (PreparedStatementパラメーターの設定)テーブルで、必要な数のパラメーターを追加して、各パラメーターに次の属性を設定するために使われます。<br><br><ul> <li> <p> <span>[Parameter Index] (パラメーターインデックス)</span>: 準備されたステートメントパラメーターのインデックスを入力します。</p> </li> <li> <p> <span>[Parameter Type] (パラメータータイプ)</span>: セルをクリックし、リストからパラメーターのタイプを選択します。</p> </li> <li> <p> <span>[Parameter Value] (パラメーター値)</span>: パラメーターの値を入力します。</p> </li> </ul> |
| [Commit every] (コミットする間隔) | データが書き込まれる前に各バッチに含める行数を入力します。このオプションは、トランザクションの品質を保証し(ただし、ロールバックオプションはありません)、パフォーマンスを向上させます。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | QUERY: 処理されているクエリーステートメント。これはFlow変数で、文字列を返します。<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)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントでは、使用可能なSQLクエリーの要件がすべて網羅されているため、クエリーの柔軟性が提供されます。 |
| 制限事項 | ライセンスの互換性の問題のため、このコンポーネントの使用に必要な1つ以上のJARが提供されていません。この特定のコンポーネントに不足しているJARをインストールするには、Component (コンポーネント)タブビューの[Install] (インストール)ボタンをクリックします。Talend StudioのIntegrationパースペクティブにある[Modules] (モジュール)タブでも、不足しているすべてのJARを簡単に見つけて追加できます。詳細は、[外部モジュールをインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/installing-external-modules)をご覧ください。 |