產生 LookML 模型

本說明文件頁面說明如何使用「建立模型」頁面，從資料庫連線自動產生基本 LookML 模型。您也可以使用「建立模型」頁面建立專案，存放模型。

您也可以使用其他選項建立模型檔案：

  • 您可以從 IDE 手動建立模型檔案和其他專案檔案。

  • 如要使用舊版方法建立專案及生成模型，請按一下下列任一選項，系統會將您帶往舊版「新專案」頁面：

    • 「建立模型」頁面頂端橫幅中的連結
    • 「專案」頁面「待處理專案」區段中的「新增 LookML」按鈕

    前往「New Project」(新專案) 頁面後，請按照「建立新的 LookML 專案」文件中的步驟操作。

存取「建立模型」頁面

透過下列方式存取「建立模型」頁面：

如要存取「建立模型」頁面，必須處於開發模式。

如要存取「建立模型」頁面，您必須是 Looker 管理員，或具備 develop 權限。

從「開發」部分

如要從「開發」部分存取「建立模型」頁面，請完成下列步驟。

  1. 按一下左側導覽面板中的「開發」。

  2. 在導覽面板的「開發」部分中，選取「專案」。

  3. 選取後會開啟「LookML 專案」頁面。「LookML 專案」頁面會顯示您有權存取的所有專案，以及各專案的模型。在「LookML 專案」頁面中，選取「新增模型」按鈕，開啟「建立模型」頁面。

透過「建立」按鈕

如要透過「建立」按鈕存取「建立模型」頁面，請完成下列步驟。

  1. 在主選單中，按一下「建立」按鈕。
  2. 從下拉式選單中選取「LookML 模型」。「建立模型」頁面隨即開啟。

生成模型

「建立模型」頁面分為多個區段。如要生成模型，請完成下列各節的步驟。填寫完每個部分後，請按一下「下一步」儲存輸入內容，並前往下一個部分。

  1. 選取資料庫連線：

    • 選取資料庫連線：從下拉式選單中選取資料庫連線。你也可以從下拉式選單中選擇「建立新連結」選項。系統會將您帶往「將資料庫連線至 Looker」頁面，您可以在這裡建立新連線。

    • 如果您有權存取已使用連線的任何專案，選取連線後就會顯示這些專案。您可以選擇將新模型新增至現有專案，也可以選擇為模型建立新的 LookML 專案。

    • LookML 專案名稱：如要為模型建立新的 LookML 專案，請在這個欄位中輸入專案名稱。專案名稱會區分大小寫，且只能使用英數字元、_、. 和 -。請務必慎選專案名稱，因為這是專案的永久 ID。新專案會使用裸 Git 存放區設定。

    • 如要讓 Looker 在新專案中新增 README 檔案，請選取「產生 README 檔案，進一步說明如何使用 LookML」核取方塊。README 檔案包含 LookML 簡介，以及可協助 LookML 新手入門的連結和資源。

    • 按一下「下一步」按鈕，儲存輸入內容並前往下一節。

  2. 選取資料表：

    • 如果您使用 BigQuery 連線，請從「Select GCP project」(選取 GCP 專案) 下拉式選單中選取資料集所在的 Google Cloud 專案，或在「Search Project Name」(搜尋專案名稱) 欄位中搜尋專案。如果 Google Cloud 儲存空間專案存在，下拉式選單中預設會顯示該專案；如果不存在，則會顯示 Google Cloud 帳單專案。
    • 在表格中，選取要在模型中使用的資料集 (BigQuery) 或結構定義 (其他方言)。
    • 選取資料集或結構定義後，請點選每個資料集或結構定義名稱右側的箭頭，開啟「資料表」分頁，然後選取要納入的每個資料表。系統會依據資料表建立檢視區塊。
    • 選取資料表後，請使用每個資料表名稱右側的箭頭開啟「欄位」分頁，然後選取要納入的每個欄位。
    • 忽略前置字串：如要忽略所產生檢視表檔案名稱中的資料表前置字串，請在這個欄位中輸入資料庫的前置字串 (格式為以半形逗號分隔的清單)。這個欄位會區分大小寫。您可以列出多個前置字元，並以半形逗號分隔。舉例來說，您的資料表標題為 dwh_orders 和 DBS_users。如果您在「Ignore Prefixes」(忽略前置字串) 欄位中輸入 dwh, DBS，Looker 會建立名為 orders 和 users 的檢視區塊檔案。
    • 匯入欄位說明：選取這個核取方塊，即可將資料庫中任何可用的欄位說明，做為所產生維度的 LookML 說明。
    • 按一下「下一步」按鈕，儲存輸入內容並前往下一節。

  3. 選取主鍵：

    • 為所選的每個資料表選取主鍵。讓 Looker 更準確地彙整資料表。
    • 這個步驟為選用步驟，如要略過，請勿選取任何主鍵。
    • 按一下「下一步」按鈕，儲存輸入內容並前往下一節。

  4. 選取要建立的探索：

    • 選取要使用的各個檢視表，以便做為探索的基本檢視表。針對您選取的各個檢視表，系統會盡可能自動彙整所有其他檢視表。檢視表必須具備在前一個步驟中識別出的主鍵，才能用於彙整作業。
    • 這個步驟為選用步驟，如要略過，請不要選取任何檢視畫面。
    • 按一下「下一步」按鈕，儲存輸入內容並前往下一節。

  5. 輸入模型名稱：

  6. 按一下下列任一按鈕，即可產生模型檔案和 (如果選取) 新專案：

    • 填寫並查看模型：Looker 會將您帶往 Looker IDE 中的檔案。
    • 完成並探索資料：Looker 會將您帶往「Select Explores to Create」(選取要建立的探索) 專區中，與第一個所選檢視檔案對應的探索。

  7. 如果您建立新專案，並想將專案連結至與 Looker 用於建立專案的裸 Git 存放區不同的存放區，請點選專案「專案設定」頁面「設定」分頁中的「重設 Git 連線」按鈕，完成該程序。

需要設定模型時

設定模型有以下好處：

  • 這項屬性會指定特定模型名稱是指特定專案中的特定模型。
  • 設定模型可使用的連線。

管理員 (或具備 manage_models 或 manage_project_models 權限的開發人員) 處於開發模式時，不需要模型設定。LookML 開發人員可在開發模式下工作。不過，如果模型設定存在，即使在開發模式下，任何查詢都會受到該設定的限制。

雖然 LookML 開發人員會在模型檔案中指定預期連線，但管理員會在「LookML 專案」頁面控管允許的連線。如果模型指定使用模型設定中不允許的連線，則該連線不允許使用。

在下列情況下，模型必須具備設定：

  • 首次將模型推送至正式環境時。如果未設定模型，模型進入正式版模式後，對該模型的所有查詢都會失敗。首次將模型從開發模式推送至正式環境時，如果模型名稱在 Looker 執行個體中是唯一的，Looker 會自動設定模型。不過，如果您在其他專案中設定了同名模型，Looker 就不會自動設定模型。
  • 開發期間。如果開發人員未獲授 manage_models 權限 (包含在 admin 角色中) 或 manage_project_models 權限，就必須先設定模型，才能對該模型執行查詢。您可以在模型或專案存在之前設定模型。這樣一來，LookML 開發人員建立模型時，系統會預先設定模型的允許連線，開發人員就能順利執行查詢。

開發人員只要具備 manage_models 或 manage_project_models 權限，就能在開發模式中，對未設定的模型執行查詢。Looker 會搜尋專案中是否有該名稱的模型。系統會使用第一個找到的同名模型執行查詢。

設定預計模型

Looker 管理員可以透過「LookML Projects」頁面頂端的「Configure New Model」按鈕，為現有模型或尚未建立的預定模型新增設定。

如果開發人員未獲得 manage_models 權限或 manage_project_models 權限，預先設定模型就很有用。如果管理員為開發人員設定模型，開發人員就能在生成或建立模型檔案後立即執行查詢。

管理員也可以指定模型可使用的資料庫連線，或允許模型使用任何目前或未來的連線。Looker 開發人員使用 LookML connection 參數，在模型檔案中指定模型應使用的連線。如果開發人員指定的連線未獲管理員在模型設定中允許，則該模型上的任何查詢都無法執行。

管理員預先設定新模型，並在該設定中建立新專案時，該專案會顯示在「專案」頁面的「待處理專案」部分。

產生空白專案

如要從頭開始建立 LookML 檔案，建立空白專案會很有幫助。

「建立模型」頁面會產生包含 LookML 檔案的專案。不過，您可以在「建立模型」頁面中只完成下列部分，盡量減少產生的 LookML 檔案：

  • 選取資料庫連線
  • 選取資料表
  • 輸入模型名稱

其餘部分則留空。

按一下「完成並查看模型」按鈕，系統會將您帶往 Looker IDE 中的專案。進入 IDE 後，您可以刪除任何不需要的 LookML 檔案，建立空白專案。

後續步驟

建立模型或專案後，您可以執行下列動作：