このページでは、ほとんどの Looker プロジェクトの重要なコンポーネントである、モデルファイルとビューファイルの概要について説明します。他の種類のプロジェクト ファイルについては、他のプロジェクト ファイルについてのドキュメント ページをご覧ください。プロジェクトのファイルへのアクセスについては、プロジェクト情報へのアクセスと編集に関するドキュメント ページをご覧ください。
モデルファイル
モデルファイルは、データベース接続と、その接続を使用する一連の Explore を指定します。また、ExploreそのものとExploreと他のビューの関係も定義します。
Explore は、データをクエリするための出発点です。SQL 用語では、Explore はクエリの FROM
句です。ユーザーがモデルに定義した Explore は、ユーザーが Looker の Explore メニューを見るときに表示されます。(Explore の詳細については、Looker でのプロジェクトの仕組みに関するドキュメントをご覧ください)。
つまり、モデルファイルは、使用するデータテーブル(ビューを含む)と、必要に応じて結合する方法を定義する場所です。
通常、Explore はモデルファイル内で定義されます。ただし、派生テーブル用に個別の Explore ファイルを使用したり、モデル間で Explore を拡張または絞り込みたりする必要がある場合があります。
構造と一般的な構文
Explore の中かっこ { }
内で、Explore のパラメータを定義します。join
パラメータを使用すると、モデルファイル内の Explore に他のビューを結合できます。
上の例では、モデルファイルに inventory_items
という explore
と結合ビューが表示されています。この LookML の定義では、Inventory Items が [Explore] メニューに表示され、inventory_items
のデータが products
と distribution_centers
に結合されます。
モデルファイル内の LookML 構造の詳細については、LookML の用語とコンセプトのドキュメントをご覧ください。
モデルファイルを作成する
ほとんどの LookML デベロッパーは、LookML プロジェクトがデータベース内の一連のテーブルから生成されるときに自動的に作成される 1 つ以上のモデルファイルから始めます。
あるいは、開発モードの Looker デベロッパーは、次の方法で空のモデルファイルを作成することもできます。
- [Create Model File] オプションを使用して Looker IDE でファイルを作成します(手順については、IDE でのフォルダの操作ドキュメントにあるファイルの作成をご覧ください)。
- ドラッグ&ドロップ機能を使用して、パソコンからファイルをアップロードします(手順については、IDE でのフォルダの操作に関するドキュメントのファイルのアップロードのセクションをご覧ください)。アップロードするファイルには、必ずファイル拡張子
.model.lkml
を使用してください。
モデルファイルは、Exploreの追加または削除、結合の指定、その他の機能の追加によって変更できます。
モデルやモデル内のオブジェクトの名前を変更する必要がある場合は、ファイル名やオブジェクト自体の名前を変更しないでください。代わりに、
label
パラメータまたはalias
パラメータを使用して、ファイルまたはオブジェクトの表示名を変更します。label
パラメータとalias
パラメータは、メールやその他のシステムで使用される基になる URL を保持しながら、表示名を変更します。一般に、モデルの変更による影響を可能な限り低減させないように対策を講じる必要があります。モデルまたはオブジェクトの名前を変更する必要がある場合は、コンテンツ バリデータを使用して、モデルまたはオブジェクトへのすべての参照を更新します。
モデルファイルを削除しても、そのモデルが属していたモデルセットからモデルは削除されません。削除されたモデルと同じ名前で新しいモデル ファイルを作成した場合、削除されたモデルを含むすべてのモデルセットに新しいモデルが含まれます。その結果、新しいモデルファイルへの不要なアクセス権が付与されることがあります。Looker 管理者は、この問題を防止するために、モデルセットを編集し、削除されたモデルを削除できます。
モデルファイルのパラメーターの詳細
モデルファイル内の LookML パラメータについて詳しくは、モデル パラメータ、Explore パラメータ、結合パラメータに関するドキュメント ページをご覧ください。
ビューファイル
ビューファイルは通常、Looker 内で単一の「ビュー」を定義します。ビューは、データベース内の単一のテーブルまたは単一の派生テーブルのいずれかに対応します。
ビューファイルは、クエリするテーブルおよびそのテーブルから取り込むフィールド(ディメンションおよびメジャー)を指定します。
構造と一般的な構文
各ビューの中かっこ { }
はフィールド定義であり、通常、基盤となるテーブルの列または Looker の計算に対応します。Looker のほとんどは、ディメンションまたはメジャーのいずれかに分類します。
上の図では、ディメンション id
が [Order Items] ビューのフィールドとして定義されています。この定義では、Order Items Explore のクエリ用の ID フィールドを公開します。
また、ディメンション グループを使用して、複数の時間ベースのディメンションをまとめて作成したり、フィルタ フィールドを使用してユーザーのフィルタを指定することもできます。ビューファイル内の LookML パラメータについて詳しくは、パラメータの表示に関するドキュメント ページをご覧ください。
ビューファイル内の LookML の構造について詳しくは、LookML の用語とコンセプトのドキュメントをご覧ください。
次元
Looker のフィールドは、ディメンションとメジャーに分割されます。ディメンションは、次の 2 つのうちのいずれかになります。
- 基になるテーブルの1つの列
dimension: first_name {
sql: ${TABLE}.first_name ;;
}
- その他のフィールドを基に計算された値
dimension: full_name {
sql: CONCAT(${first_name}, ' ', ${last_name}) ;;
}
Looker では、Looker が生成する SQL の GROUP BY
句に、常にディメンションが表示されます。
LookML では、さまざまなデータ型やフォーマットに対応するさまざまなディメンション タイプを定義できます。
メジャー
メジャーは、複数の行の値を計算します。これは、COUNT()
、SUM()
、AVG()
、MIN()
、MAX()
などの SQL 集計関数と同等です。メジャーは、他のメジャーに対して簡単な変換を実行することもできます。詳しくは、メジャータイプのドキュメントをご覧ください。
上記の例では、products
ビューファイルで定義されているディメンションとメジャーが表示されています。
ビューファイルを作成する
ほとんどの LookML デベロッパーは、1 つのビューファイルを使用して、LookML プロジェクトがデータベース内の一連のテーブルから生成されるときに自動的に作成されます。しかし、開発モードの Looker デベロッパーは、さまざまな方法で LookML プロジェクトにビューファイルを追加できます。
データベース内のテーブルに基づいてビューファイルを作成する。
- モデルの生成ドキュメント ページの説明に従って、データベースに初めて接続するときに、データベース テーブルからビューファイルを生成する。
- すでにデータベースに接続されているプロジェクトのデータベース テーブルからビューファイルを生成する。詳しくは、以下の既存のデータベース テーブルから新しいビューを追加するをご覧ください。
空白のビューファイルを作成する。
- IDE のフォルダの操作に関するドキュメントのファイルの作成セクションの説明に沿って、Looker IDE の [Create View File] オプションを使用する。
- IDE でのフォルダの操作に関するドキュメントのファイルのアップロード セクションで説明されているように、ドラッグ&ドロップ機能を使用して、パソコンからファイルをアップロードします。アップロードするファイルには、必ずファイル拡張子
.view.lkml
を使用してください。
派生テーブルのビューファイルを作成するには:
- 上のいずれかの方法で空のビューファイルから始めて、ネイティブ派生テーブルを作成するのドキュメント ページの LookML でのネイティブ派生テーブルの定義の説明に沿って、派生テーブルを手動で定義します。
- Looker で Explore から派生テーブル LookML を作成する。詳細については、Explore を使用してネイティブ派生テーブルを定義するで、ネイティブ派生テーブルの作成をご覧ください。
- SQL Runner を使用して派生テーブルを作成するのドキュメント ページで説明されているように、Looker で SQL Runner クエリから派生テーブル LookML を作成する。
新しいビューを使用するには、explore
パラメータを使用してモデルファイルにビューを追加するか、join
パラメータを使用してモデルファイル内の既存の Explore にビューを結合します。
既存のテータベーステーブルから新しいビューを追加する
開発モードで、既存のデータベース テーブルからビューファイルを作成できます。
プロジェクト内で、Looker IDE 内のプロジェクト ファイルリストの上部にある [+] をクリックするか、フォルダのメニューをクリックしてフォルダ内にファイルを作成します。
[テーブルからビューを作成] をクリックします。
Looker により、いずれかの接続に関連付けられているテーブルのリストが表示されます。接続を変更するには、左上の [Connection] プルダウンを使用します。
テーブル名の左側にあるチェックボックスをオンにして、ビューを作成するテーブルを選択します。このリスト内のデータベースやスキーマを折りたたんだり展開したりすることで、利用できるすべてのテーブルにアクセスできます。
ページの一番下までスクロールし、[ビューを作成] をクリックします。
テーブルのすべての列に対応するLookMLを含むビューが生成されます。
ビューファイルのパラメーターの詳細
ビュー パラメータの詳細については、パラメータの表示ドキュメント ページをご覧ください。
ディメンション、メジャー、ディメンション グループ、フィルタ フィールドの LookML パラメータについて詳しくは、フィールド パラメータのドキュメント ページをご覧ください。