# tDQRules / tDataQualityRules Talend StudioをQlik Talend Data IntegrationまたはTalendアプリに接続させ、データクオリティルールを使ってデータを検証します。 情報メモ重要: 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のみです。 各アプリ詳細は、 対応するドキュメンテーションをご覧ください: * Qlik Talend Data Integrationについては、Qlik Cloudのドキュメンテーションで[検証ルールの操作](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/Working-with-validation-rules.htm)をご覧ください。 * Talend Cloud Data Stewardshipについては、Talend Cloud Data Stewardshipユーザーガイドで[データクオリティルールとは](https://help.qlik.com/talend/r/ja-JP/Cloud/data-stewardship-user-guide/tds-dqr)をご覧ください。 * Talend Data Stewardship 8.0 R2022-07以降のハイブリッドバージョンについては、Talend Data Stewardshipユーザーガイドの[データクオリティルールとは](https://help.qlik.com/talend/r/ja-JP/8.0/data-stewardship-user-guide/tds-dqr)をご覧ください。ハイブリッドの詳細は、[Talend Cloudのハイブリッドとは](https://help.qlik.com/talend/r/ja-JP/Cloud/hybrid-installation-guide-windows/what-is-hybrid-for-talend-cloud)をご覧ください。 * Talend Cloud Data Inventoryについては、Talend Cloud Data Inventoryユーザーガイドで[データクオリティルールとは](https://help.qlik.com/talend/r/ja-JP/Cloud/data-inventory-user-guide/data-quality-rules)をご覧ください。このアプリにはTalend Studio 8.0 R2023-06以降で接続できます。 データクオリティルールとは、データが準拠すべき値を定義したビジネス要件のセットのことです。 データクオリティルールを取得してJARファイルにロードするため、tDQRulesはTalend Studioを上記のいずれかのアプリに接続させます。Talend Studioは取得されたライブラリーを使うので、データクオリティルールを自分のデータに適用できます。このコンポーネントがTalendアプリと共に動作するしくみについては、[ローカルとクラウド/ハイブリッドプロセスの説明](https://help.qlik.com/talend/ja-JP/components/8.0/validation/tdqrules-local-cloud-process "Talend StudioからQlik Talend Data Integrationへ、またはTalendアプリに接続すれば、データクオリティルールを取得できます。")をご覧ください。 コンポーネントがデータを返すカテゴリーとサブカテゴリーは次のとおりです: | 出力カテゴリー | tDataQualityRules | tDQRules | | --- | --- | --- | | [Valid] (有効)

そのようなデータは[Main] (メイン)フローに従います。 | | 条件と検証式を満たすデータ、または代替の検証式のみを満たすデータ。 | | [Invalid] (無効)

そのようなデータは[Reject] (リジェクト)フローに従います。 | |

。 | | 該当なし

これらのデータはNot\_Applicableフローに従います。 | このコンポーネントには該当しません | データが条件を満たしていません。このデータにはルールを適用できません。 | 複数のルールが使用される場合、データは各ルールの結果と使用しているコンポーネントに基づいて分類されます。次の表は、検証ロジックの結果を示しています。 tDQRulesの検証ロジックtDQRulesの検証ロジック | | [Valid] (有効) | [Invalid] (無効) | 該当なし | | --- | --- | --- | --- | | [Valid] (有効) | [Valid] (有効) | [Invalid] (無効) | [Valid] (有効) | | [Invalid] (無効) | [Invalid] (無効) | [Invalid] (無効) | [Invalid] (無効) | | 該当なし | [Valid] (有効) | [Invalid] (無効) | 該当なし | tDataQualityRulesの検証ロジックtDataQualityRulesの検証ロジック | | [Valid] (有効) | [Invalid] (無効) | 該当なし | | --- | --- | --- | --- | | [Valid] (有効) | [Valid] (有効) | [Invalid] (無効) | [Valid] (有効) | | [Invalid] (無効) | [Invalid] (無効) | [Invalid] (無効) | [Invalid] (無効) | | 該当なし | [Valid] (有効) | [Invalid] (無効) | [Valid] (有効) | デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。 tDQRules / tDataQualityRulesコンポーネントを使用するためには、Qlik Talend Cloud Enterprise Editionが必要です。 Apache Spark tDataQualityRulesは、以下をサポートします: * Apache Spark 3.0以降(ローカルモードの場合) * Apache Spark 3.1または 3.2を伴うCloudera Data Engineeringサービス ## 標準プロパティ これらのプロパティは、標準ジョブのフレームワークで実行されているtDQRulesとtDataQualityRulesを設定するために使われます。 標準のtDQRulesコンポーネントとtDataQualityRulesコンポーネントは、データクオリティファミリーに属しています。 情報メモ重要: tDataQualityRulesを使用している場合は、[tDataQualityRulesの基本設定](https://help.qlik.com/talend/ja-JP/components/8.0/validation/tdqrules#basic-tdataqualityrules)をご覧ください。Talend Studio 8.0 R2025-06以降、このコンポーネントはtDQRulesと統合されていますが、tDataQualityRulesのプロパティは同じです。これらのプロパティは、使用しているバージョンには依存しません。 ## tDQRulesの基本設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | Cloud | ルールの取得元としたいアプリを選択します:



[Apply] (適用)をクリックし、他の設定を有効にします。

Talend Cloud Data InventoryまたはStewardshipを選択し、tDataQualityRulesを使用している場合は、[tDataQualityRulesの基本設定](https://help.qlik.com/talend/ja-JP/components/8.0/validation/tdqrules#basic-tdataqualityrules)をご覧ください。 | | [Property Type] (プロパティタイプ) | ファイルパスとスキーマの設定方法を選択します。

| | [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマは行の説明のことで、処理された後に次のコンポーネントに渡されるフィールド(カラム)の数を定義するものです。

ジョブで接続している先行コンポーネントからスキーマを取得するためには、[Sync columns] (カラムを同期)をクリックします。

[Schema] (スキーマ)のタイプを選択します。



スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。

[View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。

[Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

[Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

サポートされているタイプは、Boolean、Date、Double、Dynamic、Float、Integer、Long、Short、Stringです。 | | URL | 情報メモ重要: ルールを取得するためには、[Rules - View] (ルール - 表示)権限が必要です。

アプリのURL (https://qcs.us.qlikcloud.com/など)を入力します。 | | API key (APIキー) | APIキーを入力します。APIキーの生成については、[APIキーを生成](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-generate-api-keys.htm)をご覧ください。 | | [Rule library timestamp] (ルールライブラリーのタイムスタンプ) | URLとトークンを入力したら、[Fetch rules] (ルールをフェッチ)をクリックします。

URLとトークンが正しければ、ルールはyyyy-MM-dd hh:mm:ss (library\_number)という形式でTalend Studioに取得されます。

[Fetch rules] (ルールをフェッチ)をクリックすると、ルール定義が含まれているJARファイルが以下で作成されます:

```
studio-path\configuration\.m2\repository\org\talend\libraries\rule-number
```

アプリでルールをアップデートする時は、[Fetch rules] (ルールをフェッチ)をクリックして最新バージョンを取得します。 | | [Rule name] (ルール名) | このオプションは、Talend Studio 8.0 R2025-12まで利用可能です。

リストからルールを選択し、[Refresh table] (テーブルを更新)をクリックします。 | | ルール | このオプションはTalend Studio 8.0 R2026-01以降で利用可能です。

1つ以上のルールを選択し、[Refresh table] (テーブルを更新)をクリックしてください。 | | [Rule content] (ルールコンテンツ) | ルールの変数を入力データに関連付けます。

ルールはライブラリーから取得されます。




利用できるルールや入力カラムがない時は、次の点をご確認ください:

| ## tDataQualityRulesの基本設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | Cloud | このオプションはTalend Studio 8.0 R2025-06以降で利用可能です。


ルールの取得元としたいアプリを選択します:



[Apply] (適用)をクリックし、他の設定を有効にします。

Qlik Talend Cloud Data Integrationを選択し、tDQRulesを使用している場合は、[tDQRulesの基本設定](https://help.qlik.com/talend/ja-JP/components/8.0/validation/tdqrules#basic-tdqrules)をご覧ください。 | | [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマは行の説明のことで、処理された後に次のコンポーネントに渡されるフィールド(カラム)の数を定義するものです。

ジョブで接続している先行コンポーネントからスキーマを取得するためには、[Sync columns] (カラムを同期)をクリックします。

[Schema] (スキーマ)のタイプを選択します。



スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。

[View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。

[Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

[Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

サポートされているタイプは、Boolean、Date、Double、Dynamic、Float、Integer、Long、Short、Stringです。 | | アプリケーション | データクオリティルールの取得元としたいアプリケーションを選択します。 1つまたは複数のルールを選択できます。 | | URL | 情報メモ重要: ルールを取得するためには、[Rules - View] (ルール - 表示)権限が必要です。

選択されたアプリのURL (Qlik Talend Data Integrationの場合はhttps://qcs.us.qlikcloud.com/など)を入力します。

Talendアプリの場合は、次のURLがサポートされています:

| | [Token] (トークン) | トークンを入力します。トークンを生成する場合は、[パーソナルアクセストークンを生成](https://help.qlik.com/talend/r/ja-JP/Cloud/management-console-user-guide/cloud-access-token)をご覧ください。 | | [DQ rule library timestamp] (DQルールライブラリーのタイムスタンプ) | URLとトークンを入力したら、[Refresh] (更新)をクリックします。

URLとトークンが正しければ、ルールはyyyy-MM-dd hh:mm:ss (library\_number)という形式でTalend Studioに取得されます。

[Fetch rules] (ルールをフェッチ)をクリックすると、ルール定義が含まれているJARファイルが以下で作成されます:

```
studio-path\configuration\.m2\repository\org\talend\libraries\rule-number
```

クラウドやハイブリッドバージョンでルールをアップデートする場合は、[Refresh] (更新)をクリックして最新バージョンを取得します。 | | [Configure DQ rules] (DQルールを設定) | ルールの変数を入力データに関連付けます。

ルールはライブラリーから取得されます。



利用できるルールや入力カラムがない場合は、次の点をご確認ください。



Talend Studioのデータ型は、アプリのデータ型の一部に関連付けることができます。下の[データ型を関連付け](https://help.qlik.com/talend/ja-JP/components/8.0/validation/tdqrules#associating-data-types)をご覧ください。

他のルールを適用する場合は、![\[Add\] (追加)アイコン](https://help.qlik.com/talend/ja-JP/components/8.0/Resources/images/add.svg)をクリックします。 | ## データ型を関連付け 関連付けることができるデータ型は次のとおりです。 | アプリからのルール変数 \* | 入力カラム(Talend Studioより) | | --- | --- | | Number | Double、Float、Integer、Long、Short、String | | ブール値 | ブール値 | | Text | 文字列 | | Date | Date | | アプリケーションでサポートされる任意のデータ型 | ダイナミック | | \* 次のURLを入力できます。

| | Qlik Talend Data Integrationについては、[データクオリティルールを使って作業](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/Working-with-validation-rules.htm#operators)で、アプリでサポートされているタイプをご覧ください。 tDQRulesコンポーネントで日付/時刻演算子を使用する場合、一部の単語は予約語であるため、カラム名として使用することはできません。詳細については、[Language definition](https://github.com/google/cel-spec/blob/master/doc/langdef.md)を参照してください。 ## Advanced Settings (詳細設定) | [Properties] (プロパティ) | 説明 | | --- | --- | | [tStatCatcher statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |