Looker のデータ ディクショナリは、データ ディクショナリ ブロックとは異なります。
Looker データ ディクショナリの拡張機能のすべての機能を利用するには、管理者が Looker データ ディクショナリ アプリケーションをバージョン 2.0.0 以降に更新する必要があります。
Looker データ ディクショナリは、Looker 拡張フレームワークを使用して開発され、Looker Marketplace を通じてデプロイされた拡張機能（Looker コンポーネントを使用して構築されたウェブ アプリケーション）です。
Looker データ ディクショナリ拡張機能は、すべての Looker フィールドと説明を検索するための専用の一元化されたインターフェースを提供します。この拡張機能を使用すると、次のことができます。
- ユーザーがすべての指標と説明を検索可能なディレクトリを提供し、ユーザーが分析に適切なディメンションやメジャーを特定できるようにする
- 外部の関係者がそれぞれの固有の指標を簡単に識別し場所を特定できる
- LookML モデルを監査して、一貫した命名規則に従っているか、冗長なフィールドがあるか、フィールドに説明がアノテーションされているかを評価する
- 特定のフィールドに関するコメントを追加して共有する（Looker データ ディクショナリ アプリケーションがバージョン 2.0.0 以降の場合）
ユーザーが Looker データ ディクショナリにアクセスして使用するには、Looker 管理者が次の作業を行う必要があります。
拡張機能がユーザーに利用可能になると、以下のことが可能になります。
Looker データ ディクショナリをインストールする
Marketplace から Looker データ ディクショナリをインストールする前に、Looker 管理者は次の機能を有効にする必要があります。
- Marketplace: Looker Marketplace にアクセスする（デフォルトで有効）
- 拡張フレームワーク: Looker 拡張フレームワークを使用して開発された拡張機能をデプロイする（デフォルトで有効）
アプリケーションやツール（拡張機能など）を Marketplace からインストールするには、develop、manage_models および deploy 権限が必要です。
Looker Marketplace からツールをインストールする手順については、Looker Marketplace の使用のドキュメントをご覧ください。Looker Marketplace に移動して [管理] を選択し、拡張機能の横にある [更新] ボタンを選択すると、常に最新バージョンのデータ ディクショナリを最新の状態に保つことができます。
Looker データ ディクショナリにアクセスするための権限を付与
Looker データ ディクショナリをインストールすると、data-dictionary というモデルが、[管理] パネルの [ロール] ページからアクセスできる [新しいモデルセット] ページと [モデルセットの編集] ページの使用可能なモデルのリストに自動的に追加されます。
Looker 管理者がユーザーに、data-dictionary モデルと、データ ディクショナリで探索する必要があるすべてのモデルにアクセスするための explore または develop 権限を付与する必要があります。ユーザーへの拡張機能へのアクセスと使用権限の付与については、Looker 拡張機能の権限の設定ドキュメント ページをご覧ください。
フィールド コメントを操作する権限を付与
フィールド コメントを使用すると、LookML を更新しなくても、フィールド定義にコンテキストを追加できます。デフォルトでは、データ ディクショナリの拡張機能にアクセスできるすべてのユーザーが、すべてのコメントを表示したり、自分のコメントの追加、編集、削除を行ったりできます。できます。
必要に応じて、Looker 管理者は [管理] パネルの [グループ] ページで特定のユーザー グループを作成し、ユーザーをそのグループに割り当てることで、フィールド コメント機能の操作方法を管理できます。グループへのユーザーの割り当てについて詳しくは、グループのドキュメントをご覧ください。
Looker 管理者は、以下に示すように事前定義されたグループを使用してこれらのグループを作成する必要があります。
ユーザー グループは、次の表に示す定義済みの名前で作成する必要があります。この表には、各グループに割り当てられたユーザーの事前に定義した権限も示されています。
いずれのグループにも属していないユーザーは、デフォルトで writer になります。ユーザーが複数のグループ（marketplace_data_dictionary_comments_disabled を除く）に割り当てられている場合、昇格した権限が優先されます。
コメント グループの変更（ユーザーの追加や削除など）が、[管理者] パネルの [グループ] ページで行われた場合、その変更はデータ ディクショナリ ページをハード再読み込みするか、ユーザーが別のオプションを選択してデータ ディクショナリのページに戻った後に反映されます。
Looker データ ディクショナリへの移動
左側のサイドバーに、インストールされたアプリケーションと拡張機能のリストから、データ ディクショナリに移動できます。
Looker データ ディクショナリを使用したモデル メタデータの表示
Looker データ ディクショナリでは、モデルに対する explore 権限を持つユーザーが、このモデルを選択し、そのメタデータ（Explores や各 Explore のビューでグループ化された フィールドのリストなど）を表示できます。Looker データ ディクショナリでは、選択したモデルの Explore が左側のサイドバーに表示され、選択した Explore のビューとフィールドがページのメイン部分に表示されます。
ユーザーは、< アイコンを選択してサイドバーを折りたたむことができます。
Looker データ ディクショナリには次の情報が表示されます。
- 選択したモデルの名前
- 選択したモデルに含まれる Explore のリスト
- 選択した Explore
- Explore のフィールドをフィルタリングするテキスト フィールド
- 選択した特性に基づいて表示フィールドを絞り込むためのクイック フィルタ
- ビュー名
- 各フィールドに関するメタデータ。[表示オプション] ボタンを選択して、表示するメタデータを選択します。フィールドのフィールド プロファイラでメタデータの完全なセットを確認してください。
- 特定のビューの各フィールドのメタデータを含む行
- Looker UI の Explore へのナビゲーション
モデルと Explore の選択
[モデルの選択] プルダウンには、ユーザーが explore 権限を持っているすべてのモデルが一覧表示されます。[モデルの選択] プルダウン メニューからモデルを選択すると、左側のサイドバーにそのモデルの Explore のリストが表示されます。
[モデルの検索] 検索ボックスに入力して、特定のモデルの特定のモデルを検索することもできます。Explore のリストがフィルタリングされ、検索キーワードに一致する結果のみが表示されます。
Explore の名前を選択すると、フィールドがビュー別にグループ化されて、ページのメイン部分に表示されます。
また、右上隅の Explore ボタンをクリックすると、直接 Locker の Explore ページに進めます。
Explore のフィールドのフィルタリング
表示されているフィールドをフィルタリングするには、[Filter fields in this Explore] ボックスにテキストを入力して、フィールドの [フィールド ラベル] または [説明] のリストと照合します。
フィルタリングする特定のメタデータ属性（フィールドの有無など）を選択することもできます。
フィールド メタデータの表示
Looker データ ディクショナリでは、Explore のフィールドのメタデータがビューごとにグループ化されて表示されます。
- フィールド ラベル: フィールドの
labelパラメータに従ったフィールド名 - カテゴリ: フィールド カテゴリ、ディメンションまたはメジャー
- 説明: フィールドの
descriptionパラメータに従ったフィールドの説明 - LookML 名:
view_name.field_name構文のフィールド名 - 型: フィールド の
typeパラメータに基づく文字列、数値、日付、郵便番号、数、合計、平均、リスト、または引用符で囲まれていないとしてのフィールド型 - SQL: そのフィールドを参照する SQL 式
- タグ: そのフィールドに関連付けられた LookML タグ
表示されるメタデータのカスタマイズ
各フィールドに表示するメタデータを指定するには、右上の [表示オプション] ボタンを選択し、表示するメタデータのチェックボックスをオンまたはオフにします。
フィールド コメントの使用
インスタンスにすでに Marketplace がある場合、フィールド レベルのコメントを使用するには、管理者がデータ ディクショナリの拡張機能がバージョン 2.0.0 以降であることを確認する必要があります。
LookML デベロッパーは、多くの場合、フィールド レベルの description パラメータにモデルのフィールドに関する追加情報や説明を含めます。ただし、この説明が必ずしもすべてのユーザーにとって有用で役立つとは限りません。フィールド レベルのコメントを使用すると、特定のフィールドにコンテキストを追加できます。これらのコメントは他のユーザーが表示できますが、モデルの基盤となる LookML には影響しません。
管理者は、[管理] パネルの [グループ] ページでコメントを特定のグループに追加して、そのコメントを操作するための機能をユーザーに付与する必要があります。デフォルトでは、データ ディクショナリの拡張機能にアクセスできるすべてのユーザーが、すべてのコメントを表示したり、自分のコメントの追加、編集、削除を行ったりできます。できます。
フィールド コメントの追加
フィールドにコメントを追加するには:
- フィールドの行にカーソルを合わせると、+ アイコン（既存のフィールド コメントがない場合）またはメモ帳アイコン（フィールドに既存のコメントがある場合）が表示されます。アイコンをクリックすると、フィールド プロファイラ パネルの [コメント] タブが開きます。
- [コメントを追加] ボタンをクリックします。
- コメントを入力して [コメント] ボタンを選択し、エントリを保存します。[キャンセル] をクリックしてフィールド プロファイラを閉じます。コメント ボックスを展開するには、右下隅を選択してドラッグします。
コメントが追加されると、フィールド プロファイラの [コメント] タブに表示され、他のユーザーから閲覧可能になります。
フィールド コメントの表示
フィールドにコメントが含まれている場合、そのフィールドに存在するコメントの数を示すメモ帳アイコンが表示されます。メモ帳アイコンをクリックすると、フィールド プロファイラの [コメント] タブに表示されるフィールドのコメントが表示されます。
このフィールドのコメント件数も、[コメント] タブにかっこ付きで表示されます。各コメント エントリには、次の情報が表示されます。
- コメント投稿者の名前
- コメントが追加された日時を示すタイムスタンプ
- コメントのプレビュー
フィールド コメントの編集または削除
自分のフィールド コメントを編集または削除するには:
- フィールドのメモ帳アイコンを選択します。
- [コメント] タブで、編集または削除するコメントにカーソルを合わせます。
- その他メニューをクリックし、[コメントを編集] を選択してコメントを編集するか、[コメントを削除] を選択してコメントを削除します。コメントを削除する場合は、本当に削除するかを確認します。
- コメントを編集する場合、変更を加えたら [保存] を選択します。
フィールドのコメントを共有する
各フィールドの [コメント] タブの URL は一意であり、Looker データ ディクショナリでコピーして、そのモデルにアクセスできる他のユーザーと共有できます。
フィールド プロファイラの使用
特定のフィールド行をクリックすると、ページの右側にフィールド プロファイラ パネルが開き、フィールドのメタデータ セット全体が表示されます。また、数値ディメンション値をプレビューするオプションと、[Looker IDE] ページまたは [Explore] ページにアクセスするボタンが表示されます。
Looker データ ディクショナリ拡張機能のバージョン 2.0.0 以降を使用している場合は、デフォルトでフィールド プロファイラの [詳細] タブが開きます。
分布セクションで、計算を選択すると、type: count を持つメジャーを含むビュー上の数値ディメンションのカウント値の分布を示す縦棒グラフのプレビューが表示されます。また、[Distribution] セクションには数値ディメンションの最小値、最大値、平均値も表示されます。
[値] で [計算] を選択すると、type: count があるメジャーでビューに数値ディメンションの数のプレビューが表示されます。[もっと見る] ボタンを選択すると、フィールド ピッカーで事前に選択された数値ディメンションとカウント メジャーとともに Explore UI が開きます。
[LookML に移動] を選択して、Looker IDE 選択したモデルに関連付けられている LookML プロジェクトからビューファイルを開きます。
[Explore with Field] ボタンを選択すると、[Explore] ページが開き、フィールド ピッカーからそのフィールドが自動的に選択されます。