以 LookML 建立資料模型
LookML 和 Looker IDE 可讓您根據資料庫資料表,定義可重複使用的資料模型、維度和關係。在本快速入門導覽課程中,您將使用 Looker (Google Cloud Core) 的範例 LookML 專案,建立模型檔案和檢視表檔案、設定探索,以及測試新維度。您也會瞭解如何開啟開發模式、瀏覽 Looker IDE,以及使用快速說明。
事前準備
如要進行本快速入門導覽課程,您需要:
- Looker (Google Cloud Core) 執行個體的存取權:
- 執行個體必須包含範例 LookML 專案。
- 執行個體的 Google Cloud 專案必須啟用 BigQuery API。
必要的角色
如要完成這項快速入門導覽課程,您必須具備適當的 Identity and Access Management (IAM) 角色和 Looker 角色。
身分與存取權管理角色
Looker (Google Cloud Core) 管理員會透過 Google Cloud的 Identity and Access Management 系統,授予您 Looker (Google Cloud Core) 應用程式的存取權。
如要取得存取 Looker (Google Cloud Core) 應用程式所需的權限,請要求管理員在包含 Looker (Google Cloud Core) 執行個體的 Google Cloud 專案,授予您「Looker 執行個體使用者」(roles/looker.instanceUser) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備 looker.instances.login 權限,可存取 Looker (Google Cloud Core) 應用程式。
Looker 權限
您必須具備 Looker 使用者帳戶,且擁有 Looker 管理員角色或 develop 權限。
開啟開發模式
Looker 專案有兩種模式:正式環境模式和開發模式。在開發模式中,您可以變更 LookML 檔案,並預覽這些變更對執行個體內容的影響,而不會影響正式環境 (其他使用者看到的內容)。詳情請參閱「開發模式和正式環境模式」說明文件頁面。
在本快速入門導覽課程中,您將使用開發模式,以便變更 LookML 檔案,並在「探索」中測試變更。
如要開啟開發模式,請按照下列步驟操作:
- 在 Looker (Google Cloud Core) 首頁,按一下 Looker「主選單」圖示 ,展開主要導覽選單 (如果尚未展開)。
- 選取選單底部的「開發模式」切換鈕。
啟用開發模式後,Looker 會在畫面頂端顯示「Development Mode」橫幅。
在 Looker IDE 前往 LookML 範例專案
LookML 專案是一組 LookML 檔案,可指示 Looker 如何連線至資料庫、如何查詢資料,以及如何在使用者介面中呈現資料。在本快速入門導覽課程中,您將使用 Looker (Google Cloud Core) 執行個體自動設定的範例 LookML 專案。
如要在 Looker IDE 中前往 LookML 範例專案檔案,請按照下列步驟操作:
- 如果未顯示「開發」選單,請點選 Looker 的「主選單」圖示 ,然後選取「開發」。
- 在「開發」選單中,選取「sample_thelook_ecommerce」。
Looker 會開啟 Looker IDE 的「File Browser」(檔案瀏覽器) 面板,並顯示範例 LookML 專案檔案。
建立新的專案資料夾
為區分本快速入門導覽課程建立的檔案,與 LookML 範例專案中的其他檔案,請為快速入門導覽課程檔案建立新的專案資料夾。
如要在專案中建立資料夾,請按照下列步驟操作:
- 在 Looker IDE 的「檔案瀏覽器」面板中,點選面板頂端的「新增檔案或資料夾」圖示 ,然後從「新增檔案或資料夾」選單中選取「建立資料夾」選項。
輸入新資料夾的名稱:
quickstart。點選「建立」。
Looker 會將新資料夾新增至 Looker IDE 的「File Browser」面板。
IDE 資料夾的其他資訊
如要進一步瞭解如何在 LookML 專案中使用資料夾,請參閱下列說明文件頁面:
- 如要瞭解日後如何建立自己的資料夾和檔案,以及在專案中建立資料夾的注意事項,請參閱「管理 LookML 檔案和資料夾」說明文件頁面。
- 如要進一步瞭解 Looker IDE 檔案瀏覽器,請參閱「使用 IDE 檔案瀏覽器」說明文件頁面。
建立新的 LookML 模型檔案
LookML 模型檔案會指定資料庫連線,以及使用該連線的一組 Looker 探索。在 LookML 中建立資料模型後,使用者可以從「探索」開始在 Looker 中查詢資料 (請參閱「在 Looker 查看及使用『探索』」)。
如要在 LookML 專案中建立新的模型檔案,請按照下列步驟操作:
- 在 Looker IDE 的「File Browser」面板中,選取您在建立新專案資料夾程序中建立的
quickstart資料夾,然後點選三點圖示的「Folder Options」選單。 - 在「Folder Options」選單中,選取「Create Model」。
- 在「Create File」(建立檔案) 對話方塊中,輸入新檔案的名稱
quickstart_practice,然後按一下「Create」(建立)。Looker 會在quickstart資料夾下建立quickstart_practice.model檔案,並在 Looker IDE 中開啟新檔案。在「File Browser」面板中,檔案旁邊的藍點表示這是新檔案。 - 在「檔案瀏覽器」面板中,點選
quickstart資料夾展開,即可查看quickstart_practice.model檔案。 - 在 Looker IDE 中,點選
quickstart_practice.model檔案加以開啟 (如果尚未開啟)。
quickstart_practice.model 檔案包含 LookML 範例,可做為專案的起點。目前可以先保留檔案。稍後在快速入門導覽課程中,您將在模型檔案中建立探索。
模型檔案的其他資訊
日後如要自行建立模型檔案,請留意下列資源:
- 如需模型檔案的一般資訊,請參閱「LookML 專案檔案」說明文件頁面的「模型檔案」一節。
- 如需完整程序和在專案中建立檔案的其他選項,請參閱「管理 LookML 檔案和資料夾」說明文件頁面。
- 如要瞭解 LookML 檔案的命名慣例,請參閱「管理 LookML 檔案和資料夾」頁面的「事前準備:重要檔案和資料夾命名慣例」一節。
- 如要瞭解可在模型檔案中使用的 LookML 參數,請參閱「模型參數」說明文件頁面。
建立新的 LookML 檢視表檔案
在 LookML 中,檢視表會對應到資料庫中的單一資料表或單一衍生資料表。檢視表檔案會指定要查詢的資料庫資料表,以及要從該資料庫資料表納入的欄位 (維度和測量指標)。在檢視表檔案中定義欄位後,您可以使用 $ 替換運算子,在 LookML 的其他部分參照該欄位。這樣一來,您就能在單一位置定義欄位,並在 LookML 專案的多個位置使用。
建立新檢視表檔案的方法有很多種,但最簡單的方法是讓 Looker 根據資料庫中的現有資料表,自動產生檢視表檔案。
如要讓 Looker 產生新的檢視表檔案,請按照下列步驟操作:
- 在 Looker IDE 的「File Browser」面板中,選取您在建立新專案資料夾程序中建立的
quickstart資料夾,然後點選三點圖示的「Folder Options」選單。 - 從「Folder Options」選單中,選取「Create View from Table」。
在「從資料表建立檢視表」頁面,點選「Enter custom db」輸入欄位,然後輸入
bigquery-public-data:
按下 Enter 鍵,即可查看 BigQuery 公開資料集。
捲動清單,找出
thelook_ecommerce資料集。點選「
thelook_ecommerce」資料集,展開該資料集。選取「
order_items」資料表。按一下頁面底部的「建立檢視表」按鈕。
Looker 會在 Looker IDE 中顯示 order_items 檢視表檔案。在「File Browser」面板中,quickstart 資料夾會展開,order_items 檢視表檔案會顯示藍色圓點,表示這是新檔案。
檢視檔案的其他資訊
如要日後自行建立檢視表檔案,請留意下列資源:
- 如要瞭解檢視表檔案的一般資訊,請參閱「LookML 專案檔案」說明文件頁面的「檢視表檔案」一節。
- 如需完整程序和在專案中建立檔案的其他選項,請參閱「管理 LookML 檔案和資料夾」說明文件頁面。
- 如要瞭解建立檢視表檔案的特定注意事項,請參閱「管理 LookML 檔案和資料夾」頁面的「建立檢視表檔案的注意事項」一節。
- 如要瞭解 LookML 檔案的命名慣例,請參閱「管理 LookML 檔案和資料夾」頁面的「事前準備:重要檔案和資料夾命名慣例」一節。
- 如要瞭解可在檢視表檔案中使用的 LookML 參數,請參閱「檢視表參數」說明文件頁面。
Looker IDE 快速說明
您已建立 LookML 模型檔案和 LookML 檢視表檔案。在快速入門導覽課程的後續步驟中,您將開始編輯這些檔案。開始編輯前,請先熟悉 Looker IDE 快速說明功能。「快速說明」面板會針對 LookML 檔案中游標目前所在位置,提供說明和選項:
- 在 IDE 編輯器面板中,點選 LookML 檔案中的欄位和參數,「快速說明」面板就會顯示該 LookML 元素支援的選項和子參數。
- 在「快速說明」面板中,點選參數名稱即可開啟該參數的 Looker 說明文件頁面。
如果「快速說明」面板尚未開啟,請在 Looker IDE 中點選「快速說明」圖示:

為檢視表建立探索
執行「建立新的 LookML 模型檔案」和「建立新的 LookML 檢視表檔案」程序後,即可為新的檢視表檔案定義探索,以便使用 Looker 查詢在檢視表檔案中建立模型的資料。
探索通常定義在模型檔案中。(您可以建立獨立的「探索」檔案,但為了快速上手,請在模型檔案中建立「探索」)。
在定義「探索」的 LookML 檔案中,您必須使用 include 參數,才能在「探索」定義中參照檢視表檔案。本程序將逐步引導您完成這些步驟。
如要為 order_items 檢視表檔案建立探索,請按照下列步驟操作:
- 在 Looker IDE 中開啟
quickstart_practice.model檔案。 在
quickstart_practice.model檔案中,將包含include參數的現有程式碼行替換為以下程式碼行:include: "/quickstart/order_items.view"在
include參數下方新增一行,然後輸入下列 LookML: alue, which you can select from the fieldnone explore: order_items {}點選 Looker IDE 頂端的「儲存變更」按鈕。
這個探索是最基本的探索範例,可讓使用者查詢 order_items 檢視表。您可以從這個起點,以多種方式建立探索。
探索的其他資訊
如要日後自行建立探索,並建構探索,請參考下列資源:
- 如要進一步瞭解如何建立探索,請參閱「建立及編輯探索」說明文件頁面。
- 如要瞭解如何在其他檢視表中彙整,請參閱「在 LookML 中使用彙整」說明文件頁面。
- 如要瞭解可用於探索的 LookML 參數,請參閱「探索參數」說明文件頁面。
- 如要瞭解如何在 Looker UI 的「探索」頁面查詢資料,請參閱「在 Looker 查看及使用『探索』」說明文件頁面。
建立新欄位
在本快速入門導覽課程的「建立新的 LookML 檢視表檔案」一節建立檢視表檔案後,您會看到 Looker 自動建立的欄位。根據資料庫資料表建立檢視表檔案時,Looker 會自動建立維度、維度群組和測量指標:
- 維度是代表屬性、事實或值的欄位,使用者可以從探索的欄位挑選器中選取,並用於篩選查詢。如果欄位不在 SUM、COUNT 等匯總函式中,則為維度。Looker 會自動為資料庫資料表的每個資料欄建立維度。
- 維度群組可用來一次建立一組時間或時間長度維度。舉例來說,時間戳記資料欄的維度群組會包含日期、月份、季度、時間、週和年份的個別維度。Looker 會自動為在資料庫資料表中偵測到的時間欄位建立維度群組。
- 測量指標是探索中的欄位,代表資料的可測量資訊,例如總和、計數等。測量指標是在檢視表檔案中宣告,可以是匯總或非匯總類型。Looker 會自動為檢視表檔案建立
type:count測量指標,相當於 SQL 中的COUNT(*)。
在本節中,您將瞭解如何手動將自己的維度新增至 order_items 檢視表檔案。
如要在 order_items 檢視表檔案中手動建立新維度,請按照下列步驟操作:
- 如果
quickstarts/order_items.view檔案尚未開啟,請在 Looker IDE 的「檔案瀏覽器」面板中,點選「quickstart」資料夾展開,然後點選order_items.view檔案開啟。 - 在
quickstarts/order_items.view檔案中,於第一個dimension參數前新增一行。 在新的一行中,開始輸入
dimension。輸入時,Looker IDE 會顯示可能參數的清單,這些參數的開頭會與您輸入的文字相同。- 使用方向鍵,在建議清單中找到「
dimension」選項。 - 按下 Enter 鍵,即可將所選參數插入 LookML。Looker 會在您建立的新行中插入新的
dimension參數。
- 使用方向鍵,在建議清單中找到「
如要為新維度命名,請在 IDE 中按一下
{}前方,然後輸入shipped_to_delivered_days。按一下
{}內部,然後按下 Enter 鍵,在{}內部建立新的一行。完成新維度的 LookML (您可以複製及貼上下列 LookML,或手動輸入 LookML,瞭解 Looker IDE 如何提供指引):
dimension: shipped_to_delivered_days { group_label: "Other Dates" type: duration_day sql_start: ${shipped_raw} ;; sql_end: ${delivered_raw} ;; }點選 Looker IDE 頂端的「儲存變更」按鈕。
Looker 會儲存含有新維度的檢視表檔案。Looker IDE 會將檔案中新行的行號標示為綠色。
LookML 欄位的其他資訊
如要日後自行建立欄位,請參考下列資源:
- 如要瞭解 LookML 欄位的一般資訊,請參閱「LookML 欄位參考資料」說明文件頁面。
- 如要瞭解可在檢視表檔案中建立的維度、篩選器和參數類型,請參閱「維度、篩選器和參數類型」說明文件頁面。
- 如要瞭解可在檢視表檔案中建立的測量指標類型,請參閱「測量指標類型」說明文件頁面。
在 Looker UI 中查看及測試變更
如果您已執行「為檢視表建立探索」程序,為 order_items 檢視表檔案建立探索,就能在 Looker 探索 UI 中看到新維度。
如要在 Looker UI 的「探索」中查看及測試變更,請按照下列步驟操作:
在 Looker IDE 的
quickstarts/order_items.view檔案中,按一下檔案編輯器面板頂端檢視表檔案名稱旁的「查看檔案動作」箭頭圖示,然後選取「探索訂單項目 - quickstart_practice」選項。
在「訂單商品」探索欄位挑選器中,按一下「其他日期」群組標籤展開,然後點選「出貨到送達天數」維度,將其新增至探索。(您也可以在欄位挑選器搜尋框中輸入
Shipped to Delivered Days,搜尋該維度)。在「Order Items」探索欄位挑選器中,點選「Shipped Date」群組標籤展開,然後點選「Date」維度,將其新增至探索。
在「Order Items」探索欄位挑選器中,點選「Delivered Date」群組標籤展開,然後點選「Date」維度,將其新增至探索。
點選「探索」頂端的「執行」按鈕。
Looker 會執行查詢,並在「探索」的「資料」部分顯示結果。您可以檢查每一行,確認「訂單商品出貨到送達天數」的值,是否正確顯示「訂單商品出貨日期」和「訂單商品送達日期」之間的天數。
驗證 LookML
在本快速入門導覽課程中,您不需要驗證 LookML。不過,日後您建立自己的專案來建立資料模型時,建議您瞭解 Looker 工具,以便驗證 LookML。
編輯 LookML 時,Looker IDE 會在單一檔案中提醒您任何未解決的語法錯誤 (請參閱「Looker IDE 總覽」說明文件頁面)。您也可以執行完整的模型驗證,檢查 LookML 是否有任何錯誤。詳情請參閱「驗證 LookML」說明文件頁面。
修訂變更
在本快速入門導覽課程中,您將使用預先設定的 Git 連線,該連線是為範例 LookML 專案設定。不過,日後建立自己的專案來建立資料模型時,您需要為專案設定 Git 連線。
變更 LookML 專案檔案時,Looker IDE 右上角的 Git 按鈕會顯示不同操作。這個按鈕會顯示不同操作,引導您驗證 LookML,並將變更部署至正式環境。
您在本快速入門導覽課程中查看的 LookML 檔案和探索,僅在開發模式下的個人 Git 分支版本中提供。如要將這個模型提供給 Looker (Google Cloud Core) 執行個體中的其他使用者,請修訂變更、合併分支版本,並部署正式分支版本。
在本快速入門導覽課程中,您不會將變更部署至正式環境。您將按照「清理」程序刪除這些檔案。
清除所用資源
為盡可能提高 Looker 效能,請勿將不必要的模型部署至正式環境。為保持個人 Git 分支版本整潔,並避免不小心將這些檔案部署至正式環境,請完成下列步驟,刪除您在本快速入門導覽課程中建立的檔案:
- 如果未顯示「開發」選單,請點選 Looker 的「主選單」圖示 ,然後選取「開發」。
- 在「開發」選單中,選取「sample_thelook_ecommerce」。
- 在 Looker IDE 的「File Browser」面板中,選取您在建立新專案資料夾程序中建立的
quickstart資料夾,然後點選三點圖示的「Folder Options」選單。 - 在「資料夾選項」選單中,選取「刪除」。
- 在「刪除資料夾」視窗中,按一下「刪除」。
Looker 會刪除 quickstart 資料夾和所有內容。