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