LookML 図は、Looker コンポーネントを使用して構築されたウェブ アプリケーションである拡張機能であり、Looker 拡張機能フレームワークを使用して開発され、Looker Marketplace を介してデプロイされています。
LookML 図は、LookML モデルのエンティティ関係図であり、LookML オブジェクト間の関係を視覚的に表しています。この拡張機能の用途:
- LookML モデルの構造を評価し、LookML を統合するエリアを特定し、モデルに追加する最適な方法を決定する
- 間違ったロジックを特定し、正しくない計算やクエリのパフォーマンス低下の可能性を低減
- コードベース(LookML)のデータ モデリングを行う方法について学習する
このドキュメントでは、LookML Diagram バージョン 2.0.0 以降を使用する方法について説明します。Looker 管理者は、LookML Diagram extension の構成に関するドキュメントを参照して、Looker ユーザー向けにこの拡張機能を有効にする方法を確認する必要があります。
このページでは、次の方法について説明します。
- LookML 図に移動する
- LookML オブジェクトの図を LookML 図で確認する
- 図を設定する
- Explore の表示オプションを構成する
- 図のキャンバスを解釈する
- Object Profiler を使用してオブジェクト情報をモニタリング
LookML 図に移動する
LookML 図をインストールしたら、左側のナビゲーション パネルの [Blocks] をクリックして [LookML Diagram] タイルを選択すると、LookML 図に移動できます。
LookML オブジェクトとの関係を LookML 図で確認する
Looker 管理者は、lookml_diagram
モデルと拡張機能で表示したいモデルに対する権限をユーザーに付与する必要があります。
LookML 図の拡張機能は以下の要素で構成されています。
- [Diagram Settings] パネルで、モデル、Git ブランチ、Explore を選択します。
- [View Options] パネルで、表示するフィールドを絞り込む
- 図に関するヘルプ セクション: 図の要素に関する詳しい説明を追加
- 選択した Explore 内の LookML オブジェクトを操作するための図のキャンバス
- 選択したフィールドの Explore のリストがビューでグループ化されている
- ズームや位置のオプションが表示されているツールバーと、キャンバスのミニマップを表示または非表示にするアイコンがあります。このアイコンは、拡大した図内の向きを調整します。
- LookML オブジェクトに関する情報を表示し、関連する LookML または Explore に移動する(該当する場合)Object Profiler
図の設定アイコンまたは表示オプションのアイコンをダブルクリックして、左側のパネルを閉じます。
図の設定を行う
図のナビゲーション バーの図のアイコンをクリックして、[Diagram Settings] を表示します。
[モデルを選択] プルダウンに、表示権限の権限があるすべてのモデルが表示されます。モデルを選択すると、次の 2 つの追加オプションが表示されます。
[現在のブランチ] プルダウンに、そのモデルの [Git ブランチ] のリストが表示されます。モデルに分岐(通常は本番環境ブランチ)が 1 つしかない場合は、その分岐が表示されます。本番環境モードの場合、または Git ブランチを変更する権限がない場合、[現在のブランチ] プルダウン メニューは無効になります。
管理者から LookML ダイアグラムで Git ブランチを変更する権限が付与されている場合、開発モードをオンにして、モデルと Explore の両方が選択されていることを確認し、そのブランチでモデルを設定する方法に応じてブランチを選択して図を表示します。
[Select a Explore] リストに、そのモデルの Explore のリストが表示されます。Explore の名前をクリックすると、そのフィールドがフィールド別に表示され、ページ キャンバスに表示されます。
表示オプションを確認する
Explore を選択している場合、[View Options] パネルを使用して、キャンバスに表示されるフィールドとビューを制限できます。
表示フィールドの制限
Explore の各ビューの全フィールドを表示するには、[Fields to Display] の [All fields] を選択します。または、他のフィールドと結合されているフィールドがあるビューのみを表示するには、[Fields with joins] を選択します。
[非表示のフィールドを非表示にする] の切り替えボタンは、基になる LookML に hidden: yes
が含まれているフィールドを非表示にします。[非表示項目を非表示にする] の切り替えボタンは、デフォルトでオンになっています。
表示制限
[View Options] パネルの [Views] セクションには、選択した Explore に存在するビューのリストが表示されます。デフォルトでは、すべてのビューが図のキャンバスに表示されます。ビューを非表示にすると、ビュー オブジェクトや、そのビュー オブジェクトを Explore 内の他のオブジェクトに接続している結合は、図のキャンバスに表示されなくなります。
[Hide all] をクリックすると、Explore のビューが図のキャンバスにすべて非表示になります。[すべて表示] をクリックすると、その Explore 内のすべてのビューが再表示されます。
ビュー名の右側にある目のアイコンの選択を解除して、キャンバス内の個々のビューを選択的に非表示にすることもできます。ビューが非表示になると、ビュー名がグレー表示され、目のアイコンにスラッシュが付きます。非表示の個々のビューを再表示するには、斜線のアイコンをクリックします。
図のキャンバスを解釈する
LookML 図キャンバスで、特定の Explore のすべてのエンティティと関係が描画されます。Looker の用語では、LookML の図を、特定のモデルの Explore で LookML オブジェクトをどのように結合するかを表すことができます。
キャンバスの上部にあるオブジェクトのタイトルバーには、キャンバスにビューが表示されている Explore の名前が表示されます。オブジェクト タイトル バーの [Explore Info] アイコン(丸で囲まれた [i])をクリックすると、Object Profiler が開き、選択した Explore の詳細が表示されます。時計回りの矢印をクリックして拡張機能を再読み込みします。
エンティティ
Explore の各ビューは、固有のエンティティ セットとして表され、ビュー名がセットの上部に表示されます。
- Explore のベースビューは暗い背景で示されます。
- Explore 内の結合ビューは背景が水色になります。
結合、ビュー、フィールドを選択すると、明るい青色でハイライト表示されます。
各ビューの下には、そのビューに属するフィールドのリストが表示されています。
ディメンションが上部に表示されます。
メジャーは下部に表示され、明るいオレンジ色でハイライト表示されます。
フィールドが主キーの場合は、フィールド名の右側に鍵アイコンが表示されます。
各フィールドの左側には、そのタイプを示すアイコンが表示されます。
- A:
type: string
のディメンション - #:
type: number
のディメンションまたはメジャー - 階層型バー:
type: tier
のディメンション - チェックマーク:
type: yesno
のディメンション - カレンダー:
type: date
、type: date_time
、type: time
のディメンション - マッピング ポイント:
type: location
、type: distance
、type: zipcode
のディメンション
フィールド名をクリックして Object Profiler を開き、選択したフィールドの詳細を確認します。
関係
この図では、線を使って、各オブジェクトと、選択したモデルの他のオブジェクトとの関係が示されています。ビューまたはフィールドに接続する線の形状は、2 つのオブジェクト間の関係のカーディナリティを表し、フォークした線は「多数」のカーディナリティを示し、1 つの線は「1」カーディナリティを示します。関係は、ベースビューから結合ビューへと読み取ります。例:
order_items
からinventory_items
への 1 対 1 の結合。id
フィールドで結合します。order_items
からrepeat_purchase_facts
への多対 1 の結合
行にカーソルを合わせると、2 つのオブジェクトを接続する結合の種類を確認できます。
行をクリックして Object Profiler を開き、結合の詳細を確認します。
キャンバスの表示オプション
キャンバスの右上にあるミニマップを使うと、配置図の向きを調整しやすくできます。また、地図内のグレー表示されている部分は、現在キャンバスに表示されている図を表しています。キャンバスの空いているスペースをクリックしてドラッグし、図の他の部分に移動します。
キャンバスの左下に垂直ツールバーが表示され、図の表示を制御するアイコンが表示されます。
- [+] をクリックすると拡大し、[-] をクリックすると縮小表示されます。
- 四角いアイコンをクリックすると、図のデフォルトの開始位置に戻ります。
- ミニマップを有効または無効にするには、地図アイコンをクリックします。
Object Profiler を使用してオブジェクト情報を表示する
Object Profiler に、選択したオブジェクトに関する情報が表示されます。図のキャンバスでいずれかの Explore、ビュー、フィールド、または結合をクリックして、キャンバスの右側に Object Profiler を開きます。キャンバスをクリックして Object Profiler を折りたたみます。
Explore
オブジェクト タイトル バーの右側にある、データ探索情報アイコン(丸で囲まれた「i」)をクリックします。
[Diagram Settings] パネルで選択された Explore について、Object Profiler が表示されます。
- ラベル: Explore
label
の値。 - グループラベル:
group_label
パラメータの値。Looker の [参照] メニューで Explore をカスタム グループに結合します。Explore にグループラベルが定義されていない場合、これはデフォルトでモデルの名前になります。 - プロジェクト名: プロジェクト設定で定義されている LookML プロジェクトの名前。
- 接続名:
connection
パラメータの値。モデルがデータを取得するデータベース接続を指定します。
LookML の表示権限がある場合は、Object Profiler の左下にある [Go to LookML] をクリックして Explore が定義されているファイルを開きます。新しいブラウザタブでファイルが開き、explore
の行がハイライト表示されています。
ビュー
図のキャンバスからビューをクリックします。
ビューに LookML が定義されている場合は、Object Profiler に SQL テーブル名が表示される。ビューに sql_table_name
が定義されていない場合、SQL テーブル名は unknown
として表示されます。
LookML を表示する権限がある場合は、Object Profiler の左下にある [Go to LookML] をクリックして、ビューを結合している Explore が定義されているファイルを開きます。新しいブラウザタブでファイルが開き、explore
の行がハイライト表示されています。
フィールド
図のキャンバスに表示されている項目をクリックします。
Object Profiler で、フィールド名、型、型の値、フィールドがパネルの主キーであるかどうかが表示されます。プロファイラの 2 つのタブ([Details] と [Code])に、項目に関する追加情報が表示されます。
[詳細] タブでは、以下の情報を確認できます。
- ビュー名: フィールドが属するビューの名前。
- ラベル: フィールドが Explore の [データ] セクションにどのように表示されるかです。ビューの名前またはラベルの後に、フィールドの名前またはラベルが続きます。
- 分布: メジャーのディメンションが
type: count
であるディメンションの場合は、[計算] をクリックして、カウント値の分布を示す縦棒グラフのプレビューを表示します。[分布] セクションには、数値ディメンション シリーズの最小値、最大値、平均値も表示されます。 - 値: メジャーのディメンションが
type: count
であるディメンションの場合は、[計算] をクリックしてカウント値のプレビューを表示します。[詳細] をクリックして、このフィールドが属する Explore を開きます。
[コード] タブでは、フィールド パラメータとサブパラメータを確認できます。
LookML を表示する権限がある場合は、オブジェクト プロファイラの左下にある [LookML に移動] をクリックして、結合が定義されているファイルを開きます。ファイルは、結合の Explore の行で新しいブラウザタブで開きます。
データ探索の権限が付与されている場合は、オブジェクト プロファイラの右下にある [Explore with Field] をクリックし、そのフィールドを事前に選択した Explore フィールド選択ツールで Explore を開きます。
結合
図のキャンバスから結合をクリックします。
Object Profiler では、結合の関係や、結合の種類とカーディナリティを記述する join ステートメントが表示されます。
LookML を表示する権限がある場合は、オブジェクト プロファイラの左下にある [LookML に移動] をクリックして、結合が定義されているファイルを開きます。ファイルは、結合の Explore の行で新しいブラウザタブで開きます。