LookML 資訊主頁是由 LookML 開發人員建立,並儲存為受版本控管的檔案。根據預設,這些資訊主頁會顯示在 Looker 執行個體的「LookML 資訊主頁」資料夾中。
如要比較 LookML 資訊主頁和使用者定義的資訊主頁,請參閱「比較使用者定義的資訊主頁和 LookML 資訊主頁」說明文件頁面。
如要建立 LookML 資訊主頁,您必須具備下列 Looker 權限:
此外,您必須有權存取 LookML 模型,才能在資訊主頁中使用資料。
建立 LookML 資訊主頁檔案
如要建構 LookML 資訊主頁,請先建立資訊主頁檔案,該檔案具有 .dashboard.lookml
副檔名 (雖然 IDE 內副檔名的 .lookml
部分會保持靜態)。步驟如下:
- 開啟「開發模式」。
- 在「Develop」選單中,前往您的專案。
- 在 Looker IDE 的檔案瀏覽器面板頂端,選取「新增檔案或資料夾」加號圖示,在現有專案資料夾外建立 LookML 資訊主頁檔案。或者,按一下資料夾的三點式「資料夾選項」選單,即可在資料夾中建立檔案。按一下「Create Dashboard」(建立資訊主頁),建立資訊主頁檔案。
- 系統會顯示「建立檔案」視窗。在視窗中,於填寫欄位為資訊主頁檔案命名,然後選取「建立」按鈕。
編輯 LookML 資訊主頁檔案
建立 LookML 資訊主頁檔案時,Looker 會預先填入幾個基本的資訊主頁參數,這些參數會實作整個資訊主頁的設定。檔案也會預先填入幾個範例資訊主頁元素參數,這些參數會歸類在 elements
資訊主頁參數下方,並定義資訊主頁圖塊、文字和按鈕的功能和外觀。新建立的 .dashboard.lookml
檔案包含的資訊主頁 LookML 類似於:
- dashboard: order_analysis
title: Order Analysis
layout: newspaper
preferred_viewer: dashboards-next
tile_size: 100
filters:
elements:
- name: hello_world
type: looker_column
只要處於開發模式,您就可以在 IDE 中編輯資訊主頁檔案。
您可以透過下列幾種方式建立資訊主頁:
- 手動建立:您可以使用資訊主頁參數和資訊主頁元素參數,手動建立資訊主頁。
- 複製使用者定義的資訊主頁:您可以建立使用者定義資訊主頁的副本,方法是從檔案中刪除預先填入的資訊主頁 LookML、從使用者定義的資訊主頁複製資訊主頁 LookML,然後貼到資訊主頁檔案中。
- 複製元素的資訊主頁 LookML:您可以從「探索」或「Look」複製資訊主頁 LookML,然後貼到資訊主頁檔案中。
建立資訊主頁時,請牢記資訊主頁建構最佳做法。如要瞭解如何建構高效能資訊主頁,請參閱「建構高效能 Looker 資訊主頁時的注意事項」最佳做法頁面。
在現有 LookML 資訊主頁中新增視覺化效果
如要將視覺化效果新增至現有的 LookML 資訊主頁,最簡單的方法是使用探索頁面建立查詢,然後將查詢轉換為資訊主頁元素:
- 建立要新增至資訊主頁的查詢和視覺化圖表後,請按一下「探索」的「探索動作」齒輪選單。
選取「取得 LookML」即可顯示 LookML。
系統會隨即顯示「取得 LookML」視窗。在視窗中選取「資訊主頁」,然後全選並複製所有 LookML。
接著,將 LookML 貼到資訊主頁 LookML 檔案中。編輯資訊主頁 LookML 檔案時,請務必:
- 確認您處於開發模式,以便編輯資訊主頁檔案。
- 將 LookML 貼到資訊主頁的
elements
參數下方。 - 將 LookML 貼到資訊主頁檔案時,請使用正確的縮排。如有可能,請將縮排與資訊主頁檔案中現有的元素相符。
如要調整 LookML 參數,請使用各元素類型說明文件頁面中說明的參數。
新增篩選條件
將資訊主頁元素儲存到資訊主頁檔案後,您可能會想新增篩選器,讓資訊主頁檢視者篩選資訊主頁中的部分或所有元素。篩選器適合用於下列情況:
- 調整顯示的時間範圍
- 調整顯示的特定產品類別、顧客類型等
- 為用戶端或客戶提供「查詢」類型功能
請務必建立所需的篩選器類型。這兩種類型分別是:
- 您在資訊主頁元素中硬式編碼的篩選器,資訊主頁檢視者無法變更
- 資訊主頁篩選器,資訊主頁檢視者可以變更
硬式編碼到資訊主頁元素的篩選器
您在資訊主頁元素中硬式編碼的篩選器 (使用者無法變更),通常會在複製 LookML 的步驟中自動建立,適用於視覺化或資訊主頁。在 LookML 資訊主頁中,這些篩選器會使用 filters
資訊主頁元素參數,如下所示:
- name: element_name
# lots of other element parameters here
filters:
dimension_or_measure_name: 'looker filter expression'
資訊主頁篩選器
資訊主頁篩選器可讓檢視者以互動方式,篩選資訊主頁元素中顯示的資料。如要建立資訊主頁篩選器,請按照下列步驟操作:
建立資訊主頁篩選器
您可以使用 filters
參數,為資訊主頁建立各種互動式篩選器。
如要建立可供使用者互動的資訊主頁篩選器,請在資訊主頁檔案中新增 filters
參數。舉例來說,下列程式碼範例會建立含有 date
和 category_name
篩選器的 LookML 資訊主頁:
- dashboard: dashboard_name
title: Dashboard Title
layout: newspaper
filters:
- name: date
title: 'Date Range'
type: date_filter
default_value: 30 days
- name: category_name
type: field_filter
model: ecommerce
explore: product
field: category.name
上一個範例中的程式碼會建立下列篩選器:
date
:日期篩選器,可供使用者選取日期範圍。預設值為過去 30 天。category_name
:欄位篩選器,可讓使用者依產品類別篩選。這個篩選器會根據指定 LookML 模型 (ecommerce
) 和 Explore (product
) 中的category.name
欄位,動態產生選項。
將資訊主頁篩選器套用至資訊主頁元素
建立資訊主頁篩選器後,您可以使用 listen
參數,將該篩選器套用至個別資訊主頁元素。以這種方式使用 listen
參數,可讓連結的元素根據使用者在篩選器中的選取項目動態更新。
舉例來說,請參考下列區域圖元素的 LookML 程式碼範例:
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: orders
dimensions: [orders.created_date]
measures: [orders.count]
filters:
orders.status: 'approved'
由於查詢依據是 orders_created_date
維度和 orders.count
評估指標,且已套用篩選條件 orders.status: 'approved'
,因此 approved_orders_by_day
圖表會顯示每日核准的訂單數量。這個篩選器會固定在元素中,資訊主頁檢視者無法修改。
如要讓使用者使用上例中的 date
篩選器和 category_name
篩選器,篩選 approved_orders_by_day
圖表,請將 listen
參數新增至資訊主頁元素。
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: orders
dimensions: [orders.created_date]
measures: [orders.count]
filters:
orders.status: 'approved'
listen:
category_name: category.name
date: orders.created_date
當儀表板檢視者與 category_name
篩選器或 date
篩選器互動時,approved_orders_by_day
圖表會自動更新,以反映篩選結果。
listen
參數使用 filter_name: field_name
語法。在上一個範例中,category_name
和 date
是篩選器的名稱,而 category.name
和 orders.created_date
則是欄位,資訊主頁檢視者可透過這些欄位為篩選器提供輸入內容。
您可以對任何元素中的任何欄位 (相同資料類型) 套用資訊主頁篩選器。舉例來說,一個元素可將使用者輸入內容套用至訂單的建立日期 (date: orders.created_date
),另一個元素則可套用至訂單的出貨日期 (date: orders.ship_date
):
- name: element_one
# lots of other element parameters here
listen:
date: orders.created_date
- name: element_two
# lots of other element parameters here
listen:
date: orders.ship_date
在模型中加入資訊主頁檔案
如要在開發模式中預覽資訊主頁,或在正式版中顯示資訊主頁,必須使用 include
陳述式,將資訊主頁納入資訊主頁所依據的模型檔案。
常見做法是使用萬用字元,將所有 LookML 資訊主頁納入模型:
include: "*.dashboard.lookml"
或者,如果 LookML 資訊主頁顯示在 IDE 的資料夾中,請使用其位置的路徑
include: "/path/*.dashboard.lookml"
您也可以指定檔案名稱來納入特定資訊主頁:
include: "my_dashboard.dashboard.lookml"
儲存、預覽及發布 LookML 資訊主頁
如要預覽資訊主頁,請按照下列步驟操作:
- 按一下檔案右上角的「儲存變更」按鈕,儲存
.dashboard.lookml
檔案。 - 在相關模型檔案中加入資訊主頁,並儲存該檔案的變更。
- 在要預覽的
.dashboard.lookml
檔案中,按一下「查看檔案動作」圖示 (向下箭頭),然後選取「查看資訊主頁」。
您可以進一步變更 .dashboard.lookml
檔案、儲存變更,然後再次預覽資訊主頁。
資訊主頁完成後,即可發布至正式環境,讓其他具有適當權限的使用者查看。發布資訊主頁的方法與在執行個體上發布其他 LookML 變更的方法相同,取決於 Looker 執行個體的版本控管設定。
LookML 資訊主頁資料夾
發布後,LookML 資訊主頁預設會儲存在「LookML 資訊主頁」資料夾中。LookML 資訊主頁資料夾位於左側導覽列的「資料夾」資料夾中。LookML 資訊主頁資料夾與其他資料夾的不同之處如下:
- 您必須在至少一個模型檔案中加入 LookML 資訊主頁,該資訊主頁才會顯示在 LookML 資訊主頁資料夾中。
- 使用者必須具備
see_lookml_dashboards
權限,才能查看 LookML 資訊主頁資料夾。 - 如要查看 LookML 資訊主頁資料夾中的資訊主頁,使用者必須有權存取包含資訊主頁的 LookML 模型。
- 如要查看 LookML 資訊主頁中的任何動態磚,資訊主頁檢視者必須有權存取動態磚所依據的 LookML 模型。
- 如要編輯「LookML 資訊主頁」資料夾中的資訊主頁,您必須對包含 LookML 資訊主頁的模型具備
develop
權限。 - 如要從資訊主頁的任何動態磚「從這裡探索」,資訊主頁檢視者必須具備該動態磚所依據模型的
explore
權限。 - 您無法在 LookML 資訊主頁資料夾中建立資料夾。
將 LookML 資訊主頁移出 LookML 資訊主頁資料夾
如果您擁有 see_lookml_dashboards
和 develop
Looker 權限,以及 LookML 資訊主頁所屬 LookML 模型的存取權,就能將 LookML 資訊主頁移至任何資料夾,前提是您具備該資料夾的「管理存取權、編輯」存取層級。
移動資訊主頁的方式有兩種:
- 在「LookML 資訊主頁」資料夾中,選取要移動的資訊主頁,按一下資訊主頁部分頂端的「移動」按鈕,然後選取要將資訊主頁移入的資料夾。詳情請參閱「整理及管理內容」說明文件頁面。
- 在「LookML dashboards」資料夾中,按一下資訊主頁的三點選單,從選單中選取「Move」,然後選取要將資訊主頁移入的資料夾。
如果您處於開發模式,就無法將 LookML 資訊主頁移出 LookML 資訊主頁資料夾。您可以改用「匯入」選項,將 LookML 資訊主頁複製為使用者定義的資訊主頁,並儲存到其他資料夾。
如果資料夾同時包含使用者定義的資訊主頁和 LookML 資訊主頁,系統會在「LookML 資訊主頁」部分顯示 LookML 資訊主頁。在「LookML 資訊主頁」部分,您可以將 LookML 資訊主頁移至其他資料夾,或將 LookML 資訊主頁釘選至看板。不過,與使用者定義的資訊主頁不同,LookML 資訊主頁無法重新命名,也無法從資料夾移至垃圾桶。
如果 LookML 資訊主頁的 dashboard
參數值有所變更,LookML 資訊主頁會自動移回「LookML 資訊主頁」資料夾。
查看現有 LookML 資訊主頁的 LookML
如果您擁有 see_lookml
權限,可以從資訊主頁的三點「資訊主頁動作」選單中選取「前往 LookML」,前往現有 LookML 資訊主頁的 LookML 資訊主頁:
選取「前往 LookML」後,Looker 會前往定義 LookML 資訊主頁的資訊主頁檔案。
擴充 LookML 資訊主頁
建立 LookML 資訊主頁後,即可擴充資訊主頁。您可以根據原始資訊主頁建立第二個資訊主頁,並視需要新增或覆寫部分設定。接著,如果您變更第一個資訊主頁,第二個資訊主頁會自動沿用這些變更 (除非第二個資訊主頁覆寫了這些變更)。詳情請參閱「使用 extends 重複使用程式碼」說明文件頁面。
使用匯總認知度提升資訊主頁效能
LookML 開發人員或許可以運用匯總認知,提升 LookML 資訊主頁效能。開發人員可透過匯總感知功能,在 LookML explore
參數下建立匯總資料表,進而針對資訊主頁中的一或多個圖塊最佳化查詢。
建立並查看 LookML 資訊主頁後,您可以使用三點圖示「資訊主頁動作」選單中的「取得匯總表格 LookML」選項 (如果您有 see_lookml
權限,就會看到這個選單)。
詳情請參閱 aggregate_table
參數說明文件頁面。