カスタム SQL を使用した Direct Query アプリの作成

Direct Query アプリのカスタム SQL クエリを使用して、ロードスクリプトでデータモデルを作成します。カスタム SQL は、データモデルマネージャーを使用して Direct Query のデータモデルを定義するための代替手段を提供します。

カスタム SQL を使用して Direct Query データモデルを作成すると、SQL ステートメントを使用して SQL クエリ自体によって生成されるテーブルと項目を定義できます。さらに、Qlik アプリのカスタム SQL ステートメントでは、ロードスクリプト変数と Qlik 数式マクロを使用できます。これにより、より動的なデータモデルが可能になり、カスタム SQL で定義したテーブルと列を変数または数式の評価結果に応じて調整できるようになります。

カスタム SQL は、ロードスクリプト内で単独で使用できます。データロードエディターでデータモデルマネージャーとカスタム SQL を組み合わせて使用して、データモデルを定義することもできます。

データモデルの一部をデータモデルマネージャーで指定できる場合は、SQLのパフォーマンスを最適化するためにデータモデルマネージャーを使用してそれらの一部を指定します。データモデルマネージャーは、定義されたデータモデルで Direct Query クエリを実行するときに使用するテーブル定義において、より効率的です。

カスタム SQL を使用してデータモデルを作成するには:

ロードスクリプトに section directquery を追加します。

ロードスクリプト内に存在できる SECTION DIRECTQUERY セクションは 1 つだけです。このセクションは、ロードスクリプトの最後のセクションである必要があります。

データモデルマネージャーでデータモデルを定義していない場合でも、ロードスクリプトに LIB CONNECT ステートメント、section directquery ステートメントの順に追加してスクリプトをロードすると、アプリが Direct Query アプリに変わります。
次のステートメントを使用してデータモデルを構築します。
- SELECT
  
  SELECT ステートメントを使用して、ロードするテーブルと列を選択します。例: <TableName> SELECT <custom SQL>。
  
  ロードスクリプトで独自のテーブル名を定義しない場合、テーブルには Table<スクリプトのライン番号> という名前が付けられます。
  
  Select
- CREATE RELATIONSHIP
  
  CREATE RELATIONSHIP を使用して、データモデルの項目とテーブル間の関係を定義します。
  
  Create relationship
- DROP RELATIONSHIP
  
  DROP RELATIONSHIP を使用して、以前に定義したリレーションシップをデータモデルからドロップします。
  
  リレーションシップのドロップ
- DROP TABLE
  
  DROP TABLE を使用して、以前に定義したテーブルをデータモデルからドロップし、テーブル間の競合の可能性を回避します。
- LET、 SET
  
  LET および SET ステートメントを使用して、変数または Qlik 数式を定義します。
  
  Let
  
  Set
データモデル全体を通して、テーブルと項目には一意の名前を付ける必要があります。データモデルマネージャーでテーブルを定義し、そのテーブルをカスタム SQL で再定義しようとすると、データモデルマネージャーで作成したテーブルをドロップするか、カスタム SQL でテーブルと項目の名前を変更しない限り失敗します。

section directquery セクション内でサポートされていないスクリプトステートメントは、データのロード時にエラーを生成します。スクリプトのデバッグや強制続行の設定はすべて無視されます。

カスタム SQL ロードスクリプトの例については、「Direct Query のカスタム SQL の例」を参照してください。

カスタム SQL、変数、数式

Direct Query のカスタム SQL 定義を使用すると、カスタム SQL ステートメント内でスクリプト変数と Qlik 数式マクロの両方を使用できます。

この機能により、アプリのデータモデルに動的な変数と数式の影響と柔軟性がもたらされ、カスタム SQL 定義のテーブルと列は変数または Qlik 数式の評価結果に適応します。

カスタム SQL の変数

SET または LET ステートメントを使用して変数を定義します。$(<variable name>) 形式を使用して、ロードスクリプトに変数を追加します。

例: 変数を含むデータモデルを構築する

カスタム SQL の変数参照はリロード時に評価されます。アプリの使用中に変数値が変更された場合、スクリプトのリロードが実行されない限り、その変数を使用するカスタム SQL には変更が反映されません。

カスタム SQL 定義で動的変数を使用する場合は、Qlik 数式の一部として変数を参照し、カスタム SQL 定義を使用するすべてのクエリ実行で変数が強制的に評価されるようにします。

変数の詳細については、「データロードエディタでの変数の使用」を参照してください。

カスタム SQL の数式

数式を使用して、リモートデータベースに送信されるカスタム SQL の内容を変更し、アプリのデータモデル内のテーブルと列を表すことができます。データモデルで使用される式は、単一の値に解決される必要があります。

数式が単一の値に評価されるかどうかをテストするには、KPI に数式として追加します。うまく機能する場合は、カスタム SQL で数式を使用できます。

数式は、これらの SQL 定義を使用するすべてのクエリ実行で動的に評価されます。クエリの実行中にテーブルまたは項目のカスタム SQL ステートメントで Qlik 数式が使用されるたびに、それらの Qlik 数式が最初に評価され、数式の現在の結果が取得されます。これらの結果は、元のクエリに代わって実行されるカスタム SQL ステートメントに挿入されます。Qlik 数式のこれらの評価により、リモートデータベースへの SQL クエリが生成される可能性があります。Qlik 数式のこれらの評価により、リモートデータベースへの SQL クエリが生成される可能性があります。

ロード中に数式の展開に失敗した場合は、null 値が返されます。これは、数式が無効であることを意味するものではありません。数式を評価するには、アプリ内でユーザーによる選択が必要になる場合があります。

例: Qlik 数式を使用してデータモデルを構築する

カスタム SQL とデータモデルマネージャーを使用したデータモデルの作成

カスタム SQL とデータモデルマネージャーを組み合わせて、Direct Query のデータモデルを作成できます。ただし、現実的な考慮事項がいくつかあります。

ベストプラクティスとして、ロードスクリプトにカスタム SQL を追加する前に、データモデルマネージャーで実行するモデリングを完了してください。カスタム SQL とデータモデルマネージャーは、ロードされたテーブルと項目間の関係を定義するためにデータモデルマネージャーを使用し、追加のカスタマイズにカスタム SQL を使用する場合に併用するのが最適です。
データモデルマネージャーによって作成されたデータモデルの部分とカスタム SQL によって作成された部分は個別に管理され、スクリプトのリロード時に結合されます。データモデルマネージャーは、カスタム SQL によって定義されたデータモデルを表示しません。完全なデータモデルを表示するには、データモデルビューアーを使用します。
データモデルマネージャーによって作成されたデータモデルとカスタム SQL によって定義されたデータモデルは、同じデータベース接続を使用する必要があります。
データモデルマネージャーによってロードスクリプトに追加された IMPORT LIVE ステートメントを移動できます。ロードスクリプトは順番に評価されるため、新しい位置がカスタム SQL 要件に影響を与える可能性があります。たとえば、最終的なデータモデルに不要なリレーションシップが作成されたり、テーブル名が重複したりする可能性があります。
データモデル全体を通して、テーブルと項目には一意の名前を付ける必要があります。データモデルマネージャーでテーブルを定義し、そのテーブルをカスタム SQL で再定義しようとすると、データモデルマネージャーで作成したテーブルをドロップするか、カスタム SQL でテーブルと項目の名前を変更しない限り失敗します。

制限事項

Direct Query のカスタム SQL には次の制限があります。

カスタム SQL では単一のデータベースのみを使用できます。
Qlik 数式マクロが埋め込まれた 1 つ以上のカスタム SQL ステートメントを使用する Direct Query アプリは、On-Demand アプリの選択アプリとして使用できません。生成されたテンプレートアプリはインメモリアプリであるため、ロードスクリプトで Qlik 数式マクロをサポートできないためです。
Direct Query カスタム SQL は、ハブに追加されたスクリプトではサポートされていません。スクリプトの詳細については、「スクリプトエディタの使用」を参照してください。

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。

こちらにフィードバックをお寄せください