Explore モデルの編集

データマネージャは、Explore のモデルを編集して、テーブルの追加、列プロパティの変更、ならびにフィルタ、式、およびパラメータのコンフィギュレーションを行うことができます。

既存のモデルの編集

モデルの編集権限がある場合は、以下の手順を実行します。

［データ］ワークスペースに移動します。
モデルの名前を選択し、［モデルを編集］を選択します。

Guidewire が作成したベースコンフィグレーションのモデルに対する編集権限はありません。これらのモデルをカスタマイズするには、次の手順を実行します。

モデルを開き、［Joins］を選択してソーステーブルを表示します。
新しいモデルを作成し、同じテーブルと列を新しいモデルに追加します。
テーブルと列を追加または削除して、モデルをカスタマイズします。

モデルへのテーブルの追加と削除

他のテーブルの列を使用する場合は、そのテーブルをモデルに結合できます。テーブルの列を使用しない場合は、そのテーブルを削除することもできます。

テーブルを追加するには、以下の手順を実行します。

［データ］ワークスペースに移動します。
モデルの名前を選択し、［モデルを編集］を選択します。
1 つ以上のテーブルをドラッグアンドドロップします。特定のテーブルを見つけるには、検索バーを使用するか、タグ別でフィルタするか、リストを並べ替えます。
1. テーブルレベルで既にテーブルが結合されている場合、それらの結合はモデル図に推奨として表示されます。結合アイコンを選択し、［Accept recommended join］を選択します。
2. テーブルに推奨される結合がない場合は、テーブルレベルでまだ結合が行われていないことを意味します。Explore で元のテーブルを編集して、結合を作成します。次に、テーブルとその推奨される結合をモデルに追加します。
  重要: モデル内で結合してもテーブル内では結合していない場合、キャズムトラップが作成されます。キャズムトラップがあると、検索結果内の基盤のデータを表示できなくなります。

テーブルを削除するには、モデル図で、テーブルの隅にある省略記号を選択し、［Remove table］を選択します。

モデルへの列の追加と削除

列を追加するには、以下の手順を実行します。

［データ］ワークスペースに移動します。
モデルの名前を選択し、［モデルを編集］を選択します。
［列］を選択し、サイドバーでテーブル名を展開して、そのすべての列を表示します。
1. テーブルのすべての列を追加するには、テーブル名をクリックして画面の中央にドラッグします。または、個々の列をクリックしてドラッグします。
2. 列を追加したら、赤色でハイライト表示されている列、つまり列名が重複している列がないか確認します。重複する列を削除するか、一意の名前を付けます。
3. 必要に応じて、列の名前を変更してビジネスフレンドリーなものにします。Explore により、列名は自動的に大文字に変更され、アンダースコアはスペースに置き換えられます。
4. ［変更の保存］を選択し、モデルにわかりやすい名前と説明を付けます。

列を削除するには、列の横にあるチェックボックスをオンにして、［削除］を選択します。

モデル列のプロパティ

モデルエディタの［列］タブで、編集するプロパティ値を選択します。または、列のプロパティを一括編集できます。デフォルト値は、Explore のソーステーブルから継承されます。Explore では、データ型と列の種類に基づいて一部のプロパティが自動的に設定されます。一部のプロパティは、列に関連していない場合、編集できません。

プロパティ	説明
Column name	検索に列を追加する場合、この名前を入力します。わかりやすい名前にしてください。
Source table name	このプロパティは編集できません。値が式の場合、列はモデルエディタの［Formulas］タブで作成されたカスタム数式から取得されます。
Source column name	このプロパティは編集できません。
説明	ユーザーがデータを検索して検索結果を作成すると、［Column information］パネルにこの説明が表示されます。
データ型	このプロパティは編集できません。
Column type	データが属性か数値データかを示します。数値データには、意味のある形で数学的処理を使用できる数値が含まれている必要があります。このプロパティは自動的に設定されますが、場合によっては修正する必要があります。例えば、郵便番号などの数字が Explore によって誤って数値データとして設定された場合、属性に変更できます。注: Guidewire では、このプロパティをテーブルレベルで設定して、テーブルを使用するすべてのモデルで一貫性を持たせることをお勧めします。
Additive	［Additive］が［はい］に設定されている場合、ユーザーはその列に対して `average`、 `min`、 `variance` などの計算を実行できます。
Aggregation	列にデフォルトの集計の種類を設定して、ユーザーがデータを検索するときに列を設定する必要がないようにすることができます。列が［Additive］：［はい］に設定されている場合は、より多くの集計の種類が使用可能です。注: Guidewire では、このプロパティをテーブルレベルで設定して、テーブルを使用するすべてのモデルで一貫性を持たせることをお勧めします。
Hidden	モデルの表示権限を持つユーザーに対して列を非表示にします。例えば、モデルのフィルタや数式で使用するために、モデルに列を追加できます。ただし、これらの列がレポートの作成に有用ではない場合は、非表示にすることができます。注: 編集権限を持つユーザーは、列を表示および使用できます。非表示の列を含む検索結果または Liveboard を作成した場合、すべてのユーザーがそのデータを確認できます。
Synonyms	同義語は、ユーザーが列を検索するときに異なる検索用語を使用する場合に役立ちます。列区切りリストに同義語を追加します。
Suggest values in search	ユーザーがデータを検索するときに、列の値を候補として表示するかどうかを指定します。例えば、 `Status` 列で検索を開始する場合、「`Bo`」と入力し始めると、値 `Bound` が候補として表示されます。
Geo config	列の地理データの種類を設定し、ジオマップグラフで使用できるようにします。このプロパティは、既定で［自動選択］に設定されています。グラフを作成するときに設定が不正確であることがわかった場合は、モデルに戻って Geo config プロパティを手動で設定する必要があります。
Index priority	列とその値が検索候補に表示される順序を決定します。これは、AI による回答を生成するときに Explore が優先する列にも影響します。デフォルトの優先度はすべての列で 1 です。1～10 までの数値に変更できます。
Format pattern	数値または日付の表示形式を設定します。有効な形式については、ThoughtSpot のドキュメント「Set number and date formats」を参照してください。
Currency type	通貨の表示形式を設定します。
Attribution dimension	［はい］に設定すると、キャズムトラップモデルによる二重カウントを防止できます。キャズムトラップは、ファクトテーブルがディメンションを共有していること以外に相互に直接的な関係を持たない場合に発生します。Explore では、テーブルがキャズムトラップを介して結合されている場合に属性のクエリが生成されると、このプロパティが自動的に設定されます。
SpotIQ preference	列を SpotIQ 分析に含めるかどうかを指定します。［デフォルト］の場合、列は含まれます。
Calendar type	カスタムカレンダーは作成できないため、このプロパティは編集できません。
Custom sort	列の値のカスタムの並べ替え順序を定義します。ユーザーは、この列を含むグラフを作成する際に、［英数字］の並べ替えから、この事前定義済みの［カスタム］の並べ替えに切り替えることができます。列区切りリストに値を順番に追加します。
デフォルトの日付バケット	日付列の日付間隔を、毎日、毎週、毎月、四半期ごとなどに設定します。ユーザーがこの列を使用してグラフを作成すると、デフォルトの日付バケットが使用されます。例えば、ある列で最もよく使用される日付間隔が毎月である場合、ユーザーは検索のたびに毎月を指定する必要はありません。必要に応じてデフォルトを上書きできます。

モデル列のカスタムグループ

ユーザーがデータを検索してモデルを選択すると、データパネルでは列がデフォルトグループ（数値データ、属性、日付）に整理されます。これらのデフォルトグループをカスタムのわかりやすいグループに置き換えたり、必要に応じて列をアルファベット順に並べたりして、ユーザーが探しているものを見つけやすくできます。カスタムグループを作成するには、モデルの TML（ThoughtSpot Modeling Language）を編集します。TML はモデルを定義するマークアップ言語です。

モデルを開きます。ただし編集はしないでください。
［詳細］ > ［TML］ > ［TML を編集］を選択します。
列グループを有効にするには、次の新しいセクションを TML に追加し、各グループ名を定義します。プロパティには、次のものがあります。
- status: ENABLE 列グループ機能を有効にします。
- default_sort: ENABLE 列を TML と同じ順序で並べ替えます。列をアルファベット順に並べるには、DISABLE に設定します。
- column_group_info: 各グループ名を定義します。
- include_ungrouped_columns: どのグループにも割り当てられていない列をどこに配置するかを Explore に指示します。1 つのグループを true に設定し、残りは false に設定する必要があります。
```
column_groups:
  - type: DATA_PANEL
    properties:
      status: ENABLE
      default_sort: ENABLE
    column_group_info:
    - name: My Group 1
      include_ungrouped_columns: false
    - name: My Group 2
      include_ungrouped_columns: false
    - name: My Ungrouped Columns
      include_ungrouped_columns: true
```
各列をいずれかのグループに割り当てます。次の構文を使用して、各列の TML に data_panel_column_groups プロパティを追加します。列を複数のグループに割り当てるには、カンマ区切りリストを使用します。次に例を示します。
```
- name: Transactiondate
    column_id: DIMDATE::TRANSACTIONDATE
    properties:
      column_type: ATTRIBUTE
      index_type: DONT_INDEX
    data_panel_column_groups: {My Group 1}
```
［検証］、［公開する］の順に選択します。

モデルの式

モデルエディタの［Formulas］タブでは、新しい計算列を作成できます。式は列としてモデルに追加されます。式関数の詳細については、ThoughtSpot のドキュメント「Formula function reference」を参照してください。

式では、データをマスクして、特定のグループに対して列の値を非表示にすることもできます。

モデルのフィルタ

モデルエディタの［フィルタ］タブでは、モデルに表示される行を制限できます。指定した値を含む行を除外するか含めることができます。次の場合にフィルタを作成します。

分析やレポートの役に立たない行を削除する。
特定のユーザーグループに対してデータを非表示にする。一部の列を除外したモデルのバージョンを 1 つ作成し、そのユーザーグループと共有します。また、異なるフィルタを使用してモデルの別バージョンを作成し、他のユーザーと共有することもできます。

重要: ［列］タブ（［フィルタ］タブではありません）で列を表示する場合は、テーブルヘッダーをクリックして［並べ替え］または［フィルター］を使用できます。これらの設定を使用すると、モデルエディタに表示される内容が変更されますが、モデルに永続的に適用されたり、ユーザーに影響したりすることはありません。

モデルのパラメータ

モデルエディタの［パラメータ］タブでは、パラメータ（調整可能な値のコンテナ）を作成して、後で数式や Liveboards で使用することができます。例えば、high、medium、low の値を含むパラメータを作成すると、ユーザーは Liveboard でこれらの値から選択できます。その後、「ユーザーがパラメータを high に設定した場合、XYZ の値を表示する」のように式でパラメータを参照できるようになります。

モデルレベルでパラメータを作成する必要はありません。ユーザーは、検索結果を作成するときに独自のパラメータを作成できます。ただし、次のような場合は、モデル内にパラメータを作成する必要があります。

パラメータを（1 つの検索結果だけでなく）Liveboard 全体に適用する。
モデル内の式でパラメータを使用する。

パラメータの詳細については、ThoughtSpot のドキュメント「Using parameters」を参照してください。

データモデル結合ルール

モデルエディタの［設定］タブでは、ユーザーの検索中に結合を適用する方法を選択できます。

Apply joins progressively (recommended for most cases)：ユーザーがモデルを使用して検索を作成する場合、結合は、検索に含まれる列を持つテーブルにのみ適用されます。
Apply all joins：実行可能な結合がすべて適用されます。

モデルの行レベルセキュリティの無効化

モデルエディタの［設定］タブでは、モデルの行レベルのセキュリティを無効にすることができます。 Row-Level Security (RLS) Bypass 役割が必要です。行レベルのセキュリティはテーブルレベルで作成され、モデルによって継承されるため、この設定を使用するとバイパスできます。RLS の詳細については、システム変数を使用してユーザーまたはグループからデータを非表示にするを参照してください。