「LookML 專案」頁面會列出 Looker 執行個體上的所有 LookML 專案，並顯示每個專案中的所有模型。
如要前往「LookML projects」(LookML 專案) 頁面，請執行下列步驟：
- 在導覽面板中選取「開發」選項，開啟「開發」面板。
- 在「開發」面板中，選取「專案」。
建立專案
本文件頁面假設您已使用下列其中一種方法建立專案：
查看現有專案及其模型
如要查看現有專案清單，請前往「LookML projects」(LookML 專案) 頁面。
在正式版模式中，「LookML 專案」頁面會列出已產生並推送至正式版的專案。在開發模式中，頁面會列出您從正式版提取的專案，或是您在開發模式中自行產生的專案。「LookML 專案」頁面包含下列基本類別：
- 頂端部分：頂端部分列出的專案已建立，可能包含產生的模型和檢視畫面檔案。如果您是 Looker 管理員，或在專案中至少有一個模型具備
develop權限，您可以在「開發」面板和頁面頂端部分看到專案。 - 「待處理專案」專區：列在「待處理專案」專區中的專案，是指 Looker 管理員已為模型設定允許的連線，但 Looker 開發人員尚未新增 LookML 的專案。如果您有
develop權限，就能查看這些專案。 - 「市集專案」部分：「市集專案」部分列出的專案，是在使用 Looker Marketplace 安裝應用程式、區塊或外掛程式時建立。
如要瞭解如何為現有專案指定新專案或新模型，請參閱「產生模型」說明文件頁面。
查看專案的刊登資訊
「LookML 專案」頁面會顯示每個專案的下列元素：
- 「專案」欄：專案名稱。每個專案旁邊可能會列出一或多個模型。選取專案名稱，即可前往該專案的 LookML。
- 「模型」欄：指定專案的 LookML 模型檔案集。如果開發模式環境與實際工作環境不同，這份清單可能會在開發模式和實際工作環境之間變更。舉例來說，您可能在開發模式中建立新模型，但尚未推送至正式環境。
- 「設定問題」欄：如果模型有問題，模型會顯示狀態，指出設定問題。
- 「設定」按鈕：如果專案提供「設定」按鈕，您可以為該專案新增或編輯模型設定。
如果模型有問題，模型會顯示狀態，指出設定問題。
| 問題 | 說明 |
|---|---|
| LookML 模型檔案尚不存在 | 如果有人在這個頁面設定模型，但尚未為該模型建立對應的 LookML 檔案，就會發生這個問題。 |
| 必須完成設定才能使用 | 如果有人在現有專案中建立新的 LookML 模型檔案，但尚未在這個頁面中設定該檔案，就會發生這個問題。 |
| 連線「x」不存在 | 模型檔案中宣告的 connection 不存在 (例如有人拼錯，或尚未建立)。 |
| 模型「x」不得使用連線「y」 | 根據這個頁面的設定，模型檔案中宣告的 connection 不符規定。 |
| 先前已在專案「y」中設定名為「x」的模型 | 模型名稱在 Looker 執行個體中不得重複，即使模型位於不同專案也一樣。 |
查看 Marketplace 專案的資訊
「LookML 專案」頁面的「Marketplace 專案」部分會列出安裝 Marketplace 應用程式、區塊或外掛程式時建立的專案。每個 Marketplace 專案的項目都包含下列元素：
- 項目：應用程式、模塊或外掛程式在 Looker Marketplace 的項目連結。
- 專案：專案名稱。您可以點按專案名稱，查看或編輯專案的 LookML。
- 「查看 LookML」或「編輯 LookML」按鈕：選取 Marketplace 區塊唯讀核心專案的「查看 LookML」按鈕，或是選取 Marketplace 區塊設定專案的「編輯 LookML」按鈕，即可前往 Marketplace 專案。後者可供自訂。如要進一步瞭解如何自訂 Marketplace 區塊，請參閱「自訂 Looker Marketplace 區塊」說明文件頁面。
- 模型：指定專案的 LookML 模型檔案集。
- 「設定」按鈕：如果專案清單旁顯示「設定」按鈕，表示您可以新增或編輯專案的模型設定。
查看待處理專案的刊登資訊
「待處理專案」部分包含已設定但尚未產生或手動定義 LookML 的專案和模型。
如果開發人員沒有 manage_models 或 manage_project_models 權限，在專案存在前設定模型就很有用。由於模型已設定完成，開發人員建立專案和模型後，就能立即執行查詢。專案產生後，該專案的清單會移至「LookML 專案」頁面的頂端部分。
「待處理的專案」部分包含下列元素：
- 「專案」欄：這部分會列出已設定但尚未產生的專案。這個欄位中的專案名稱是專案的預期名稱。選取專案名稱，即可顯示「新專案」頁面，您可以在該頁面產生專案。您必須處於開發模式，才能前往「New Project」(新專案) 頁面。
- 「模型」欄：建立模型設定時指定的模型名稱。
- 「允許的連線」欄：模型名稱右側的欄會顯示建立模型設定時允許的連線。
- 「設定」按鈕：「設定」按鈕可讓您變更專案名稱，以及允許這個模型使用的連線。
- 「新增 LookML」按鈕：「新增 LookML」按鈕會開啟該專案的「新專案」頁面，您可以在該頁面自動產生 LookML，這些 LookML 會以資料庫中的一組資料表為依據。
新增及編輯模型設定
如果現有專案的清單旁顯示「設定」按鈕，您可以新增或編輯專案的模型設定。
如果模型沒有設定，當您按一下「設定」時，Looker 會顯示「設定模型」視窗。在「設定模型」視窗中，您可以指定模型名稱、專案名稱，以及模型可用的連線。
連線清單只會列出可與模型專案搭配使用的連線。如果連線已設定為供所有專案使用，則會顯示 (Instance wide) 標籤。
您也可以按一下「專案」頁面頂端的「設定新模型」按鈕，開啟「設定模型」視窗。在這種情況下，您可以使用「設定模型」視窗建立及設定新模型。新模型不會有任何 LookML，但會與連線建立關聯。如要完成這項程序，請在「模型」欄位中輸入模型的新名稱，並在「專案」欄位中輸入新名稱或選取與模型相同的名稱，然後選取連線並按一下「儲存」。之後，您或其他 Looker 開發人員可以將 LookML 新增至新專案，定義模型。
如果模型有設定，當您按一下「設定」時，Looker 會顯示「編輯模型設定」視窗。在「編輯模型設定」視窗中，您可以變更模型可用的連線。
編輯模型設定時，您可以查看模型名稱，但無法重新命名。模型名稱是根據您在 Looker IDE 中編輯模型檔案時使用的檔案名稱而定。
在「Project」(專案) 欄位中，您可以指定模型應與其他專案建立關聯。舉例來說，如果您建立的新專案包含同名模型，可以將模型設定轉移至新專案的模型。
在「允許的連線」欄位中，您可以限制模型使用特定連線清單，也可以允許模型使用任何連線 (所有目前和未來的連線)。
重新命名專案
Looker 管理員建立 LookML 專案時，會提供專案名稱。專案名稱應視為專案的永久 ID，因為 Looker 會透過下列方式使用專案名稱：
- 識別含有
project_id參數的 API 呼叫專案。 - 用於在 Looker 執行個體的內部資料庫中識別專案。
- 識別匯入本機專案的專案。
- 在「LookML 專案」頁面上顯示專案。
- 在 Looker 導覽面板的「開發」部分顯示專案。
- 專案檔案網址的一部分。舉例來說，在網址為
example.looker.com的 Looker 執行個體上，名為ecommerce的專案資訊清單檔案位於這個網址：https://example.looker.com/projects/ecommerce/files/manifest.lkml。
如果您擁有 Looker manage_models 權限，可以在專案的「專案設定」頁面中變更 LookML 專案的名稱。如果 Looker 開發人員不是管理員，可以查看「專案設定」頁面，但無法變更頁面上的選項。
如要重新命名專案，請按照下列步驟操作：
- 確認已開啟開發模式。
- 在 Looker IDE 中前往專案。
- 在專案中，按一下 IDE 導覽列中的「設定」，開啟專案設定面板。
- 在專案設定面板中選取「設定」。
- 使用「專案設定」下方的「名稱」欄位，編輯專案名稱。
- 在「專案設定」頁面中，按一下「儲存專案設定」，儲存新專案名稱。
刪除專案
如果您是 Looker 管理員，可以透過專案的專案設定刪除現有專案。如要查看專案設定，請開啟專案，然後點選 IDE 導覽列中的「設定」。
刪除的專案不會再顯示在「LookML 專案」頁面的「專案」部分，但仍會顯示在「已設定專案」部分。
如要移除專案設定，將專案完全從開發環境中移除，請執行下列步驟：
- 在 Looker IDE 中前往專案。
- 在專案中，按一下 IDE 導覽列中的「設定」，開啟專案設定面板。
- 在專案設定面板中，選擇「設定」即可查看專案設定。
- 在「專案設定」下方，選取「刪除專案」。
- 在「刪除專案」視窗中，確認警告訊息和未同步處理的變更，這些變更會在專案刪除後遺失。
- 如果確定要刪除專案，請在欄位中輸入專案名稱。如要取消作業並返回專案，請使用瀏覽器的「返回」按鈕。
- 按一下「永久刪除『<專案名稱>』」按鈕。