LookML 專案中的檔案類型

LookML 專案是一系列 LookML 檔案，可告知 Looker 如何連線至資料庫、如何查詢資料，以及如何控制使用者介面的行為。您可以透過 Looker 中的「Develop」部分或 UI 存取 LookML 專案檔案，詳情請參閱「存取 LookML 專案檔案」說明文件頁面。

Looker 開發人員會使用 IDE 中的資料夾來整理專案檔案。

LookML 專案至少包含一個模型檔案和一個檢視表檔案，以及本頁所述的其他類型檔案。所有專案檔案都有副檔名，但如果您的專案未針對 IDE 中的資料夾啟用，副檔名就會在 IDE 清單中隱藏。

請選取下列連結，進一步瞭解可在 LookML 專案中使用的各類型檔案：

• 副檔名為 .model.lkml 的模型檔案
• 查看副檔名為 .view.lkml 的檔案
• 副檔名為 .dashboard.lookml 的資訊主頁檔案
• 資料檔案：副檔名為 .topojson 或 .geojson 或 .json
• 副檔名為 .md 的文件檔案
• 專案資訊清單檔案，名稱一律為 manifest.lkml
• 資訊清單鎖定檔案 (副檔名為 .lkml)
• 語言代碼字串檔案 (副檔名為 .strings.json)
• 探索副檔名為 .explore.lkml 的檔案
• 資料測試檔案 (副檔名為 .lkml)
• 副檔名為 .lkml 的精修檔案
• 其他檔案：使用先前未列出的任何副檔名

建立 LookML 專案後，您可以使用 Looker IDE 存取專案檔案，並將新檔案和資料夾新增至專案。

模型檔案

模型檔案會指定資料庫連線，以及使用該項連線的一組探索。模型檔案也會定義探索本身，以及與其他檢視畫面之間的關係。「探索」是查詢資料的起點，在 SQL 術語中，探索是查詢的 FROM 子句。使用者查看 Looker「探索」選單時，會看到您在模型中定義的探索。

換句話說，您可以在模型檔案中定義應使用的資料表 (包含的檢視畫面)，以及如何在必要時將這些資料表合併。

請參閱「管理 LookML 檔案和資料夾」說明文件頁面，瞭解如何建立 LookML 專案檔案，包括模型檔案。

結構和一般語法

您可以在探索的圓括號 ({ }) 中定義探索的參數。您可以使用 join 參數，將其他檢視畫面與模型檔案中的 Explore 結合。

在以下範例中，範例模型檔案中的 LookML 定義了名為 inventory_items 的探索，以及其已彙整的檢視畫面：

connection: "thelook_events"

explore: inventory_items {
  join: products {
    type: left_outer
    sql_on: ${inventory_items.product_id} = ${products.id} ;;
    relationship: many_to_one
  }

  join: distribution_centers {
    type: left_outer
    sql_on: ${products.distribution_center_id} = ${distribution_center.id} ;;
    relationship: many_to_one
  }
}

這個 LookML 定義會讓「Inventory Items」顯示在 Looker 導覽的「Explore」專區，並將 products 和 distribution_centers 檢視表的資料彙整至 inventory_items 檢視表。

如要進一步瞭解模型檔案中的 LookML 結構，請參閱 LookML 術語和概念說明文件頁面。

如要進一步瞭解模型檔案中的 LookML 參數，請參閱「模型參數」、「探索參數」和「彙整參數」說明文件。

查看檔案

檢視檔案通常會在 Looker 中定義單一「檢視畫面」。檢視表會對應至資料庫中的單一資料表或單一衍生資料表。檢視檔案會指定要查詢的資料表，以及要從該資料表中納入的欄位 (維度和指標)，方便使用者在 Looker UI 中使用這些欄位建立查詢。

請參閱「管理 LookML 檔案和資料夾」說明文件頁面，瞭解如何建立 LookML 專案檔案，包括檢視檔案。

結構和一般語法

每個檢視畫面中的大括號 { } 是欄位定義，通常會對應至底層資料表中的資料欄或 Looker 中的計算。Looker 會將這些定義大多數歸類為維度或度量值。

在下列檢視畫面檔案範例中，orders.view 檔案包含 id、status 和 user_id 維度的定義、created 維度群組和 count 評量：

view: orders {
  sql_table_name: demo_db.orders ;;
  drill_fields: [id]

  dimension: id {
    primary_key: yes
    type: number
    sql: ${TABLE}.id ;;
  }

  dimension: status {
    type: string
    sql: ${TABLE}.status ;;
  }

  dimension: user_id {
    type: number
    # hidden: yes
    sql: ${TABLE}.user_id ;;
  }

    dimension_group: created {
    type: time
    timeframes: [
      raw,
      time,
      date,
      week,
      month,
      quarter,
      year
    ]
    sql: ${TABLE}.created_at ;;
  }

  measure: count {
    type: count
    drill_fields: [id, users.id, users.first_name, users.last_name, order_items.count]
  }
}

orders 檢視畫面中這些欄位的定義會在「Orders」探索工具的欄位挑選器中，顯示「Created Date」、「ID」、「Status」、「User ID」和「Count」欄位。

有權存取「訂單」探索功能的使用者，可以選取這些欄位並篩選，以便查詢「訂單」探索功能。

除了維度和指標之外，您還可以使用維度群組一次建立多個以時間為準的維度，或是使用篩選器欄位為使用者指定篩選器。請參閱「檢視畫面參數」說明文件頁面，進一步瞭解檢視畫面檔案中的 LookML 參數，並參閱「欄位參數」說明文件頁面，瞭解用於定義 LookML 中的維度、指標、維度群組和篩選器欄位的 LookML 參數。

資訊主頁檔案

Looker 支援兩種類型的資訊主頁：

• 使用者定義的資訊主頁：非開發人員使用者不必使用 LookML 即可建立這類資訊主頁。詳情請參閱「建立使用者定義的資訊主頁」說明文件。
• LookML 資訊主頁：儲存為與專案相關的版本管控檔案。

如果專案包含 LookML 資訊主頁，這些資訊主頁會在 IDE 的專屬資訊主頁檔案中定義，並使用 .dashboard.lookml 副檔名。

如要進一步瞭解 LookML 資訊主頁，請參閱「建立 LookML 資訊主頁」說明文件。

文件檔案

您可以使用 GitHub 風格的 Markdown 編寫 Looker 資料模型的說明文件或其他備註。這有助於使用者熟悉貴機構的 Looker 使用方式。

請參閱「管理 LookML 檔案和資料夾」說明文件，瞭解如何建立 LookML 專案檔案，包括文件檔案。

在 IDE 外部查看文件

如要透過 IDE 以外的方式查看文件 (您必須這樣做才能充分利用本頁所述的導覽功能)，請在文件檔案的「See file actions」選單中，選擇「View Document」選項：

您可以將結果頁面的網址分發給其他使用者，讓他們直接存取文件，而不必透過 Looker 的「Develop」選單瀏覽。

在文件中加入導覽結構

您可以在文件檔案中加入側欄，讓使用者查看資訊結構，並在文件之間瀏覽。

如要為文件新增側欄導覽，請在文件的第一行建立導覽區段。請使用三個破折號 (---) 標示導覽區段的開頭和結尾。

您可以在導覽部分使用下列參數：

• navigation
• title
• section
• label

navigation

您可以在文件檔案中使用 navigation: true，將導覽側欄新增至該文件。舉例來說，您可以將下列程式碼新增至 Markdown 檔案頂端：

---
navigation: true
---

這段程式碼會在文件中加入導覽側欄，其中包含所有專案文件的連結。如果您在文件中只包含 navigation: true，該文件的側欄會依照檔案名稱的字母順序列出所有專案文件。

此外，你可能會發現依照字母順序排列檔案名稱並不理想，或是你不希望某些文件顯示在導覽中：

在這個範例中，您可能會想以數字順序 (而非字母順序) 列出「Document One」、「Document Two」、「Document Three」和「Document Four」，並隱藏導覽側欄中的「Do Not Display」文件。

如要變更導覽側欄中的文件順序，或只在側欄中顯示部分文件，可以使用以下格式：

---
navigation:
  - document_one
  - document_two
  - document_three
  - document_four
---

導覽畫面現在只會顯示您要顯示的文件檔案，且檔案會以更合理的順序顯示：

title

根據預設，側欄會顯示文件的標題 (如果文件以標題開頭)，或文件的檔案名稱 (如果檔案中沒有標題)。您可以在文件頂端新增 title 參數，變更文件在導覽側欄中的顯示方式：

---
title: New Title for Users
---

除非您在文件的導覽部分指定其他 label，否則這個標題會用於所有文件導覽側欄的連結文字。

label

如要變更文件在導覽側欄中的顯示方式，可以使用 document 和 label 參數，如下所示：

---
navigation:
  - document_one
  - document: document_two
    label: Customized Label for Document Two
  - document_three
  - document_four
---

label 值會定義文件在文件側邊導覽中顯示的方式，即使參照的文件有自己的 title 參數也一樣。

上述範例在文件側欄中會如下所示：

section

如要將導覽側欄分成多個部分，可以使用 section 參數，如下所示：

---
navigation:
  - document_one
  - document_two
  - section: My Section Name
  - document_three
  - document_four
---

在這個範例中，section 參數會在側欄中加入區段分隔符和文字標題「My Section Name」。

文字標題本身並非連結，不會參照任何文件檔案。

資料檔案

資料檔案是 JSON 檔案，檔案副檔名為 .json、.topojson 或 .geojson。

map_layer 參數可讓您將 JSON 檔案用做自訂地圖，然後在 Looker 中繪製資料。

接著，您可以使用 map_layer_name 參數搭配維度，將資料值 (例如「巴黎」) 與自訂地圖上的地理區域建立關聯。

您可以在 LookML IDE 中編輯 JSON 檔案，然後選取「Save」。

如要進行偵錯，您可以選擇「View Raw」，方法是選取檔案名稱旁的「See file actions」選單，即可以原始格式查看檔案。如果您在瀏覽器中安裝了可用於查看 JSON 的擴充功能，也可以選擇以「剖析」格式查看檔案。

如要瞭解如何將 JSON 檔案上傳至 LookML 專案，請參閱「管理 LookML 檔案和資料夾」說明文件。

專案資訊清單檔案

您的專案可能包含專案資訊清單檔案，用於執行下列工作：

• 指定要匯入至目前專案的其他專案
• 指定模型本地化設定
• 定義 LookML 常數
• 在專案中新增擴充功能
• 在專案中新增自訂視覺化呈現

每個專案只能有一個資訊清單檔案，且檔案名稱必須為 manifest.lkml，並位於專案目錄結構的根層級和 Git 存放區中。

請參閱「管理 LookML 檔案和資料夾」說明文件頁面，瞭解如何建立 LookML 專案檔案，包括專案資訊清單檔案。

資訊清單鎖定檔案

將遠端依附元件新增至專案資訊清單檔案時，系統會自動建立資訊清單鎖定檔案。Looker 會使用資訊清單鎖定檔案，追蹤資訊清單檔案中指定的遠端專案版本。資訊清單鎖定檔案會列在 Looker IDE 的檔案瀏覽器面板中，檔案名稱為 manifest_lock.lkml。

Looker 開發人員不需要建立或編輯資訊清單鎖定檔案，因為 Looker 會自動管理鎖定檔案。

詳情請參閱「從其他專案匯入檔案」說明文件頁面。

語言代碼字串檔案

如果您要將資料模型本地化，就必須為每個要本地化的語言代碼建立語言代碼字串檔案，包括預設語言代碼 (例如美國的英文)。

語言設定字串檔案會列出模型中各個標籤和說明的鍵/值組合。每個語言代碼的字串檔案應提供每個標籤或說明的語言代碼翻譯。如要進一步瞭解如何建立語言代碼字串檔案，請參閱「將 LookML 模型本地化」說明文件頁面。

請參閱「管理 LookML 檔案和資料夾」說明頁面，瞭解如何建立 LookML 專案檔案，包括語言代碼字串檔案。

探索檔案

探索是使用者可以查詢的檢視畫面。「探索」是查詢的起點，或以 SQL 術語來說，就是 SQL 陳述式中的 FROM。如要瞭解使用者如何透過探索資料查詢資料，請參閱「在 Looker 中查看及操作探索資料」說明文件。

探索通常會在模型檔案中定義。不過，有時您需要為衍生資料表建立個別的 Explore 檔案，或是擴充或精簡跨模型的 Explore。

如需建立 LookML 專案檔案 (包括「探索」檔案) 的操作說明，請參閱「管理 LookML 檔案和資料夾」說明文件。

資料測試檔案

專案可能會有用於驗證 LookML 模型邏輯的資料測試檔案。資料測試可包含在模型檔案或檢視畫面檔案中，但如果開發人員想在多個不同模型中使用相同的資料測試，建議將資料測試保留在專屬檔案中。

如需建立 LookML 專案檔案 (包括資料測試檔案) 的操作說明，請參閱「管理 LookML 檔案和資料夾」說明文件。

分類標籤檔案

專案可能會使用用於LookML 精修的檔案。透過 LookML 精修功能，您可以調整現有的檢視畫面或探索，而無須編輯包含這些項目的 LookML 檔案。LookML 精修項目可包含在模型、檢視表或「探索」檔案中，也可以放在專屬檔案中。

如需建立 LookML 專案檔案 (包括精修檔案) 的操作說明，請參閱「管理 LookML 檔案和資料夾」說明文件。

其他檔案

許多 LookML 元素可存放於專案中的不同檔案，或各自的專屬檔案。舉例來說，資料測試可存放於模型檔案、檢視檔案或專屬的 .lkml 檔案中。