建立新的 LookML 專案

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

LookML 專案可以包含多個模型檔案。不過，如果您想為使用者指定查看及編輯特定模型檔案 LookML 的權限，建議您建立新專案。雖然 Looker 中的大部分權限都會套用至模型層級，但有些權限會套用至專案層級，包括可讓您查看專案 LookML 的 see_lookml，以及可讓您編輯 LookML 的 develop。

擁有 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 導覽面板的「Develop」區段中顯示專案，請按照下列步驟操作：
    • 專案檔案網址的一部分。舉例來說，在 Looker 執行個體的網址為 example.looker.com 的情況下，您可以透過以下網址找到名為 ecommerce 的專案資訊清單檔案：https://example.looker.com/projects/ecommerce/files/manifest.lkml。

  2. 起點：選擇「從資料庫結構定義產生模型」。

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

  4. 建立檢視畫面來源：請選取下列其中一個選項：

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

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

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

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

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

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

產生器也會為每個資料庫資料表建立「探索」功能。如要開始查詢資料，請在「探索」面板中選取探索名稱。

複製公開 Git 存放區

如果您選取「複製公開 Git 存放區」做為起點，Looker 就會將公開 Git 存放區中的檔案複製到新的 LookML 專案。

從公開 Git 存放區複製的 Looker 專案為唯讀。不過，您可以將唯讀專案匯入其他 Looker 專案，然後在該專案中編輯檔案。此外，您可以使用複製的存放區檔案做為起點，然後使用 Looker extends 參數或精修，從中建立專案。

在「New Project」頁面中，指定下列選項，將現有的公開 Git 存放區複製到 Looker 專案：

  1. 專案名稱：為專案命名。專案名稱會區分大小寫，且不得包含空格或特定特殊字元。請謹慎選擇專案名稱，並將其視為專案的永久 ID，因為 Looker 會以以下方式使用專案名稱：

    • 識別含有 project_id 參數的 API 呼叫專案。
    • 在 Looker 執行個體的內部資料庫中識別專案。
    • 用於匯入本機專案時識別專案。
    • 在 LookML 專案頁面上顯示專案。
    • 如要在 Looker 導覽面板的「Develop」區段中顯示專案，請按照下列步驟操作：
    • 專案檔案網址的一部分。舉例來說，在 Looker 執行個體的網址為 example.looker.com 的情況下，您可以透過以下網址找到名為 ecommerce 的專案資訊清單檔案：https://example.looker.com/projects/ecommerce/files/manifest.lkml。

  2. 起點：選擇「Clone Public Git Repository」。

  3. Git 存放區網址：輸入公開 Git 存放區的網址。請確認網址採用 git://github.com/example/my-repository.git 格式。

    如果您有 https://github.com/llooker/blocks_redshift_admin 這類網址，可以將「https://」替換成「git://」，然後在結尾加上「.git」，即可編輯成正確格式。您輸入的網址會是 git://github.com/llooker/blocks_redshift_admin.git。

最後，按一下「建立專案」。Looker 會將所有公開存放區的檔案拉入新的 LookML 專案，並在 Looker IDE 中開啟專案。

建立空白專案

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

在「New Project」頁面中指定下列選項，即可建立空白專案：

  1. 專案名稱：為專案命名。專案名稱有大小寫之分，且不得包含空格或特定特殊字元。請謹慎選擇專案名稱，並將其視為專案的永久 ID，因為 Looker 會以以下方式使用專案名稱：

    • 識別含有 project_id 參數的 API 呼叫專案。
    • 在 Looker 執行個體的內部資料庫中識別專案。
    • 用於匯入本機專案時識別專案。
    • 在 LookML 專案頁面上顯示專案。
    • 如要在 Looker 導覽面板的「Develop」區段中顯示專案，請按照下列步驟操作：
    • 專案檔案網址的一部分。舉例來說，在 Looker 執行個體的網址為 example.looker.com 的情況下，您可以透過以下網址找到名為 ecommerce 的專案資訊清單檔案：https://example.looker.com/projects/ecommerce/files/manifest.lkml。

  2. 起點：選擇「空白專案」。

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

後續步驟

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