產生 LookML 模型

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

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

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

  • 您可以使用舊版方法建立專案和產生模型，方法是點選下列任一選項，即可前往舊版「新專案」頁面：

    進入「新專案」頁面後，請按照「建立新的 LookML 專案」說明文件中的步驟操作。

存取「Create a Model」(建立模型) 頁面

您可以透過下列方式存取「Create a Model」頁面：

如要存取「Create a Model」(建立模型) 頁面，您必須處於開發模式。

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

在「開發」部分

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

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

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

  3. 這項選項會開啟「LookML 專案」頁面。您可以透過「LookML 專案」頁面查看自己有權存取的所有專案，以及各專案的模型。在「LookML 專案」頁面中，選取「新建模式」按鈕，開啟「建立模式」頁面。

透過「建立」按鈕

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

  1. 在主要導覽選單中，按一下「建立」按鈕。
  2. 在下拉式選單中選取「LookML 模型」。系統會隨即開啟「Create a Model」(建立模型) 頁面。

產生模型

「Create a Model」頁面分為多個部分，如要產生模型，請完成下列各節中的步驟。每個部分結束後，請按一下「下一步」，儲存輸入內容並前往下一節。

  1. 選取資料庫連線：

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

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

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

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

    • 點選「下一步」按鈕，即可儲存項目並前往下一個部分。

  2. 選取資料表：

    • 如果您使用的是 BigQuery 連線，請從「Select GCP project」下拉式選單中選取資料集所在的 Google Cloud 專案，或是在「Search Project Name」欄位中搜尋專案。根據預設，如果有 Google Cloud 儲存空間專案，系統會在下拉式選單中顯示該專案；如果沒有，則會顯示 Google Cloud 帳單專案。
    • 在表格中選取模型中要使用的資料集 (BigQuery) 或結構定義 (其他方言)。
    • 選取資料集或結構定義後，請使用每個資料集或結構定義名稱右側的箭頭，開啟「Tables」分頁，然後選取要納入的每個資料表。系統會依據資料表建立檢視表。
    • 選取資料表後，請使用每個資料表名稱右側的箭頭開啟「欄位」分頁，然後選取要納入的每個欄位。
    • 忽略前置字串：如要忽略所產生檢視表檔案名稱中的資料表前置字串，請在這個欄位中輸入資料庫的前置字串 (格式為以半形逗號分隔的清單)。這個欄位會區分大小寫。您可以列出多個前置字串，並以半形逗號分隔。舉例來說，您的資料表標題為 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 存放區不同的存放區，請按一下專案「Project Settings」頁面「Configuration」分頁中的「Reset Git Connection」按鈕，完成該程序。

需要設定模型時

設定模型有下列好處：

  • 它指定特定模型名稱是指特定專案中的特定模型。
  • 並設定模型可使用的連線。

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

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

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

  • 模型首次推送至正式環境時。如果未設定模型，模型進入正式發布模式後，對該模型的任何查詢都會失敗。當模型首次從開發模式推送至正式環境時，如果模型名稱在 Looker 執行個體中不重複，Looker 會自動設定模型。不過，如果您在其他專案中已設定名稱相同的模型，Looker 就不會自動設定該模型。
  • 開發期間。如果有開發人員未獲得 manage_models 權限 (admin 角色包含此權限) 或 manage_project_models 權限，則必須先設定模型，這些開發人員才能對該模型執行查詢。您可以在模型或專案建立前設定模型。接著，當 LookML 開發人員建立模型時，模型的允許連線已設定完成，開發人員就能順利執行查詢。

Looker 可讓擁有 manage_models 或 manage_project_models 權限的開發人員在開發模式下，對未設定的模型執行查詢。Looker 會搜尋專案中是否有該名稱的模型，系統會使用找到的第一個名稱相符的模型來執行查詢。

設定規劃模型

Looker 管理員可以使用「LookML 專案」頁面頂端的「設定新模型」按鈕，為現有模型或尚未存在的預定模型新增設定。

如果開發人員未獲得 manage_models 權限或 manage_project_models 權限，預先設定模型就非常實用。如果管理員為開發人員設定模型，開發人員只要產生或建立模型檔案，就能立即執行查詢。

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

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

產生空白專案

如要從頭開始建立 LookML 檔案，建議您建立空白專案。

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

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

請將其餘部分留空。

按一下「Complete and View Model」按鈕，前往 Looker IDE 中的專案。進入 IDE 後，您可以刪除任何不需要的 LookML 檔案，以建立空白專案。

後續步驟

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