使用 Looker 資料字典

Looker Data Dictionary 是擴充功能,也就是使用 Looker 元件建構的網頁應用程式,採用 Looker 擴充功能架構開發,並透過 Looker Marketplace 部署。

Looker Data Dictionary 擴充功能提供專屬的集中式介面,可搜尋所有 Looker 欄位和說明。使用這個擴充功能執行下列工作:

  • 提供可搜尋的指標和說明目錄,方便使用者找出適合用於分析的維度或指標。
  • 讓外部利害關係人找出並找出獨特指標。
  • 檢查 LookML 模型,評估是否遵循一致的命名慣例、是否有重複的欄位,或是否為欄位加上說明註解。
  • 新增及分享特定欄位的註解 (如果 Looker 資料字典應用程式為 2.0.0 以上版本)。

如要讓使用者存取及使用 Looker 資料字典,Looker 管理員必須執行下列步驟:

  1. 啟用適當的功能
  2. 安裝 Looker Data Dictionary 擴充功能
  3. 授予 Looker 資料字典的存取權

使用者可使用擴充功能後,您可以執行下列操作:

  1. 前往 Looker 資料字典
  2. 查看模型的中繼資料

安裝 Looker 資料字典

Looker 管理員必須先啟用以下功能,才能從Marketplace安裝 Looker Data Dictionary:

  • Marketplace:存取 Looker Marketplace (預設為啟用)
  • 擴充功能架構:部署使用 Looker 擴充功能架構開發的擴充功能 (預設為啟用)

如要從 Marketplace 安裝應用程式和工具 (例如擴充功能),您必須具備 developmanage_modelsdeploy 權限

如要瞭解如何從 Looker Marketplace 安裝工具,請參閱「使用 Looker Marketplace」說明文件。如要確保您隨時都能使用最新版本的資料字典,請前往 Looker Marketplace,選取「管理」,然後選取擴充功能旁的「更新」按鈕。

授予存取 Looker 資料字典的權限

安裝 Looker 資料字典後,系統會自動將名為 data-dictionary 的模型加入「新模型集合」和「編輯模型集合」頁面中可用的模型清單,您可以透過「管理」面板中的「角色」頁面存取這些模型。

Looker 管理員必須授予使用者 exploredevelop 權限,才能存取 data-dictionary 模型,以及他們在資料字典中需要探索的任何模型。如要瞭解如何授予使用者存取及使用 Looker 擴充功能的權限,請參閱「設定 Looker 擴充功能的權限」說明文件。

授予與欄位註解互動的權限

欄位註解可讓使用者在不需要更新任何 LookML 的情況下,為欄位定義新增相關資訊。根據預設,所有可存取資料字典擴充功能的使用者都能查看所有留言,並新增編輯及刪除自己的留言。

如有需要,Looker 管理員可以在「管理」面板的「群組」頁面中建立特定使用者群組,並將使用者指派給這些群組,藉此管理使用者與欄位註解功能的互動方式。如要進一步瞭解如何將使用者指派給群組,請參閱「群組」說明文件頁面。

建立使用者群組時,必須使用下表「群組名稱」欄中顯示的預先定義名稱。表格也會顯示已指派給各群組的使用者將擁有的預先定義權限。

群組名稱 權限
marketplace_data_dictionary_comments_disabled 使用者無法查看或與任何留言互動;所有留言功能都會停用。這個群組的權限一律優先於其他群組的權限,因此 disabled 群組中的使用者即使屬於擁有更高權限的其他群組,也無法使用留言功能。
marketplace_data_dictionary_comments_reader 使用者可以查看現有留言,但無法新增留言。
marketplace_data_dictionary_comments_writer 使用者可以查看所有留言、新增留言,以及編輯/刪除自己的留言。這是預設權限。
marketplace_data_dictionary_comments_manager 使用者可以查看所有留言、新增留言,以及編輯/刪除所有留言。

如果使用者不屬於上述任何群組,則預設為 writer。如果使用者同時屬於多個群組 (不含 marketplace_data_dictionary_comments_disabled),則會優先採用權限較高的群組。

透過「管理」面板中的「群組頁面所做的留言群組變更 (例如新增或移除使用者),會在您重新整理資料字典頁面,或使用者選取其他選項後返回資料字典頁面時生效。

您可以從左側邊欄的已安裝應用程式和擴充功能清單,前往資料字典。

使用 Looker 資料字典查看模型中繼資料

在 Looker 資料字典中,擁有模型 explore 權限的使用者可以選取這個模型,並查看其中繼資料,包括探索和每個探索的欄位清單,並按檢視畫面分組。Looker 資料字典會在左側欄中顯示所選模型的 Explore,並在頁面的主要部分顯示所選 Explore 的檢視畫面和欄位。

使用者可以選取 < 圖示,收合側欄。

Looker Data Dictionary 會顯示以下資訊:

  1. 所選模型的名稱
  2. 所選模型包含的探索清單
  3. 所選探索
  4. 用於篩選探索中欄位的文字欄位
  5. 快速篩選器可根據所選特徵縮小顯示的欄位
  6. 檢視畫面的名稱
  7. 每個欄位的中繼資料。選取「View Options按鈕,即可選取要顯示的中繼資料。在欄位分析工具中查看欄位的完整中繼資料集。
  8. 列:包含指定檢視畫面中每個欄位中繼資料的資料列
  9. 在 Looker UI 中前往「探索」

選取模型和探索

「Select a Model」下拉式選單會列出使用者具備 explore 權限的所有模式。從「Select a Model」下拉式選單中選擇模型後,左側邊欄會填入該模型的探索清單。

您也可以在「搜尋模型」搜尋框中輸入內容,在所選模型中搜尋特定探索。系統會篩選「探索」清單,只顯示符合搜尋字詞的結果。

選取探索名稱,即可在頁面的主要部分查看按檢視畫面分組的欄位。

您也可以選取右上角的「探索」按鈕,直接前往 Looker 的「探索」頁面。

在探索中篩選欄位

如要篩選顯示的欄位,請在「探索」中的「篩選欄位」方塊中輸入文字,以比對欄位清單的「欄位標籤」或「說明」

您也可以選取要篩選的特定中繼資料屬性,例如欄位是否符合下列條件:

查看欄位中繼資料

Looker Data Dictionary 會顯示探索欄位的中繼資料,並依檢視畫面分組:

自訂顯示的中繼資料

您可以選取右上角的「View Options」按鈕,然後勾選或取消勾選要查看的中繼資料方塊,指定每個欄位要顯示哪些中繼資料。

使用欄位註解

LookML 開發人員通常會在欄位層級的 description 參數中,加入模型欄位的其他資訊或說明。不過,這些說明不一定對所有使用者都具有意義或實用。使用者可以透過欄位層級註解,為特定欄位提供相關資訊。其他使用者可以查看這些註解,但不會影響模型的底層 LookML。

管理員必須在「管理」面板的「群組」頁面中,將使用者加入特定群組,授予使用者與留言互動的權限根據預設,所有可存取資料字典擴充功能的使用者都能查看所有留言,並新增編輯及刪除自己的留言。

新增欄位註解

如要在欄位中新增註解,請按照下列步驟操作:

  1. 將滑鼠游標懸停在欄位上,即可顯示 + 圖示 (如果沒有現有的欄位註解) 或記事本圖示 (如果欄位已有現有的註解)。按一下圖示,開啟欄位分析器面板的「Comments」分頁。
  2. 按一下「新增留言」按鈕。
  3. 輸入註解,然後選取「註解」按鈕即可儲存內容。按一下「取消」關閉欄位分析器。只要選取並拖曳右下角,即可展開留言方塊。

新增註解後,會顯示在欄位剖析工具的「Comments」分頁中,其他使用者可查看

查看欄位註解

如果欄位包含註解,畫面上會顯示筆記本圖示,並顯示該欄位中的註解數量。按一下記事本圖示,即可在欄位分析工具的「Comments」分頁中查看欄位的註解。

該欄位的留言數也會在「留言」分頁中以括號表示。每個留言項目都會顯示下列資訊:

  • 評論者的姓名
  • 顯示新增留言時間的時間戳記
  • 留言預覽

編輯或刪除欄位註解

如要編輯或刪除自己的欄位註解,請按照下列步驟操作:

  1. 選取欄位的記事本圖示。
  2. 在「留言」分頁中,找出要編輯或刪除的留言,並將滑鼠游標懸停在該留言上。
  3. 點選三點選單,然後選取「編輯留言」來編輯留言,或選取「刪除留言」來刪除留言。如果要刪除評論,請確認你的意圖。
  4. 如果要編輯留言,請在變更完成後選取「儲存」

分享欄位註解

每個欄位的「Comments」分頁網址皆不重複,您可以複製該網址,並與其他可存取 Looker 資料字典中該模型的使用者分享。

使用欄位 Profiler

按一下特定欄位列,即可開啟欄位剖析器面板,其中會顯示欄位的完整中繼資料、可預覽數值維度值的選項,以及可前往 Looker IDE 或「探索」頁面的按鈕。

在「分布」部分中,選取「計算」,即可預覽資料欄圖表,顯示在包含 type: count 的報表中,數值維度的計數值分布情形。「分布」部分也會顯示數值維度序列的最小值、最大值和平均值。

在「值」下方,選取「計算」,即可在包含含有 type: count 的指標的檢視畫面上,預覽數值維度的計數值。選取「探索更多」按鈕,開啟「探索」使用者介面,其中的欄位挑選器會預先選取數值維度和計數量測項目。

選取「Go to LookML」,即可在 Looker IDE 中開啟與所選模型相關聯的 LookML 專案檢視檔案。

選取「探索」按鈕,開啟「探索」頁面,並自動選取欄位挑選器中的該欄位。