# SQLカスタムインジケーターの作成 利用対象... * Big Data Platform * Cloud API Services Platform * Cloud Big Data Platform * Cloud Data Fabric * Cloud Data Management Platform * Data Fabric * Data Management Platform * Data Services Platform * Qlik Talend Cloud Enterprise Edition * Qlik Talend Cloud Premium Edition * Real-Time Big Data Platform Profilingパースペクティブでは、自分用にカスタマイズしたインジケーターを作成できます。 情報メモ要確認: カスタムインジケーターの管理手順は、システムインジケーターの管理手順と同じです。 ## インジケーターを定義 利用対象... * Big Data Platform * Cloud API Services Platform * Cloud Big Data Platform * Cloud Data Fabric * Cloud Data Management Platform * Data Fabric * Data Management Platform * Data Services Platform * Qlik Talend Cloud Enterprise Edition * Qlik Talend Cloud Premium Edition * Real-Time Big Data Platform ### 手順 1. [DQ repository] (DQリポジトリー)ツリービューで、[Libraries] (ライブラリー) > [Indicators] (インジケーター)と展開します。 2. [Custom Indicators] (カスタムインジケーター)を右クリックします。 ![カスタムインジケーターノードのコンテキストメニュー。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/Custom_Indicator.png) 3. コンテキストメニューから[New Indicator] (新規インジケーター)を選択します。 [New Indicator] (新規インジケーター)ウィザードが表示されます。 4. [Name] (名前)フィールドに、作成するインジケーターの名前を入力します。 情報メモ重要: ~ ! ` # ^ * & \\ / ? : ; \ , . ( ) ¥ ' " " " < > といった特殊文字は項目名に使用しないでください。 ファイルシステムでは、これらの文字はすべて"\_"に置き換えられ、重複する項目が作成されてしまう場合があります。 5. オプション: 該当するフィールドで、その他のメタデータ(目的、説明、作成者)を設定して[Finish] (終了)をクリックします。 ### タスクの結果 インジケーターエディターが開き、カスタムインジケーターのメタデータが表示されます。 ![インジケーターエディターの概要](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/Custom_Indicator3.png) ## インジケーター定義とカテゴリーの設定 利用対象... * Big Data Platform * Cloud API Services Platform * Cloud Big Data Platform * Cloud Data Fabric * Cloud Data Management Platform * Data Fabric * Data Management Platform * Data Services Platform * Qlik Talend Cloud Enterprise Edition * Qlik Talend Cloud Premium Edition * Real-Time Big Data Platform ### 手順 1. [Indicator Category] (インジケーターカテゴリー)セクションで、インジケーターのカテゴリーをリストから選択します。 カテゴリーによって、カスタムインジケーターを使用する分析の結果セットから予想されるカラムの数が決まります。 次のテーブルで、各カテゴリーを説明します。 | インジケーターカテゴリー | 説明 | 予想されるクエリー結果 | | --- | --- | --- | | [User-defined Count] (ユーザー定義カウント) (デフォルトのカテゴリー) | レコードの数を分析し、行数を返します。 | 結果セットは行数を含む1行と1カラムになります。 | | [User-defined Match] (ユーザー定義マッチング) | 条件にマッチングするデータの数を評価します。 | 結果セットは1行と2カラムになります。1番目のカラムにはマッチする値の数が、2番目のカラムには合計カウントが含まれます。 | | [User-defined Frequency] (ユーザー定義の間隔) | 個々のレコードに対してカスタムインジケーターを使用してレコードの頻度を評価します。 | 結果セットは0以上の行と2カラムになります。1番目のカラムには値が、2番目のカラムにはこの値の頻度(カウント)が含まれます。 | | [User-defined Real Value] (ユーザー定義の実数) | データの実ファンクションを評価します。 | 結果セットは実数を含む1行と1カラムになります。 | 2. [Indicator Definition] (インジケーター定義)セクションで、![\[Add\] (追加)](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/add.svg)をクリックします。 3. [Database] (データベース)リストから、インジケーターを使用するデータベースを選択します。 インジケーターがすべてのデータベースで利用できるほどシンプルなものである場合は、データベースリストで[Default] (デフォルト)を選択します。 4. [Version] (バージョン)フィールドにデータベースのバージョンを入力します。 5. 作成するインジケーターのSQLステートメントを定義します。 1. [SQL Template] (SQLテンプレート)フィールドの横にある[Edit...] (編集...)ボタンをクリックします。 [Edit expression] (式を編集)ダイアログボックスが開きます。 [Edit expression] (式を編集)[Edit expression] (式を編集)ダイアログボックスが開きます。 ![\[式を編集\]ダイアログボックスの概要。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/Custom_Indicator2.png) 2. [Indicator Definition] (インジケーター定義)タブに、データのマッチングや分析で使用するSQL式を入力します。[templates] (テンプレート)リストからテンプレートをドロップして式を完成できます。 ### 例 上のスクリーンショットのようにカラムの値の最大長を計算する式を設定できます。 このビューには選択されたインジケーターカテゴリーで予想される各カラムに対応するいくつかの入力フィールドがある場合があります。たとえば、[User-defined Count] (ユーザー定義カウント)カテゴリーを選択した場合は[Where Expression] (Where式)フィールドのみが表示されますが、[User -defined Match] (ユーザー定義マッチング)カテゴリーを選択した場合は、[Matching Expression] (マッチング式)および[Where Expression] (Where式)という2つのフィールドが表示されます。 SQL式は、[Full SQL Template] (完全SQLテンプレート)ビューで自動的に完全なSQLテンプレートに変換されます。 SQL式は、[Full SQL Template] (完全SQLテンプレート)[Full SQL Template] (完全SQLテンプレート)ビューで自動的に完全なSQLテンプレートに変換されます。 ![\[完全SQLテンプレート\]タブの概要。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/Custom_Indicator6.png) また、SQL式は自動的に行や値を表示するためのテンプレートに変換されます。選択されたインジケーターカテゴリーによってダイアログボックスで利用できるタブが変更されます。 また、SQL式は自動的に行や値を表示するためのテンプレートに変換されます。選択されたインジケーターカテゴリーによってダイアログボックスで利用できるタブが変更されます。 SQL式を[Indicator Definition] (インジケーター定義)ビューで編集する場合、それに応じて他のタブでもテンプレートがアップデートされます。 SQL式を[Indicator Definition] (インジケーター定義)[Indicator Definition] (インジケーター定義)ビューで編集する場合、それに応じて他のタブでもテンプレートがアップデートされます。 3. [Reset] (リセット)ボタンを使用すると[Indicator Definition] (インジケーター定義)タブのコンテンツに従ってすべてのテンプレートが元に戻ります。 4. OKをクリックします。 ダイアログボックスが閉じ、インジケーターエディターにSQLテンプレートが表示されます。 5. インジケーターの定義を必要な数だけ追加するためには、![\[Add\] (追加)](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/add.svg)ボタンをクリックして同じステップに従います。 情報メモ注: カスタムインジケーターに含まれるものがSQLテンプレートのみである場合は、[Indicator Parameters] (インジケーターパラメーター)ビューでパラメーターを定義する必要はありません。これらのパラメーターはインジケーターにJavaの実装が含まれる場合にのみ使用します。詳細は、[Javaカスタムインジケーターの作成](https://help.qlik.com/talend/ja-JP/studio-user-guide/8.0-R2025-12/creating-java-custom-indicators "Javaインジケーターは個人用に作成してカスタマイズできます。")をご覧ください。 6. エディターの上部にある保存アイコンをクリックします。 ### タスクの結果 インジケーターは、[DQ repository] (DQリポジトリー)ツリービューの[Custom Indicators] (カスタムインジケーター)フォルダーにリストされます。このインジケーターは、[DQ repository] (DQリポジトリー)ツリービューからエディターにリストされたカラムにドラッグ＆ドロップするだけで、分析済みカラムに対して使用できます。 カスタムインジケーターを使用した分析が一度でも正しく実行されれば、後でデータベースのインジケーター定義テンプレートが削除されても、分析は失敗しません。以前に生成されたSQLクエリーを使用するので、実行され続けます。