使用 LookML 圖表

LookML 圖表是一種擴充功能,也就是使用 Looker 元件建構的網頁應用程式,採用 Looker 擴充功能架構開發,並透過 Looker 市集部署。

LookML 圖表是 LookML 模型的實體關係圖,可以視覺化方式呈現 LookML 物件之間的關係。使用這項擴充功能可:

  • 評估 LookML 模型的結構,找出可合併 LookML 的部分,並決定如何在模型中新增資料
  • 找出不正確的邏輯,減少錯誤計算和查詢效能不佳的機率
  • 瞭解如何進行以程式碼為基礎 (LookML) 的資料建模

本說明文件頁面說明如何使用 LookML 圖表 2.0.0 以上版本。Looker 管理員應參閱「設定 LookML 圖表擴充功能」說明文件,瞭解如何為 Looker 使用者啟用此擴充功能。

本頁面將說明如何:

安裝 LookML 圖表後,您可以前往 LookML 圖表,方法是按一下左側導覽面板中的「區塊」,然後選取「LookML 圖表」圖塊。

透過 LookML 圖表觀察 LookML 物件關係

Looker 管理員必須授予您 lookml_diagram 模型和擴充功能中任何模型的權限

LookML 圖表擴充功能包含下列元素:

  1. 「圖表設定」面板:選取模型Git 分支版本「探索」
  2. 「View Options」面板,可讓您指定要查看哪些欄位
  3. 圖表說明區段,提供圖表元素的其他說明
  4. 用於與所選「探索」中的 LookML 物件互動的圖表畫布
  5. 所選探索的欄位清單,按檢視畫面分組
  6. 工具列提供縮放和位置選項,以及用於顯示或隱藏畫布迷你地圖的圖示,有助於在較大的圖表中找到方向
  7. 物件分析器,可查看 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 的每個檢視畫面都會以自身的實體集合表示,且檢視畫面名稱會顯示在集合的頂端:

  1. Explore 的基本檢視畫面會以深藍色背景標示。
  2. 探索中已彙整的檢視畫面會顯示淺藍色背景。
  3. 選取了彙整、檢視畫面或欄位後,系統會以亮藍色標示。

    每個檢視畫面下方會列出該檢視畫面所屬的欄位:

  4. 維度會列在頂端。

  5. 指標會列在底部,並以淺橘色標示。

  6. 如果欄位是主鍵,欄位名稱右側會顯示鑰匙圖示。

每個欄位左側都有一個圖示,用來表示其類型:

  • Atype: string 的維度
  • #type: number 的維度或指標
  • 分層長條圖:type: tier 的維度
  • 勾號:type: yesno 的維度
  • 日曆:type: datetype: date_timetype: time 的維度
  • 地圖點:type: locationtype: distancetype: zipcode 的維度

按一下欄位名稱,即可開啟物件分析工具,進一步瞭解所選欄位。

關係

這張圖表使用線條表示各個物件與所選模型中其他物件的關聯。線條的形狀 (附加至檢視畫面或欄位) 會傳達兩個物件之間關係的基數;分叉線條表示「多」基數,單線則表示「一」基數。您會將關係讀取為「從」基礎檢視畫面「到」彙整檢視畫面。例如:

  1. order_itemsinventory_items 的 1 對 1 彙整,彙整 id 欄位
  2. order_itemsrepeat_purchase_facts 的多對一彙整

您也可以將滑鼠游標懸停在線條上,查看兩個物件之間的連接關係類型

按一下該行,即可開啟「物件分析工具」,查看關於彙整的更多資訊。

畫布檢視選項

畫布右上方的迷你地圖可協助您在較大的圖表中定位,地圖中的灰色部分會指出目前在畫布上顯示的圖表部分。按住並拖曳畫布中的空白區域,即可移動到圖表的其他部分。

畫布左下方的垂直工具列包含用於控制圖表顯示的圖示:

  • 按一下 (+) 可放大圖表,按一下 (-) 則可縮小圖表。
  • 按一下方塊圖示,即可返回圖表的預設起始位置。
  • 按一下地圖圖示,即可啟用或停用小地圖。

使用物件分析器查看物件資訊

物件分析器會顯示所選物件的相關資訊。按一下圖表工作區的任何探索、檢視、欄位或彙整,即可在工作區右側開啟物件分析器。按一下畫布即可收合物件剖析器。

探索

按一下物件標題列右側的「探索資訊」圖示 (圈起來的「i」)。

針對在「圖表設定」面板中選取的「探索」功能,物件分析器會顯示下列資訊:

  • LabelExplore label 的值。
  • 群組標籤group_label 參數的值,可在 Looker 的「探索」選單中將探索結合成自訂群組。如果未為探索定義群組標籤,則預設為模型名稱。
  • 專案名稱:LookML 專案的名稱,如專案設定所定義。
  • 連線名稱connection 參數的值,用於指定模型要從中擷取資料的資料庫連線。

如果您有權查看 LookML,可以按一下物件分析工具左下方的「前往 LookML」,開啟定義探索的檔案。檔案會在新分頁中開啟,並標示出 explore 的資料行。

瀏覽次數

按一下圖表畫布中的檢視畫面。

如果在檢視表的 LookML 中定義了「SQL Table Name」,物件剖析器就會顯示該名稱。如果未為檢視畫面定義 sql_table_nameSQL 資料表名稱會顯示為 unknown

如果您有權查看 LookML,請按一下物件剖析工具左下方的「前往 LookML」,開啟定義了與檢視畫面連結的「探索」檔案。檔案會在新分頁中開啟,並標示出 explore 的資料行。

欄位

按一下圖表畫布中的欄位。

物件剖析器會在面板頂端顯示欄位名稱、類型和類型值,以及欄位是否為主鍵。Profiler 中的「Details」和「Code」分頁會顯示欄位相關的其他資訊。

在「詳細資料」分頁中,您可以查看:

  • 資料檢視名稱:欄位所屬的資料檢視名稱。
  • 標籤:欄位在「探索」的「資料」部分中顯示的方式,即檢視表的名稱或標籤,後面接著欄位的名稱或標籤
  • 分布情形:如果檢視畫面中的數值維度含有 type: count 指標,請按一下「計算」,即可預覽顯示計數值分布情形的資料欄圖表。「分布」部分也會顯示數值維度序列的最小值、最大值和平均值。
  • :如果資料檢視中的數值維度含有 type: count 指標,請按一下「計算」,即可預覽計數值。按一下「探索更多」,開啟這個欄位所屬的「探索」頁面。

您可以在「Code」分頁中查看欄位參數和子參數

如果您有權查看 LookML,可以按一下物件分析工具左下方的「前往 LookML」,開啟定義了彙整作業的檔案。檔案會在新的瀏覽器分頁中開啟,並在探索的「Join」行處停留。

如果您有權限探索資料,請按一下物件剖析工具右下方的「探索資料欄」,在「探索資料欄」挑選工具中預先選取該欄,開啟「探索」畫面。

彙整

在圖表畫布中按一下要查看的彙整。

物件分析器會顯示彙整陳述式,說明彙整關係和彙整的類型基數

如果您有權查看 LookML,可以按一下物件分析工具左下方的「前往 LookML」,開啟定義了彙整作業的檔案。檔案會在新的瀏覽器分頁中開啟,並在探索的「join」行處停留。