Looker Data Dictionary 是擴充功能,也就是使用 Looker 元件建構的網頁應用程式,採用 Looker 擴充功能架構開發,並透過 Looker Marketplace 部署。
Looker Data Dictionary 擴充功能提供專屬的集中式介面,可搜尋所有 Looker 欄位和說明。使用這個擴充功能執行下列工作:
- 提供可搜尋的指標和說明目錄,方便使用者找出適合用於分析的維度或指標。
- 讓外部利害關係人找出並找出獨特指標。
- 檢查 LookML 模型,評估是否遵循一致的命名慣例、是否有重複的欄位,或是否為欄位加上說明註解。
- 新增及分享特定欄位的註解 (如果 Looker 資料字典應用程式為 2.0.0 以上版本)。
如要讓使用者存取及使用 Looker 資料字典,Looker 管理員必須執行下列步驟:
使用者可使用擴充功能後,您可以執行下列操作:
安裝 Looker 資料字典
Looker 管理員必須先啟用以下功能,才能從Marketplace安裝 Looker Data Dictionary:
- Marketplace:存取 Looker Marketplace (預設為啟用)
- 擴充功能架構:部署使用 Looker 擴充功能架構開發的擴充功能 (預設為啟用)
如要從 Marketplace 安裝應用程式和工具 (例如擴充功能),您必須具備 develop
、manage_models
和 deploy
權限。
如要瞭解如何從 Looker Marketplace 安裝工具,請參閱「使用 Looker Marketplace」說明文件。如要確保您隨時都能使用最新版本的資料字典,請前往 Looker Marketplace,選取「管理」,然後選取擴充功能旁的「更新」按鈕。
授予存取 Looker 資料字典的權限
安裝 Looker 資料字典後,系統會自動將名為 data-dictionary
的模型加入「新模型集合」和「編輯模型集合」頁面中可用的模型清單,您可以透過「管理」面板中的「角色」頁面存取這些模型。
Looker 管理員必須授予使用者 explore
或 develop
權限,才能存取 data-dictionary
模型,以及他們在資料字典中需要探索的任何模型。如要瞭解如何授予使用者存取及使用 Looker 擴充功能的權限,請參閱「設定 Looker 擴充功能的權限」說明文件。
授予與欄位註解互動的權限
欄位註解可讓使用者在不需要更新任何 LookML 的情況下,為欄位定義新增相關資訊。根據預設,所有可存取資料字典擴充功能的使用者都能查看所有留言,並新增、編輯及刪除自己的留言。
如有需要,Looker 管理員可以在「管理」面板的「群組」頁面中建立特定使用者群組,並將使用者指派給這些群組,藉此管理使用者與欄位註解功能的互動方式。如要進一步瞭解如何將使用者指派給群組,請參閱「群組」說明文件頁面。
建立使用者群組時,必須使用下表「群組名稱」欄中顯示的預先定義名稱。表格也會顯示已指派給各群組的使用者將擁有的預先定義權限。
如果使用者不屬於上述任何群組,則預設為 writer
。如果使用者同時屬於多個群組 (不含 marketplace_data_dictionary_comments_disabled
),則會優先採用權限較高的群組。
透過「管理」面板中的「群組」頁面所做的留言群組變更 (例如新增或移除使用者),會在您重新整理資料字典頁面,或使用者選取其他選項後返回資料字典頁面時生效。
前往 Looker 資料字典
您可以從左側邊欄的已安裝應用程式和擴充功能清單,前往資料字典。
使用 Looker 資料字典查看模型中繼資料
在 Looker 資料字典中,擁有模型 explore
權限的使用者可以選取這個模型,並查看其中繼資料,包括探索和每個探索的欄位清單,並按檢視畫面分組。Looker 資料字典會在左側欄中顯示所選模型的 Explore,並在頁面的主要部分顯示所選 Explore 的檢視畫面和欄位。
使用者可以選取 < 圖示,收合側欄。
Looker Data Dictionary 會顯示以下資訊:
- 所選模型的名稱
- 所選模型包含的探索清單
- 所選探索
- 用於篩選探索中欄位的文字欄位
- 快速篩選器可根據所選特徵縮小顯示的欄位
- 檢視畫面的名稱
- 每個欄位的中繼資料。選取「View Options」按鈕,即可選取要顯示的中繼資料。在欄位分析工具中查看欄位的完整中繼資料集。
- 列:包含指定檢視畫面中每個欄位中繼資料的資料列
- 在 Looker UI 中前往「探索」
選取模型和探索
「Select a Model」下拉式選單會列出使用者具備 explore
權限的所有模式。從「Select a Model」下拉式選單中選擇模型後,左側邊欄會填入該模型的探索清單。
您也可以在「搜尋模型」搜尋框中輸入內容,在所選模型中搜尋特定探索。系統會篩選「探索」清單,只顯示符合搜尋字詞的結果。
選取探索名稱,即可在頁面的主要部分查看按檢視畫面分組的欄位。
您也可以選取右上角的「探索」按鈕,直接前往 Looker 的「探索」頁面。
在探索中篩選欄位
如要篩選顯示的欄位,請在「探索」中的「篩選欄位」方塊中輸入文字,以比對欄位清單的「欄位標籤」或「說明」。
您也可以選取要篩選的特定中繼資料屬性,例如欄位是否符合下列條件:
查看欄位中繼資料
Looker Data Dictionary 會顯示探索欄位的中繼資料,並依檢視畫面分組:
- 欄位標籤:根據欄位的
label
參數指定的欄位名稱 - 類別:欄位類別,可做為維度或評估值
- 說明:根據欄位的
description
參數提供欄位說明 - LookML 名稱:
view_name.field_name
語法中的欄位名稱 - 類型:欄位類型為 字串、數字、日期、郵遞區號、計數、加總、平均值、清單或不含引號,取決於欄位的
type
參數 - SQL:參照該欄位的 SQL 運算式
- 標記:與該欄位相關聯的 LookML 標記
自訂顯示的中繼資料
您可以選取右上角的「View Options」按鈕,然後勾選或取消勾選要查看的中繼資料方塊,指定每個欄位要顯示哪些中繼資料。
使用欄位註解
LookML 開發人員通常會在欄位層級的 description
參數中,加入模型欄位的其他資訊或說明。不過,這些說明不一定對所有使用者都具有意義或實用。使用者可以透過欄位層級註解,為特定欄位提供相關資訊。其他使用者可以查看這些註解,但不會影響模型的底層 LookML。
管理員必須在「管理」面板的「群組」頁面中,將使用者加入特定群組,授予使用者與留言互動的權限。根據預設,所有可存取資料字典擴充功能的使用者都能查看所有留言,並新增、編輯及刪除自己的留言。
新增欄位註解
如要在欄位中新增註解,請按照下列步驟操作:
- 將滑鼠游標懸停在欄位上,即可顯示 + 圖示 (如果沒有現有的欄位註解) 或記事本圖示 (如果欄位已有現有的註解)。按一下圖示,開啟欄位分析器面板的「Comments」分頁。
- 按一下「新增留言」按鈕。
- 輸入註解,然後選取「註解」按鈕即可儲存內容。按一下「取消」關閉欄位分析器。只要選取並拖曳右下角,即可展開留言方塊。
新增註解後,會顯示在欄位剖析工具的「Comments」分頁中,其他使用者可查看。
查看欄位註解
如果欄位包含註解,畫面上會顯示筆記本圖示,並顯示該欄位中的註解數量。按一下記事本圖示,即可在欄位分析工具的「Comments」分頁中查看欄位的註解。
該欄位的留言數也會在「留言」分頁中以括號表示。每個留言項目都會顯示下列資訊:
- 評論者的姓名
- 顯示新增留言時間的時間戳記
- 留言預覽
編輯或刪除欄位註解
如要編輯或刪除自己的欄位註解,請按照下列步驟操作:
- 選取欄位的記事本圖示。
- 在「留言」分頁中,找出要編輯或刪除的留言,並將滑鼠游標懸停在該留言上。
- 點選三點選單,然後選取「編輯留言」來編輯留言,或選取「刪除留言」來刪除留言。如果要刪除評論,請確認你的意圖。
- 如果要編輯留言,請在變更完成後選取「儲存」。
分享欄位註解
每個欄位的「Comments」分頁網址皆不重複,您可以複製該網址,並與其他可存取 Looker 資料字典中該模型的使用者分享。
使用欄位 Profiler
按一下特定欄位列,即可開啟欄位剖析器面板,其中會顯示欄位的完整中繼資料、可預覽數值維度值的選項,以及可前往 Looker IDE 或「探索」頁面的按鈕。
在「分布」部分中,選取「計算」,即可預覽資料欄圖表,顯示在包含 type: count
的報表中,數值維度的計數值分布情形。「分布」部分也會顯示數值維度序列的最小值、最大值和平均值。
在「值」下方,選取「計算」,即可在包含含有 type: count
的指標的檢視畫面上,預覽數值維度的計數值。選取「探索更多」按鈕,開啟「探索」使用者介面,其中的欄位挑選器會預先選取數值維度和計數量測項目。
選取「Go to LookML」,即可在 Looker IDE 中開啟與所選模型相關聯的 LookML 專案檢視檔案。
選取「探索」按鈕,開啟「探索」頁面,並自動選取欄位挑選器中的該欄位。