# Apache Spark BatchのtDataQualityRulesプロパティ

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

Spark BatchのtDataQualityRules コンポーネントは、データクオリティファミリーに属しています。

情報メモ重要: Talend Studio 8.0 R2025-06以降、標準コンポーネントであるtDataQualityRulesは、tDQRulesに置き換えられました。このコンポーネントによって、以下からのルールを使用できるようになります:

* Qlik Talend Data Integration。
* Talend Cloud Data Inventory。
* Talend Cloud Data Stewardship。
* Talend Data Stewardship 8.0 R2022-07以降のハイブリッドバージョン

Apache Sparkジョブの場合、Talendアプリで使用できるのはtDataQualityRulesのみです。

## 基本設定

| [Output schema] (出力スキーマ)および[Edit schema] (スキーマを編集) | スキーマは行の説明のことで、処理された後に次のコンポーネントに渡されるフィールド(カラム)の数を定義するものです。<br><br>ジョブで接続している先行コンポーネントからスキーマを取得するためには、[Sync columns] (カラムを同期)をクリックします。<br><br>[Schema] (スキーマ)のタイプを選択します。<br><br><ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul><br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br>[View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。<br><br>[Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。<br><br>[Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。<br><br>サポートされているタイプは、Boolean、Date、Double、Float、Integer、Long、Short、Stringです。 |
| --- | --- |
| アプリケーション | データクオリティルールの取得元としたいアプリケーションを選択します。<br><br>このオプションはTalend Studio 8.0 R2024-01以降で利用できます。 |
| [URL] | 情報メモ重要: ルールを取得するためには、[Rules - View] (ルール - 表示)権限が必要です。詳細は、使用しているアプリの[事前定義済みユーザーロール](https://help.qlik.com/talend/r/ja-JP/Cloud/management-console-user-guide/tmc-predefined-roles)をご覧ください。<br><br>選択したアプリのURLを入力します。選択したアプリとURLが一致しない場合、ジョブが失敗することがあります。サポートされているURLは次のとおりです。<br><br><ul> <li><span>Talend Cloud Data Stewardship</span>、または<span>Talend Data Stewardship</span> 8.0 R2022-07以降のハイブリッドバージョン <pre><code><pre><code><code>https://tds.&lt;env&gt;.cloud.talend.com/rulerepository/api/v1https://tds.&lt;env&gt;.cloud.talend.com/rulerepository/api/v1/https://tds.&lt;env&gt;.cloud.talend.com/rulerepositoryhttps://tds.&lt;env&gt;.cloud.talend.com/rulerepository/https://tds.&lt;env&gt;.cloud.talend.com (Only for <span>Talend Cloud Data Stewardship</span>)https://tds.&lt;env&gt;.cloud.talend.com/ (Only for <span>Talend Cloud Data Stewardship</span>)</code></code></pre></code></pre> <p>ハイブリッドバージョンを使う場合は、IPアドレスかホスト名でURLを使用できます:</p><div> <pre><code><pre><code><code>https://ip:19999/rulerepository/api/v1https://ip:19999/rulerepository/api/v1/https://ip:19999/rulerepositoryhttps://ip:19999/rulerepository/https://hostname:19999/rulerepository/api/v1https://hostname:19999/rulerepository/api/v1/         https://hostname:19999/rulerepositoryhttps://hostname:19999/rulerepository/</code></code></pre></code></pre> </div> </li> <li><span>Talend Cloud Data Inventory</span> (<span>Talend Studio</span> 8.0 R2023-06以降):<pre><code><pre><code><code>https://tdc.&lt;env&gt;.cloud.talend.com/rulerepository/api/v1https://tdc.&lt;env&gt;.cloud.talend.com/rulerepository/api/v1/https://tdc.&lt;env&gt;.cloud.talend.com/rulerepositoryhttps://tdc.&lt;env&gt;.cloud.talend.com/rulerepository/https://tdc.&lt;env&gt;.cloud.talend.comhttps://tdc.&lt;env&gt;.cloud.talend.com/ </code></code></pre></code></pre></li> </ul><br><br><br>&lt;env&gt;の部分にはお使いのクラウドリージョンが入ります。[Talend Cloudのアプリケーションにアクセス](https://help.qlik.com/talend/ja-JP/installation-guide-windows/Cloud/talend-cloud-application-url)をご覧ください。 |
| トークン | パーソナルアクセストークンを入力します。パーソナルアクセストークンを生成する場合は、[https://help.talend.com/r/ja-JP/Cloud/management-console-user-guide/cloud-access-token](https://help.qlik.com/talend/r/ja-JP/Cloud/management-console-user-guide/cloud-access-token)をご覧ください。 |
| [DQ rule library timestamp] (DQルールライブラリーのタイムスタンプ) | URLとトークンを入力したら、[Refresh] (更新)をクリックします。<br><br>URLとトークンが正しければ、データクオリティルールはyyyy-MM-dd hh:mm:ss (library\_number)という形式でTalend Studioに取得されます。<br><br>[Refresh] (更新)をクリックすると、ルール定義が含まれているJARファイルが以下で作成されます:<br><br>```<br>studio-path\configuration\.m2\repository\org\talend\libraries\rule-number<br>```<br><br>クラウドやハイブリッドバージョンでデータクオリティルールをアップデートする場合は、[Refresh] (更新)をクリックして最新バージョンを取得します。 |
| [Configure DQ rules] (DQルールを設定) | ルールの変数を入力データに関連付けます。<br><br>ルールはライブラリーから取得されます。<br><br><ul> <li><span>[DQ Rule] (DQルール)</span>: ルールを選択します。</li> <li><span>[Rule variable] (ルール変数)</span>: ルールの変数は自動的に取得されます。</li> <li><span>[Input column] (入力カラム)</span>: 変数を置き換える必要がある値が含まれているカラムを選択します。</li> </ul><br><br>利用できるルールや入力カラムがない場合は、次の点をご確認ください。<br><br><ul> <li><span>[DQ rule library timestamp] (DQルールライブラリーのタイムスタンプ)</span>でデータクオリティルールが取得されたこと</li> <li>入力スキーマが正しいこと</li> </ul><br><br>Talend Studioのデータ型は、アプリのデータ型の一部に関連付けることができます。下の[データ型を関連付け](https://help.qlik.com/talend/ja-JP/components/8.0/validation/tdqrules#associating-data-types)をご覧ください。<br><br>他のルールを適用する場合は、![プラス記号](https://help.qlik.com/talend/ja-JP/components/8.0/Resources/images/plus_button.png)をクリックします。 |

## データ型を関連付け

関連付けることができるデータ型は次のとおりです。

| アプリからのルール変数 \* | 入力カラム(Talend Studioより) |
| --- | --- |
| Number | Double、Float、Integer、Long、Short、String |
| ブール値 | ブール値 |
| Text | 文字列 |
| Date | Date |
| \* 次のURLを入力できます。<br><br><ul> <li><span>Talend Cloud Data Stewardship</span>。</li> <li><span>Talend Data Stewardship</span> 8.0 R2022-07以降のハイブリッドバージョン</li> <li><span>Talend Cloud Data Inventory</span> (<span>Talend Studio</span> 8.0 R2023-06以降)</li> </ul> |  |

## 詳細設定

| [tStatCatcher statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |
| --- | --- |