以 LookML 建立資料模型

開啟開發模式

Looker 專案可處於下列其中一種模式：生產模式和開發模式。開發模式可讓您變更 LookML 檔案，並預覽這些變更對您執行個體的內容有何影響，且不會影響正式環境 (其他使用者看到的內容)。詳情請參閱「開發模式和正式發布模式」說明文件。

在本快速入門課程中，您將使用開發模式，以便修改 LookML 檔案，並在「探索」中測試變更。

如要開啟開發人員模式，請按照下列步驟操作：

1. 在 Looker (Google Cloud Core) 首頁上，按一下 Looker「主選單」圖示 menu，展開主導覽選單 (如果尚未展開)。
2. 選取選單底部的「Development Mode」切換鈕。

啟用開發模式後，Looker 會在畫面頂端顯示「Development Mode」橫幅。

前往 Looker IDE 中的 LookML 範例專案

LookML 專案是一系列的 LookML 檔案，可告知 Looker 如何連線至資料庫、如何查詢資料，以及如何在使用者介面中呈現資料。在本快速入門導覽課程中，您將使用在 Looker (Google Cloud Core) 執行個體上自動設定的 LookML 範例專案。

如要在 Looker IDE 中前往 LookML 專案範例檔案，請按照下列步驟操作：

1. 按一下 Looker 主選單圖示 menu，然後選取「Develop」(如果系統尚未顯示「Develop」選單)。
2. 在「Develop」選單中，選取「sample_thelook_ecommerce」。

Looker 會開啟 Looker IDE 的「File Browser」面板，並顯示 LookML 範例專案檔案。

建立新的專案資料夾

為避免在本快速入門導覽課程中建立的檔案與 LookML 範例專案中的其他檔案混淆，您將為快速入門檔案建立新的專案資料夾。

如要在專案中建立資料夾，請按照下列步驟操作：

1. 在 Looker IDE 的「File Browser」面板中，按一下面板頂端的「Add file or folder」add 圖示，然後從「Add file or folder」選單中選取「Create Folder」選項。

2. 輸入新資料夾的名稱 quickstart。

3. 按一下 [建立]。

Looker 會將新資料夾新增至 Looker IDE 中的「File Browser」面板。

IDE 資料夾的其他資訊

如要進一步瞭解如何在 LookML 專案中使用資料夾，請參閱下列說明文件：

• 如要日後自行建立資料夾和檔案，以及瞭解在專案中建立資料夾時的考量，請參閱「管理 LookML 檔案和資料夾」說明頁面。
• 如要進一步瞭解 Looker IDE 檔案瀏覽器，請參閱「使用 IDE 檔案瀏覽器」說明文件頁面。

建立新的 LookML 模型檔案

LookML 模型檔案會指定資料庫連線，以及使用該項連線的一組 Looker 探索。使用者可在 LookML 中建模資料後，透過「探索」查詢 Looker 中的資料 (請參閱「在 Looker 中查看及與探索互動」)。

如要在 LookML 專案中建立新的模型檔案，請按照下列步驟操作：

1. 在 Looker IDE 的「File Browser」面板中，選取您在建立新的專案資料夾程序中建立的 quickstart 資料夾，然後點選該資料夾旁的三點 「Folder Options」選單。
2. 在「資料夾選項」選單中，選取「建立模型」。
3. 在「Create File」對話方塊中，輸入新檔案的名稱 quickstart_practice，然後按一下「Create」。Looker 會在 quickstart 資料夾下建立 quickstart_practice.model 檔案，並在 Looker IDE 中開啟新檔案。「File Browser」面板中檔案旁的藍色圓點表示檔案為新檔案。
4. 在「File Browser」面板中，按一下 quickstart 資料夾展開，然後查看 quickstart_practice.model 檔案。
5. 在 Looker IDE 中，按一下 quickstart_practice.model 檔案開啟檔案 (如果檔案尚未開啟)。

quickstart_practice.model 檔案包含 LookML 範例，可做為專案的起點。目前，您可以保留這個檔案。在快速入門的後續內容中，您將在模型檔案中建立 Explore。

模型檔案的其他資訊

如要日後自行建立模型檔案，請參考下列資源：

• 如需模型檔案的一般資訊，請參閱 LookML 專案檔案說明文件頁面中的「模型檔案」一節。
• 如需完整程序和其他在專案中建立檔案的選項，請參閱「管理 LookML 檔案和資料夾」說明文件。
• 如要瞭解 LookML 檔案的命名慣例，請參閱「管理 LookML 檔案和資料夾」頁面中的「開始前：重要檔案和資料夾命名慣例」一節。
• 如要進一步瞭解可在模型檔案中使用的 LookML 參數，請參閱「模型參數」說明文件頁面。

建立新的 LookML 檢視畫面檔案

在 LookML 中，檢視表會對應到資料庫中的單一資料表或單一衍生資料表。檢視檔案會指定要查詢的資料庫資料表，以及要從該資料庫資料表中納入的欄位 (維度和測量指標)。在檢視檔案中定義欄位後，您可以使用 $ 替換運算子，在 LookML 的其他部分參照該欄位。這樣一來，您就能在單一位置定義欄位，並在 LookML 專案的多個位置使用該欄位。

建立新檢視畫面檔案的方式有很多種，但最簡單的做法是讓 Looker 自動根據資料庫中現有的資料表產生檢視畫面檔案。

如要讓 Looker 產生新的檢視畫面檔案，請按照下列步驟操作：

1. 在 Looker IDE 的「File Browser」面板中，選取您在建立新的專案資料夾程序中建立的 quickstart 資料夾，然後點選該資料夾旁的三點 「Folder Options」選單。
2. 從「資料夾選項」選單中選取「從表格建立檢視畫面」。

3. 在「Create Views from Tables」(從資料表建立檢視畫面)頁面中，按一下「Enter custom db」(輸入自訂資料庫)輸入欄位，然後輸入 bigquery-public-data：

   

4. 按下 Enter 鍵，即可查看 BigQuery 公開資料集。

5. 捲動清單，直到找到 thelook_ecommerce 資料集。

6. 按一下「thelook_ecommerce」資料集來展開。

7. 選取 order_items 資料表。

8. 按一下頁面底部的「Create Views」按鈕。

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 檢視檔案建立 Explore，請按照下列步驟操作：

1. 在 Looker IDE 中開啟 quickstart_practice.model 檔案。

2. 在 quickstart_practice.model 檔案中，將包含 include 參數的現有行替換為以下行：

   include: "/quickstart/order_items.view"
   

3. 在 include 參數下方新增一行，然後輸入下列 LookML： 值，您可以從欄位中選取 none explore: order_items {}

4. 按一下 Looker IDE 頂端的「Save Changes」按鈕。

這個探索是允許使用者查詢 order_items 檢視畫面的最基本範例。從這個起點開始，您可以透過多種方式建立 Explore。

探索功能的其他資訊

如要日後自行建立及建構探索，請參考下列資源：

• 如要進一步瞭解如何建立探索資料，請參閱「建立及編輯探索資料」說明文件頁面。
• 如要瞭解如何在其他檢視畫面中彙整資料，請參閱「在 LookML 中使用彙整功能」說明文件。
• 如要進一步瞭解可用於探索的 LookML 參數，請參閱「探索參數」說明文件頁面。
• 如要瞭解如何在 Looker UI 的「探索」頁面中查詢資料，請參閱「在 Looker 中查看及互動探索項目」說明文件頁面。

建立新欄位

在本快速入門指南的「建立新的 LookML 檢視檔案」一節中建立檢視檔案後，您可以查看 Looker 自動建立的欄位。建立以資料庫資料表為基礎的檢視檔案時，Looker 會自動建立維度、維度群組和度量：

• 維度是代表屬性、事實或值的欄位，使用者可在 Explore 中從欄位挑選器中選取，並用於篩選查詢。如果欄位不在 SUM、COUNT 等匯總函式中，則為維度。Looker 會自動為資料庫資料表中的每個欄建立維度。
• 維度群組可用於一次建立一組以時間或時間長度為依據的維度。舉例來說，時間戳記欄的維度群組會包含日期、月份、季度、時間、週和年份的個別維度。Looker 會自動為 Looker 在資料庫資料表中偵測到的時間欄位建立維度群組。
• 評估指標是 Explore 中的欄位，用於表示資料的量測資訊，例如加總、計數等。評估指標會在檢視檔案中宣告，可為匯總或非匯總類型。Looker 會自動為檢視表檔案建立 type:count 的評量，這相當於 SQL 中的 COUNT(*)。

在本節中，您將瞭解如何手動將自己的維度新增至 order_items 檢視畫面檔案。

如要在 order_items 檢視檔案中手動建立新維度，請按照下列步驟操作：

1. 開啟 quickstarts/order_items.view 檔案 (如果尚未開啟)：在 Looker IDE 的「File Browser」面板中，按一下「quickstart」資料夾展開資料夾，然後按一下 order_items.view 檔案開啟檔案。
2. 在 quickstarts/order_items.view 檔案中，在檔案中第一個 dimension 參數前建立新行。

3. 在新行中開始輸入 dimension。您輸入內容時，Looker IDE 會顯示清單，列出開頭與您輸入的文字相符的可能參數。

   • 使用方向鍵在建議清單中瀏覽至 dimension 選項。
   • 按下 Enter 鍵，即可將所選參數插入 LookML。Looker 會在您建立的新行中插入新的 dimension 參數。

4. 如要為新維度提供名稱，請在 IDE 中按一下 {} 前，然後輸入 shipped_to_delivered_days。

5. 按一下 {} 內部，然後按下 Enter 鍵，即可在 {} 內建立新行。

6. 完成新維度的 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} ;;
   }
   

7. 按一下 Looker IDE 頂端的「儲存變更」按鈕。

Looker 會使用新維度儲存檢視檔案。對於檔案中的新行，Looker IDE 會以綠色陰影顯示行號。

LookML 欄位的其他資訊

如要日後自行建立欄位，請參考下列資源：

• 如需 LookML 欄位的一般資訊，請參閱 LookML 欄位參考資料說明文件頁面。
• 如要進一步瞭解您可以在資料檢視檔案中建立的維度、篩選器和參數類型，請參閱「維度、篩選器和參數類型」說明文件頁面。
• 如要進一步瞭解可在檢視檔案中建立的測量指標類型，請參閱「測量指標類型」說明文件頁面。

在 Looker 使用者介面中查看及測試變更

如果您已執行「為檢視畫面建立探索」程序，為 order_items 檢視畫面檔案建立探索，就能在 Looker 探索 UI 中看到新的維度。

如要在 Looker UI 的「探索」中查看及測試變更，請按照下列步驟操作：

1. 在 Looker IDE 的 quickstarts/order_items.view 檔案中，按一下檔案編輯器面板頂端的檢視檔案名稱旁的「See file actions」箭頭圖示，然後選取「Explore Order Items - quickstart_practice」選項。

   

2. 在「Order Items」探索欄位挑選器中，按一下「Other Dates」群組標籤展開，然後點選「Shipped to Delivered Days」維度，將其加入探索。(您也可以在欄位挑選器搜尋框中輸入 Shipped to Delivered Days，搜尋維度)。

3. 在「Order Items」探索欄位挑選器中，按一下「Shipped Date」群組標籤展開，然後點選「Date」維度，將其新增至探索。

4. 在「Order Items」探索欄位挑選器中，按一下「Delivered Date」群組標籤展開，然後點選「Date」維度，將其新增至探索。

5. 按一下「探索」頁面頂端的「執行」按鈕。

Looker 會執行查詢，並在「探索」的「資料」部分顯示結果。你可以驗證每個項目的「Order Items Shipped to Delivered Days」值，確認「Order Items Shipped Date」值和「Order Items Delivered Date」值之間的差距為正確的天數。

驗證 LookML

在本快速入門導覽課程中，您不需要驗證 LookML。不過，日後您自行建立專案來建立資料模型時，建議您瞭解 Looker 工具，以便驗證 LookML。

編輯 LookML 時，Looker IDE 會針對單一檔案中未解決的語法錯誤發出警示 (請參閱 Looker IDE 總覽說明文件頁面)。您也可以執行完整的模型驗證，檢查 LookML 是否有任何錯誤。詳情請參閱「驗證 LookML」說明文件。

修訂變更

在本快速入門導覽課程中，您將使用為範例 LookML 專案設定的預先設定 Git 連線。不過，日後您自行建立專案來建立資料模型時，就需要為專案設定 Git 連線。

在 LookML 專案檔案中進行變更時，Looker IDE 會在 IDE 右上角的 Git 按鈕中顯示不同的操作。這個按鈕會顯示不同的作業，引導您驗證 LookML 並將變更部署至實際環境。

您在本快速入門課程中查看的 LookML 檔案和探索功能，僅會在開發模式下顯示在您的個人 Git 分支中。如果您想讓 Looker (Google Cloud Core) 執行個體中的其他使用者使用這個模型，請提交變更、合併分支，然後部署正式版分支。

在本快速入門導覽課程中，您不會將變更部署至實際工作環境。請按照「清理」程序刪除這些檔案。