LookML 圖表是一種擴充功能,也就是使用 Looker 元件建構的網頁應用程式,採用 Looker 擴充功能架構開發,並透過 Looker 市集部署。
LookML 圖表是 LookML 模型的實體關係圖,可以視覺化方式呈現 LookML 物件之間的關係。使用這項擴充功能可:
- 評估 LookML 模型的結構,找出可合併 LookML 的部分,並決定如何在模型中新增資料
- 找出不正確的邏輯,減少錯誤計算和查詢效能不佳的機率
- 瞭解如何進行以程式碼為基礎 (LookML) 的資料建模
本說明文件頁面說明如何使用 LookML 圖表 2.0.0 以上版本。Looker 管理員應參閱「設定 LookML 圖表擴充功能」說明文件,瞭解如何為 Looker 使用者啟用此擴充功能。
本頁面將說明如何:
前往 LookML 圖表
安裝 LookML 圖表後,您可以前往 LookML 圖表,方法是按一下左側導覽面板中的「區塊」,然後選取「LookML 圖表」圖塊。
透過 LookML 圖表觀察 LookML 物件關係
Looker 管理員必須授予您 lookml_diagram
模型和擴充功能中任何模型的權限。
LookML 圖表擴充功能包含下列元素:
- 「圖表設定」面板:選取模型、Git 分支版本和「探索」
- 「View Options」面板,可讓您指定要查看哪些欄位
- 圖表說明區段,提供圖表元素的其他說明
- 用於與所選「探索」中的 LookML 物件互動的圖表畫布
- 所選探索的欄位清單,按檢視畫面分組
- 工具列提供縮放和位置選項,以及用於顯示或隱藏畫布迷你地圖的圖示,有助於在較大的圖表中找到方向
- 物件分析器,可查看 LookML 物件相關資訊,並前往相關聯的 LookML 或探索 (如適用)
按兩下「圖表設定」圖示或「查看選項」圖示,即可收合左側面板。
設定圖表設定
按一下圖表導覽列中的圖表圖示,即可顯示「圖表設定」。
「選擇模型」下拉式選單會列出您有權限查看的所有模型。選取模型後,系統會顯示兩個額外選項:
「Current Branch」下拉式選單會填入該模型的 Git 分支版本清單。如果模型只有一個分支版本 (通常是正式版分支版本),系統就會顯示該分支版本。如果您處於正式版模式,或是沒有變更 Git 分支的權限,系統就會停用「Current Branch」下拉式選單。
如果管理員已授予您在 LookML 圖表上變更 Git 分支版本的權限,請開啟開發模式,確認已選取模型和探索,然後選取分支版本,根據模型在該分支版本上的設定查看圖表。
「選取探索」清單會填入該模型的探索項目清單。按一下探索的名稱,即可在頁面畫布上看到以檢視畫面分組的欄位。
探索觀看選項
選取「探索」後,您可以使用「View Options」面板,限制在畫布上顯示哪些欄位和檢視畫面。
限制顯示的欄位
您可以選取「要顯示的欄位」下方的「所有欄位」,在每個「探索」檢視中顯示所有欄位;如果只想顯示已與其他欄位彙整的欄位,請選取「含有彙整的欄位」。
啟用「隱藏隱藏欄位」切換鈕後,系統會隱藏在基礎 LookML 中包含 hidden: yes
的任何欄位。系統預設會啟用「隱藏隱藏欄位」切換鈕。
限制顯示的檢視畫面
「View Options」面板的「Views」部分會列出所選「探索」頁面中的檢視畫面。根據預設,所有檢視畫面都會顯示在圖表畫布上。隱藏檢視畫面時,檢視畫面物件和與該檢視畫面物件連結的任何其他物件,都會從圖表畫布中隱藏。
按一下「隱藏所有」,即可隱藏圖表工作區域中「探索」中的所有檢視畫面。按一下「顯示全部」,即可顯示該 Explore 中的所有檢視畫面。
您也可以取消選取檢視畫面名稱右側的眼睛圖示,從畫布中選擇性隱藏個別檢視畫面。隱藏檢視畫面時,檢視畫面名稱會顯示為灰色,眼睛圖示上會加上斜線。如要取消隱藏個別隱藏的檢視畫面,請按一下帶有斜線的眼睛圖示。
解讀圖表畫布
LookML 圖表畫布會顯示特定探索的所有實體和關係。在 Looker 的術語中,您可以將 LookML 圖表視為說明 LookML 物件如何在特定模型的 Explore 中彙整。
畫布頂端的物件標題列會顯示 Explore 的名稱,其檢視畫面會顯示在畫布上。按一下物件標題列中的「i」圖示 (圈圈內的「i」),開啟「物件剖析器」,進一步瞭解所選的探索。按一下順時針箭頭,重新載入擴充功能。
實體
Explore 的每個檢視畫面都會以自身的實體集合表示,且檢視畫面名稱會顯示在集合的頂端:
- Explore 的基本檢視畫面會以深藍色背景標示。
- 探索中已彙整的檢視畫面會顯示淺藍色背景。
選取了彙整、檢視畫面或欄位後,系統會以亮藍色標示。
每個檢視畫面下方會列出該檢視畫面所屬的欄位:
維度會列在頂端。
指標會列在底部,並以淺橘色標示。
如果欄位是主鍵,欄位名稱右側會顯示鑰匙圖示。
每個欄位左側都有一個圖示,用來表示其類型:
- A:
type: string
的維度 - #:
type: number
的維度或指標 - 分層長條圖:
type: tier
的維度 - 勾號:
type: yesno
的維度 - 日曆:
type: date
、type: date_time
、type: time
的維度 - 地圖點:
type: location
、type: distance
、type: zipcode
的維度
按一下欄位名稱,即可開啟物件分析工具,進一步瞭解所選欄位。
關係
這張圖表使用線條表示各個物件與所選模型中其他物件的關聯。線條的形狀 (附加至檢視畫面或欄位) 會傳達兩個物件之間關係的基數;分叉線條表示「多」基數,單線則表示「一」基數。您會將關係讀取為「從」基礎檢視畫面「到」彙整檢視畫面。例如:
- 從
order_items
到inventory_items
的 1 對 1 彙整,彙整id
欄位 - 從
order_items
到repeat_purchase_facts
的多對一彙整
您也可以將滑鼠游標懸停在線條上,查看兩個物件之間的連接關係類型。
按一下該行,即可開啟「物件分析工具」,查看關於彙整的更多資訊。
畫布檢視選項
畫布右上方的迷你地圖可協助您在較大的圖表中定位,地圖中的灰色部分會指出目前在畫布上顯示的圖表部分。按住並拖曳畫布中的空白區域,即可移動到圖表的其他部分。
畫布左下方的垂直工具列包含用於控制圖表顯示的圖示:
- 按一下 (+) 可放大圖表,按一下 (-) 則可縮小圖表。
- 按一下方塊圖示,即可返回圖表的預設起始位置。
- 按一下地圖圖示,即可啟用或停用小地圖。
使用物件分析器查看物件資訊
物件分析器會顯示所選物件的相關資訊。按一下圖表工作區的任何探索、檢視、欄位或彙整,即可在工作區右側開啟物件分析器。按一下畫布即可收合物件剖析器。
探索
按一下物件標題列右側的「探索資訊」圖示 (圈起來的「i」)。
針對在「圖表設定」面板中選取的「探索」功能,物件分析器會顯示下列資訊:
- Label:Explore
label
的值。 - 群組標籤:
group_label
參數的值,可在 Looker 的「探索」選單中將探索結合成自訂群組。如果未為探索定義群組標籤,則預設為模型名稱。 - 專案名稱:LookML 專案的名稱,如專案設定所定義。
- 連線名稱:
connection
參數的值,用於指定模型要從中擷取資料的資料庫連線。
如果您有權查看 LookML,可以按一下物件分析工具左下方的「前往 LookML」,開啟定義探索的檔案。檔案會在新分頁中開啟,並標示出 explore
的資料行。
瀏覽次數
按一下圖表畫布中的檢視畫面。
如果在檢視表的 LookML 中定義了「SQL Table Name」,物件剖析器就會顯示該名稱。如果未為檢視畫面定義 sql_table_name
,SQL 資料表名稱會顯示為 unknown
。
如果您有權查看 LookML,請按一下物件剖析工具左下方的「前往 LookML」,開啟定義了與檢視畫面連結的「探索」檔案。檔案會在新分頁中開啟,並標示出 explore
的資料行。
欄位
按一下圖表畫布中的欄位。
物件剖析器會在面板頂端顯示欄位名稱、類型和類型值,以及欄位是否為主鍵。Profiler 中的「Details」和「Code」分頁會顯示欄位相關的其他資訊。
在「詳細資料」分頁中,您可以查看:
- 資料檢視名稱:欄位所屬的資料檢視名稱。
- 標籤:欄位在「探索」的「資料」部分中顯示的方式,即檢視表的名稱或標籤,後面接著欄位的名稱或標籤。
- 分布情形:如果檢視畫面中的數值維度含有
type: count
指標,請按一下「計算」,即可預覽顯示計數值分布情形的資料欄圖表。「分布」部分也會顯示數值維度序列的最小值、最大值和平均值。 - 值:如果資料檢視中的數值維度含有
type: count
指標,請按一下「計算」,即可預覽計數值。按一下「探索更多」,開啟這個欄位所屬的「探索」頁面。
您可以在「Code」分頁中查看欄位參數和子參數。
如果您有權查看 LookML,可以按一下物件分析工具左下方的「前往 LookML」,開啟定義了彙整作業的檔案。檔案會在新的瀏覽器分頁中開啟,並在探索的「Join」行處停留。
如果您有權限探索資料,請按一下物件剖析工具右下方的「探索資料欄」,在「探索資料欄」挑選工具中預先選取該欄,開啟「探索」畫面。
彙整
在圖表畫布中按一下要查看的彙整。
物件分析器會顯示彙整陳述式,說明彙整關係和彙整的類型與基數。
如果您有權查看 LookML,可以按一下物件分析工具左下方的「前往 LookML」,開啟定義了彙整作業的檔案。檔案會在新的瀏覽器分頁中開啟,並在探索的「join」行處停留。