データ製品におけるセマンティックモデルの管理

最終更新日時: 2026-11-11

データ製品内で、アナリティクスアプリケーションで利用できるデータ構造、リレーションシップ、メジャー、軸を定義するために、セマンティックモデルを作成および編集できます。

データ製品において、視覚的なモデリングインターフェイスを用いてセマンティックモデルが作成されます。データ製品のセマンティックモデルは、データにアクセス可能なあらゆるアナリティクス開発者が使用できます。データ製品がアクティブ化されると、セマンティックモデルがデータマーケットプレイスを通じて利用可能になり、本番環境でのユースケースに対応できる状態であることを示します。

前提条件

セマンティックモデルを作成する前に、次を確認してください。

データ製品を作成済みで、それに追加できるデータセットが少なくとも 1 つあること。

情報メモセマンティックモデルの作業を始める前にデータ製品にデータセットを追加することも、セマンティックモデルを開発しながらデータセットを追加することもできます。

「データ製品を作成する」を参照してください。
データ製品を編集する権限があること。

データ製品のロールと権限
データ製品内のデータセットに、セマンティックモデルに含めようとするテーブルとフィールドが含まれていること。

セマンティックモデルに情報を追加する

データ製品でセマンティックモデルを開発するには:

Launcher メニューから、 [カタログ] を選択し、セマンティックモデルで作業するデータ製品をクリックします。
データ製品の [セマンティックモデル] タブをクリックして、セマンティックモデルエディターを開きます。

セマンティックモデルエディターがビジュアルキャンバスで開きます。そこでは、リレーションシップ、メジャー、軸を定義できます。

テーブルヘッダーをクリックすると、データとその品質のプレビューが表示されます。

データセットからテーブルを追加する

テーブルは、セマンティックモデルの基盤となります。各テーブルは、データ製品内のデータセットからのデータを表します。

デフォルトでは、セマンティックモデルエディターはデータ製品にすでに存在するテーブルを表示しますが、必要に応じてテーブルを追加できます。

テーブルを追加する方法:

セマンティックモデルエディターで、 [テーブル] タブに移動し、 [データの追加] をクリックします。
開いたカタログウィンドウから、追加するテーブルを含む 1 つ以上のデータセットを選択し、 [確認] をクリックします。

テーブルまたは複数のテーブルがキャンバス上に表示されます。このプロセスを繰り返して、セマンティックモデルに追加のテーブルを追加します。

リレーションシップの定義

リレーションシップは、一致するフィールドに基づいてテーブル同士を関連付け、データ全体にわたる連関的なクエリを可能にします。キャンバス上で、それらはテーブル間を接続する線として表示されます。

リレーションシップを作成するには、次を実行します。

[リレーションシップを作成] ボタンを使用します。
1. リレーションシップを作成するテーブルのヘッダーをクリックします。または、リレーションシップを作成する特定のフィールドをクリックします。
2. 開いた右パネルで、[リレーションシップ +] ボタンをクリックします。
3. ドロップダウンメニューを使用して、リンクする 2 つのテーブルの名前と、それらの一致するフィールドの名前を選択します。
4. 名前を追加し、 [リレーションシップのカーディナリティ] (リレーションシップタイプ) を選択します。リレーションシップタイプの変更はオプションです。
  フィールド間のリレーションシップタイプには次が含まれます。
  - 一対一: 最初のテーブル内の 1 つのレコードが、2 番目のテーブルの 1 つのレコードに対応します。
  - 一対多: 最初のテーブル内の 1 つのレコードが、2 番目のテーブルの複数のレコードに対応します。
  - 多対多: 最初のテーブル内の複数のレコードが、2 番目のテーブル内の複数のレコードと一致する可能性があります。
  - 多対一: 最初のテーブル内の複数のレコードが、2 番目のテーブル内の 1 つのレコードと一致します。
5. 必要に応じて、説明を追加します。
6. [適用] をクリックします。
ドラッグアンドドロップを使用します。
1. フィールドにマウスを合わせ、フィールドの側面に表示されるノードのいずれか 1 つをクリックしたままにします。
2. ノードをもう一方のテーブルの該当するフィールドまでドラッグアンドドロップして、リレーションシップを作成します。
提案を検討し、検証します。
Qlik は自動的にリレーションシップを提案します。
- テーブル間で同じまたは類似の名前を共有するフィールド。
- Qlik Talend Data Integration データパイプラインのダウンストリームにあるデータ製品の場合、 [セマンティックモデル] を編集する際に、ソースパイプラインからの元のリレーションシップが提案として提供されます。
  これらの提案は、あくまで出発点です。パイプラインでモデル化されたすべてを常に反映しているわけではありません。そのため、内容を確認し、不足しているリレーションシップがあれば手動で追加してください。制限事項の詳細については、「データ統合パイプラインによるリレーションシップの提案の制限事項」を参照してください。
次の手順を実行します。
1. 左パネルの [提案] タブを開きます。
2. 提案されたリレーションシップを確認します。次の操作が可能です。
  - 提案を受け入れる。
  - 提案の [根拠] を展開し、詳細を確認する。例: フィールド名の一致によるものか、アップストリームの Qlik Talend Data Integration データパイプラインで定義されたリレーションシップによるものなのか、など。
  - 提案を閉じる。

接続するフィールドが互換性のあるデータタイプを持ち、利用するアプリケーションでリレーションシップが正しく機能するために一致する値を含んでいることを確認してください。

軸の作成

軸は、アナリティクスアプリケーションでデータを分類およびグループ化するために使用されるフィールドです。

軸の作成方法:

左パネルの [軸] タブをクリックし、 [軸を作成] をクリックします。
軸に名前を入力します。例: 製品名。
[フィールド] ドロップダウンリストを使用して、軸の参照フィールド(Product など) を選択します。または、 [Fx] ボタンをクリックして、本格的な数式エディターを開きます。式の記述方法の詳細については、「式の記述」を参照してください。
必要に応じて、軸の目的を文書化するための記述を入力し、タグを追加します。
必要に応じて、 [用語集] で、 [用語集の用語をリンク] をクリックして、その軸を 1 つ以上の用語集の用語にリンクします。
1. リストから既存の用語を選択するか、 [新しい用語を作成] から、軸にリンクされる新しい用語を追加します。
2. 用語と軸のリレーションシップを選択します。
  - 定義: 用語には軸の定義が含まれます。定義として設定できる用語は 1 つだけです。
  - 関連: 用語は軸に関連しています。複数の用語を関連用語としてマスターアイテムにリンクできます。
3. 完了したら、 [選択] をクリックします。
4. [さらに追加] をクリックして、必要に応じて用語を追加します。
[適用] をクリックします。

軸はセマンティックモデルに追加され、利用するアプリケーションでマスター軸として表示されます。

メジャーの作成

メジャーは、セマンティックモデルを使用するアプリケーションでマスターアイテムとして表示される、計算されたメトリクスです。

メジャーの作成方法:

左パネルの [メジャー] タブをクリックし、 [メジャーを作成] をクリックします。
メジャーの名前を入力します。例: 合計売上。
[集計] と [フィールド] のドロップダウンリストを使用して、メジャーの背後にある式のパラメーターを選択します。例: Sum および Amount など。または、 [Fx] ボタンをクリックして、本格的な数式エディターを開きます。式の記述方法の詳細については、「式の記述」を参照してください。
必要に応じて、メジャーの目的を文書化するための記述を入力し、タグを追加します。
メジャーの [数値書式] のオプションを選択します。
- 設定される
- Number
- Money
- Date
- 期間
- 数式の評価:
情報メモ[カスタム] オプションは利用できません。
必要に応じて、 [用語集] で、 [用語集の用語をリンク] をクリックして、そのメジャーを 1 つ以上の用語集の用語にリンクします。
1. リストから既存の用語を選択するか、 [新しい用語を作成] から、メジャーにリンクされる新しい用語を追加します。
2. 用語とメジャーのリレーションシップを選択します。
  - 定義: 用語にはメジャーの定義が含まれます。定義として設定できる用語は 1 つだけです。
  - 関連: 用語はメジャーに関連しています。複数の用語を関連用語としてマスターアイテムにリンクできます。
3. 完了したら、 [選択] をクリックします。
4. [さらに追加] をクリックして、必要に応じて用語を追加します。
[適用] をクリックします。

メジャーがセマンティックモデルに追加されます。アプリケーションがセマンティックモデルを消費すると、メジャーは視覚化で直接使用できるマスターメジャーとして表示されます。

メジャーには、明確で記述的な名前を使用し、アナリティクス開発者がその目的を簡単に理解できるようにしてください。適切な場合は、名前に集計関数を含めます。例: 「平均注文額」や「総売上数」など。

式の記述

式エディターでは、Qlik アナリティクス構文を使用して、カスタムのメジャー式と軸式を作成できます。エディターの左側にあるパネルから、[フィールド] と [関数] を利用できます。

セマンティックモデル編集インターフェイスの式エディター

式でのフィールド名の使用に関する留意事項

リレーションシップで使用されるフィールドを参照する場合、式はリレーションシップによって定義された新しいフィールド名を使用する必要があります。たとえば、リレーションシップが異なる名前の 2 つのフィールドを接続する場合、新しいフィールド名は元のフィールド名の組み合わせを使用します。たとえば、Date と Order Date のフィールド間のリレーションシップは、新しいフィールド名 OpenDate-Date となる可能性があります。

これらの新しいフィールド名は、式エディターの [フィールド] セクションに表示されます。セマンティックモデルのキャンバス上でフィールドをクリックして、新しいフィールド名を見つけることもできます。新しいフィールド名は、Qlik アプリケーションでのフィールド名として表示されます。

セマンティックモデル内のリレーションシップベースのフィールドの、期待されるフィールド名を確認する

セマンティックモデルを編集する

セマンティックモデルを編集するための以下のアクションは、データ製品の有効化の前でも後でも実行できます。

左パネルの [テーブル] タブを使用してテーブルを追加します。
テーブルを選択した後、右パネルでリレーションシップを作成、編集、または削除します。
左パネルの [軸] と [メジャー] タブを使用して、軸とメジャーを追加、編集、または削除します。
式または記述を更新します。

セマンティックモデルへの変更は、利用するアプリケーションが次回リロードした際に利用可能になります。アプリケーションがワイルドカードセレクターで自動インクルードモードを使用している場合、新しいフィールド、軸、メジャーが自動的に含まれます。

式を検証する

完全な式エディターを使用してメジャーと軸を作成または編集する際、式が検証され、正しい構文を使用し、有効なフィールドを参照していることが確認されます。

式にエラーが含まれている場合:

メジャーまたは軸は警告インジケーターでマークされています。
エラーメッセージには、「フィールドが見つかりません」または「無効な構文」などの問題の内容が示されます。
エラーが発生している箇所で、その式が強調表示されます。

検証エラーを修正するには:

エラーメッセージを確認し、問題を把握します。
問題を修正するには、式を編集します。
関数名と構文が、Qlik 式構文ルールに従っていることを確認してください。
メジャーまたは軸を保存して、式を再検証します。

検証エラーのあるメジャーと軸は保存できますが、利用するアプリケーションで正しく機能しない可能性があります。データ製品を本番環境でのユースケースで利用可能にする前に、すべての検証エラーを解決してください。

データ製品のアクティブ化

データ製品内のセマンティックモデルが本番環境でのユースケースに対応できる状態になったら、アクティブ化できます。「データ製品をデータマーケットプレイスでアクティブ化する」を参照してください。

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

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

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

データ製品におけるセマンティック モデルの管理