# tHSQLDbInput

スキーマ定義に対応する必要がある厳密に定義された順序でDBクエリーを実行し、次に、メイン行リンクでフィールドリストを次のコンポーネントに渡します。

tHSQLDbInputではデータベースを読み取り、クエリーに基づいてフィールドを抽出します。

## tHSQLDbInputの標準プロパティ

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

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

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

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Property type] (プロパティタイプ) | <ul> <li> <p> <span><span>[Built-in] (組み込み)</span>と<span>[Repository] (リポジトリー)</span>のいずれかです。</span></p> </li> <li> <p> <span>[Built-In] (組み込み)</span>: 一元的に保存されるプロパティデータはありません。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: プロパティが保管されるリポジトリーファイルを選択します。後続フィールドは、取得されたデータを使用して自動的に入力されます。</p> </li> </ul> |
| ![](https://help.qlik.com/talend/ja-JP/components/8.0/Resources/images/Save_Icon.png) | このアイコンをクリックすると、データベース接続ウィザードが開き、コンポーネント[Basic settings] (基本設定)ビューに設定したデータベース接続パラメーターが保存されます。<br><br>データベース接続パラメーターの設定と保存の詳細は、[データベースメタデータを一元管理](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/centralizing-database-metadata)をご覧ください。 |
| [Running Mode] (実行モード) | 4つの提案の中から、DBセットアップに対応するサーバーモードをリストから選択します:<br><br>HSQLDbサーバー、HSQLDb Webサーバー、HSQLDbインプロセスパーシステント、HSQLDbインメモリ。 |
| [Use TLS/SSL Sockets] (TLS/SSLソケットの使用) | 必要に応じてセキュアモードを有効にするには、このチェックボックスをオンにします。 |
| Host (ホスト) | データベースサーバーのIPアドレス。 |
| [Port] (ポート) | DBサーバーのリスニングポート番号。 |
| [Database Alias] (データベースエイリアス) | データベースのエイリアス名。 |
| Username (ユーザー名)とPassword (パスワード) | DBユーザー認証データ。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [DB path] (DBパス) | 接続するデータベースのディレクトリーを指定します。このフィールドは、[HSQLDb In Process Persistent] (永続プロセスのHSQLDb)実行モードでのみ使用できます。<br><br>情報メモ注:<br><br>デフォルトでは、このフィールドで指定したデータベースが存在しない場合、データベースは自動的に作成されます。このデフォルト設定を変更する場合は、[Advanced settings] (詳細設定)ビューの [Additional JDBC parameter] (追加のJDBCパラメーター)フィールドで設定された接続パラメーターを変更します。 |
| [DB name] (DB名) | 接続するデータベース名を入力します。このフィールドは、[HSQLDb In ProcessPersistent] (永続プロセスのHSQLDb)実行モードとHSQLDbInMemory実行モードでのみ使用できます。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | <ul> <li> <p>スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語の<kbd>line</kbd>を避けます。</p> <p>このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema" target="_blank">ダイナミックスキーマ</a>をご覧ください。</p> <p>ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。</p> </li> <li> <p> <span>[Built-in] (組み込み)</span>: スキーマが作成され、このコンポーネント専用にローカルに保存されます。<span>[Basic settings] (基本設定)</span>タブにあるコンポーネントスキーマの詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/basic-settings-tab" target="_blank">[Basic settings] (基本設定)</a>をご覧ください。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは既に存在し、リポジトリーに保存されています。したがって、再利用できます。<span>[Basic settings] (基本設定)</span>タブにあるコンポーネントスキーマの詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/basic-settings-tab" target="_blank">[Basic settings] (基本設定)</a>をご覧ください。</p> </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> |
| クエリータイプおよびクエリー | クエリーを入力します。フィールドの順序に気を付けて、スキーマ定義と一致するようにしてください。<br><br>*ダイナミックスキーマ機能を使用する場合、SELECTクエリーには、選択したテーブルからすべてのカラムを取得するため\*ワイルドカードを含める必要があります。* |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Additional JDBC parameters] (追加のJDBCパラメーター) | 作成するDB接続の接続の追加プロパティを指定します。実行モードがHSQLDb In Process Persistentの場合、接続のプロパティ ifexists=trueを設定して、既存のデータベースへの接続のみを許可し、新規データベースの作成を避けることができます。 |
| [Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング) | すべてのStringカラム/Charカラムの先頭や末尾の空白を削除する場合は、このチェックボックスを選択します。 |
| [Trim column] (カラムをトリミング) | 定義されたカラムから先頭や末尾の空白を削除します。 |
| [tStat Catcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、コンポーネントレベルでログデータを収集できます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | NB\_LINE: 処理された行数を示します。これはAfter変数で、整数を返します。<br><br>[QUERY] (クエリー): 処理するクエリーを示します。これはFlow変数で、文字列を返します。<br><br>変数の使用方法は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。<br><br>情報メモ注:<br><br>Flow変数は、コンポーネントの実行中に機能することを意味し、After変数は、コンポーネントの実行後に機能することを意味します。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントでは、HSQLDbデータベースで使えるすべてのSQLクエリーが網羅されています。 |
| [Connections] (接続) | 外部リンク(このコンポーネントから別のコンポーネントへのリンク):<br><br>[Row] (行): Main; Iterate<br><br>[Trigger] (トリガー): Run if; On Component Ok; On Component Error; On Subjob Ok; On Subjob Error<br><br>受信リンク(あるコンポーネントからこのコンポーネントへのリンク):<br><br>[Row] (行): Iterate;<br><br>[Trigger] (トリガー): Run if; On Component Ok; On Component Error; On Subjob Ok; On Subjob Error<br><br>接続の詳細は、[ジョブにおける接続の使い方](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/using-connections-in-job)をご覧ください。 |
| 制限事項 | ライセンスの互換性の問題のため、このコンポーネントの使用に必要な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)をご覧ください。 |