建立新的 LookML 專案

專案是一系列 LookML 檔案，用來說明資料庫資料表彼此之間的關係，以及 Looker 應如何解讀這些資料表。如要進一步瞭解專案，請參閱「LookML 專案和開發模型」和「LookML 術語和概念」說明文件頁面。如要瞭解如何存取及編輯現有專案，請參閱「存取及編輯專案資訊」說明文件頁面。

LookML 專案可包含多個模型檔案。不過，如要指定使用者查看及編輯特定模型檔案 LookML 的權限，建議您建立新專案。雖然 Looker 中的大多數權限都適用於模型層級，但有些權限適用於專案層級，包括 see_lookml (可讓您查看專案的 LookML) 和 develop (可讓您編輯 LookML)。

具備 manage_models 權限的 Looker 使用者，可以在 Looker 執行個體上建立 LookML 模型。

建立專案

如要建立專案，請按照下列步驟操作：

  1. 確認您處於開發模式。

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

  3. 在「LookML 專案」頁面，選取「新增 LookML 專案」，然後選取專案選項。

系統會開啟「New Project」頁面，您可以在這裡指定專案設定，包括專案名稱和起點。

Looker 可透過多種方式建立專案，具體步驟取決於您在「New Project」頁面選擇的「Starting Point」選項。以下各節將說明這些起點的運作方式：

自動從資料庫生成模型

在「New Project」頁面中，指定下列選項，自動從資料庫生成模型。

  1. 專案名稱：為專案命名。專案名稱區分大小寫，且只能使用英數字元、_、. 和 -。請謹慎選擇專案名稱，並將其視為專案的永久 ID，因為 Looker 會以下列方式使用專案名稱：

    • 識別含有 project_id 參數的 API 呼叫專案。
    • 用於識別 Looker 執行個體內部資料庫中的專案。
    • 用於識別本機專案匯入的專案。
    • 在「LookML 專案」頁面顯示專案。
    • 在 Looker 導覽面板的「開發」部分顯示專案。
    • 專案檔案網址的一部分。舉例來說，如果 Looker 執行個體的網址為 example.looker.com，則專案 ecommerce 的專案資訊清單檔案網址為 https://example.looker.com/projects/ecommerce/files/manifest.lkml。

  2. Starting Point：選擇「Generate Model from Database Schema」。

  3. 連線：從下拉式選單中選取資料庫連線名稱。

  4. Build Views From：選取下列其中一個選項：

    • 「All Tables」：LookML 產生器會為資料庫中的每個資料表建立檢視表檔案。
    • 單一資料表：LookML 產生器會為資料庫中的一個資料表建立檢視表。如果選擇這個選項，請輸入資料庫資料表的名稱。

  5. 結構定義：如要只為資料庫中的一個結構定義產生檔案，請在「結構定義」文字欄位中輸入結構定義名稱。您可以列出多個結構定義，並以半形逗號分隔。

  6. 忽略前置字串：如要從檢視表檔案名稱中排除資料表前置字串，請在「忽略前置字串」欄位中輸入資料庫的前置字串。這個欄位須區分大小寫。您可以列出多個前置字串，並以半形逗號分隔。舉例來說，資料表名稱為 dwh_orders 和 DBS_users。如果您在「Ignore Prefixes」(忽略前置字串) 文字欄位中輸入 dwh, DBS，Looker 就會建立名為 orders 和 users 的檢視表檔案。

最後，按一下「建立專案」，建立包含生成模型的專案。

  • LookML 產生器會為專案建立一個模型檔案，並為資料庫中的每個資料表建立一個檢視表檔案 (除非另有指定)。接著，Looker 會在 Looker IDE 中開啟新專案。
  • LookML 產生器會為檢視表和模型檔案建立 IDE 資料夾。如果資料庫有多個結構定義，LookML 產生器會建立結構定義資料夾。

如果是 BigQuery 連線，當您從資料庫產生 LookML 專案時，Looker 會自動填入欄位說明，並使用 BigQuery 資料欄中繼資料的說明 (如有)。

產生器也會為每個資料庫資料表建立探索。如要開始查詢資料，請使用「探索」面板選取探索檢視表的名稱。

從「New Project」(新增專案) 頁面複製公開 Git 存放區

如果您在「New Project」頁面中選取「Clone Public Git Repository」做為起點，Looker 會將公開 Git 存放區中的檔案複製到新的 LookML 專案。

Looker 支援使用存放區的 HTTPS 網址，複製公開 Git 存放區。

如要將現有的公開 Git 存放區複製到 Looker 專案，請按照下列步驟操作：

  1. 確認您處於開發模式。
  2. 在 Looker 導覽面板的「開發」部分，選取「專案」。

  3. 在「LookML 專案」頁面，視執行個體的設定而定，執行下列其中一項操作：

    • 點選「New LookML 專案」按鈕，開啟「New Project」頁面。
    • 點選「New Model」按鈕，開啟「Create a Model」頁面，然後在「Create a Model」頁面的資訊橫幅中，點選「click here」連結，開啟「New Project」頁面。

  4. 在「Project Name」欄位中，為專案命名。專案名稱區分大小寫，不得使用空格或特定特殊字元。請謹慎選擇專案名稱，並將其視為專案的永久 ID，因為 Looker 會以下列方式使用專案名稱：

    • 識別含有 project_id 參數的 API 呼叫專案。
    • 用於識別 Looker 執行個體內部資料庫中的專案。
    • 用於識別本機專案匯入的專案。
    • 在「LookML 專案」頁面顯示專案。
    • 在 Looker 導覽面板的「開發」部分顯示專案。
    • 專案檔案網址的一部分。舉例來說，如果 Looker 執行個體的網址為 example.looker.com，則專案 ecommerce 的專案資訊清單檔案網址為 https://example.looker.com/projects/ecommerce/files/manifest.lkml。

  5. 在「Starting Point」(起點) 欄位中，選取「Clone Public Git Repository」(複製公開 Git 存放區)。

  6. 在「Git Repository URL」(Git 存放區網址) 欄位中，輸入公開 Git 存放區的網址。請確認網址格式為 https://github.com/example/my-repository.git。

  7. 按一下「建立專案」。Looker 會複製存放區，並在 Looker IDE 中開啟新的 LookML 專案，其中包含複製存放區的專案檔案。

Looker 建立新的 LookML 專案後，您必須連線至 Git 存放區，設定 Git 版本管控。如要瞭解如何使用 HTTPS 或 SSH 連線至 Git，請參閱「設定及測試 Git 連線」說明文件頁面。

視情況而定，您可能需要設定 Git 連線，將變更推送至自己的 Git 存放區，或將變更推送回原始的複製 Git 存放區：

  • 如要將複製的檔案做為專案的起點，並與公開 Git 存放區分開，請設定專案的 Git 連線，指向自己的 Git 存放區，並將變更推送至該處。
  • 如果您想將更新內容回傳至複製的公開 Git 存放區，且擁有具備公開存放區讀取/寫入權限的個人存取權杖，請設定專案的 Git 連線，指向公開 Git 存放區，並將變更推送至該處。

設定存放區的 Git 連線後，您可以在 Looker IDE 中編輯檔案，然後使用版本管控功能，將變更部署至正式環境，就像任何標準 LookML 專案一樣。

複製公開 Git 存放區的替代方法

如要複製公開 Git 存放區，最簡單的方法是使用 Looker 的「New Project」(新增專案) 頁面。

或者，您也可以建立存放區分支，並連結至 Looker 中的空白專案，步驟如下：

  1. 前往 Git 供應商並建立存放區分支。
  2. 在 Looker 中，按照本頁「建立空白專案」一節的說明建立空白專案。
  3. 建立新的空白 LookML 專案後，請使用 HTTPS 或 SSH，設定專案與 Git 存放區分支版本的 Git 連線。

設定好 Git 連線至存放區分支版本後，您可以在 Looker IDE 中編輯檔案，然後使用版本管控功能，將變更部署至正式環境，就像任何標準 LookML 專案一樣。

建立空白專案

如果您在「New Project」頁面選取「Blank Project」做為起點，Looker 會建立空白專案，讓您從頭開始建立 LookML 檔案。

如要建立空白專案，請按照下列步驟操作：

  1. 確認您處於開發模式。
  2. 在 Looker 導覽面板的「開發」部分，選取「專案」。

  3. 在「LookML 專案」頁面，視執行個體的設定而定，執行下列其中一項操作：

    • 點選「New LookML 專案」按鈕，開啟「New Project」頁面。
    • 點選「New Model」按鈕，開啟「Create a Model」頁面，然後在「Create a Model」頁面的資訊橫幅中，點選「click here」連結，開啟「New Project」頁面。

  4. 在「Project Name」欄位中，為專案命名。專案名稱區分大小寫，且不得使用空格或特定特殊字元。請謹慎選擇專案名稱，並將其視為專案的永久 ID，因為 Looker 會以下列方式使用專案名稱：

    • 識別含有 project_id 參數的 API 呼叫專案。
    • 用於識別 Looker 執行個體內部資料庫中的專案。
    • 用於識別本機專案匯入的專案。
    • 在「LookML 專案」頁面顯示專案。
    • 在 Looker 導覽面板的「開發」部分顯示專案。
    • 專案檔案網址的一部分。舉例來說，如果 Looker 執行個體的網址為 example.looker.com，則專案 ecommerce 的專案資訊清單檔案網址為 https://example.looker.com/projects/ecommerce/files/manifest.lkml。

  5. 在「Starting Point」欄位中，選擇「Blank Project」。

  6. 按一下「建立專案」。Looker 會建立專案，並在 Looker IDE 中開啟。

排解「專案已存在」錯誤

在 Looker IDE 中建立新專案時，即使專案未顯示在 Looker UI 中 (包括具備管理員權限的使用者)，您仍可能收到 Project already exists 錯誤。如果使用者先前在開發模式中建立同名專案，但未部署模型或將變更推送至正式環境，就會發生這個問題。在 Looker 中，只有建立專案的使用者才能看到未提交狀態的專案。

如要解決這個問題，請找出專案建立者，並以該使用者的身分提交及部署專案，或刪除專案，步驟如下。您必須是 Looker 管理員，或具備 sudo 權限，才能以專案建立者的身分執行 sudo。

1. 找出專案建立者：在系統活動探索中，使用專案名稱執行查詢，找出最初建立專案的使用者。 1. 模擬建立者：使用 Looker 的模擬功能，冒用已識別的使用者身分。 1. 管理或刪除專案：以建立者身分登入後，切換至開發模式。專案現在會顯示在 IDE 中。您可以設定或部署專案，也可以刪除專案，釋出專案名稱。

後續步驟

建立專案後，您可以執行下列操作：