# tOracleValidRows

Data Qualityパターン(正規表現)に基づいてOracleデータベース行をチェックします。

tOracleValidRowsでは、特定のData QualityパターンにマッチするDB行を抽出できます。

デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。

## tOracleValidRowsの標準プロパティ

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

標準のtOracleValidRowsコンポーネントは、データクオリティファミリーとデータベースファミリーに属しています。

このコンポーネントは、Talend Data Management Platform、Talend Big Data Platform、Talend Real-Time Big Data Platform、Talend Data Services Platform、Talend Data Fabricで利用できます。

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

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| データベース | 目的のデータベースタイプをリストから選択し、[Apply] (適用)をクリックします。 |
| [Validation type] (検証タイプ) | [Regex pattern validation] (正規表現パターンの検証)または[DQ rule validation] (DQルールの検証)のいずれか。<br><br><ul> <li> <p> <span>[Regex pattern validation] (正規表現パターンの検証)</span>: データベース内のデータを正規表現パターンに基づいて検証します。</p> </li> <li> <span>[DQ rule validation] (DQルールの検証)</span>: データベース内のデータをDQルールに基づいて検証します。</li> </ul> |
| [Regex pattern validation] (正規表現パターンの検証) | <ul> <li> <p> <span>[Analyzed column] (分析カラム)</span>: 分析するカラムをスキーマリストから選択します。 </p> </li> <li> <span>[Custom pattern] (カスタムパターン)</span>: このチェックボックスをオンにして、DB行をチェックするための独自のカスタマイズされた正規表現を手動で定義します。</li> <li> <p> <span>[Pattern list] (パターンリスト)</span>: パターンリストからDB行をチェックするためのパターンを選択します。</p> </li> </ul> |
| [DQ rule validation] (DQルールの検証) | <ul> <li> <p> <span>[DQ rule list] (DQルールリスト)</span>: DB行をチェックするためのルールをリストから選択します。</p> </li> <li> <div> <span>[Query type] (クエリータイプ)</span>: <span>[Buiilt-in] (組み込み)</span>と<span>[Repository] (リポジトリー)</span>のいずれかです。 <ol> <li> <span>[Built-in] (組み込み)</span>: 手動でクエリーステートメントを入力するか、SQLBuilderを使ってグラフィカルに作成します。</li> <li> <span>[Repository] (リポジトリー)</span>: <span>リポジトリー</span>に保管されている関連クエリーを選択します。[Query] (クエリー)フィールドはそれに従って入力されます。</li> </ol> </div> </li> <li> <p> <span>[Guess query] (クエリーを推測)</span>: <span>[Guess Query] (クエリーを推測)</span>ボタンをクリックして、クエリーフィールド内のテーブルスキーマに対応するクエリーを生成します。</p> </li> <li> <p> <span>[Guess Schema] (推測スキーマ)</span>: <span>[Guess Schema] (推測スキーマ)</span>ボタンをクリックして、テーブルからスキーマを取得します。</p> </li> <li> <p> <span>[Query] (クエリー)</span>: DBクエリーを入力します。フィールドの順序に気を付けて、スキーマ定義と一致するようにしてください。</p> </li> </ul> |
| [Property type] (プロパティタイプ) | <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 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] (接続タイプ) | 使えるドライバーのドロップダウンリスト: |
| [DB Version] (データベースバージョン) | 使用しているOracleバージョンを選択します。 |
| [Host] (ホスト) | データベースサーバーのIPアドレス。 |
| [Port] (ポート) | データベースサーバーのリスニングポート番号。 |
| [Database] (データベース) | データベースの名前。 |
| [Oracle schema] (Oracleスキーマ) | Oracleスキーマの名前。 |
| [Username] (ユーザー名)と[Password] (パスワード) | データベースユーザー認証データ。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | <ul> <li> <p>スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは<span>[Built-in] (組み込み)</span>か、<span>[Repository] (リポジトリー)</span>にリモートで保存されます。</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> </ul> |
| [Table Name] (テーブル名) | 読み取るテーブルの名前を入力します。 |
| [Where clause] (Where句) | WHERE句を入力して、テーブル内に行フィルターを定義します。<br><br>テーブル内の分析する行をフィルタリングするには、WHERE句を使用します。このWHERE句で、指定した条件に一致する有効なデータと無効なデータを取得できます。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Additional JDBC Parameters] (追加のJDBCパラメーター) | 作成するデータベース接続の接続の追加プロパティを指定します。このオプションは、[Basic settings] (基本設定)の[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は利用できません。<br><br>情報メモ注:<br><br>事前定義済みのグローバル変数のリストにアクセスするには、Ctrl + スペースを押します。 |
| [Convert XML type to Java Type] (XML型をJava型に変換) | このチェックボックスをオンにしてから、テーブルを使い、定義されたカラムのタイプをJavaタイプに変換します。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。 |
| [Use cursor] (カーソルの使用) | このチェックボックスをオンにすると、指定された時に作業する行数を指定できます。このオプションにより、パフォーマンスを最適化できます。 |
| [Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング) | すべてのStringカラム/Charカラムの先頭や末尾の空白を削除する場合は、このチェックボックスをオンにします。 |
| [Trim column] (カラムをトリミング) | 定義されたカラムから先頭や末尾の空白を削除します。<br><br>情報メモ注:<br><br>[Trim column] (カラムをトリミング)を有効にするには、[Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング)をオフにします。 |
| [No null values] (null値なし) | null値がない場合にこのボックスをオンにすると、パフォーマンスが向上します。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | NB\_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。<br><br>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)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、開始または中間ステップとして使用できます。出力フローが必要です。 |