您可以透過 Looker IDE 右上角的按鈕存取 Git 指令,也可以點按主導覽選單中的「Git Actions」按鈕存取。
您必須為專案設定 Git,才能使用「Git Actions」面板。
下表列出可能的 Git 指令。請注意,Looker IDE 中顯示的指令會因您在變更及部署至正式環境的過程中,所處的階段而異。IDE 只會顯示適用於目前狀態的 Git 指令。
函式 | 說明 | 如何存取 |
---|---|---|
Commit | 對 LookML 專案進行任何變更並儲存後,請使用「Commit Changes & Push」(提交變更並推送) 按鈕,將這些變更提交至本機分支版本,並推送至正式環境。詳情請參閱「使用版本控管和部署」說明文件頁面。 | 「Git Actions」面板 |
修訂變更並推送 | 按鈕 | |
提交並解決衝突 | 如果合併衝突後進行變更,系統會顯示「Commit & Resolve Conflict」(提交並解決衝突) 按鈕。按一下「Commit & Resolve Conflict」,提交變更並清除合併衝突。 | 按鈕 |
修訂記錄 | 顯示分支版本的提交清單,包括您從正式版分支版本提取到開發分支版本的所有提交內容 (包括其他使用者的提交內容)。如果您使用 GitHub,且 Git 專案設定已啟用 GitHub 整合,則每個提交都會包含 GitHub 上的提交連結,方便您查看確切的變更。如果 Git 專案設定已啟用與 GitHub 整合功能對應的 Git 供應商,這項功能也適用於其他 Git 供應商。如要開啟連結,您必須在 Git 供應商上擁有帳戶。 | 「Git Actions」面板 |
設定 Git | 如果您剛建立專案,請為專案設定 Git。詳情請參閱「設定及測試 Git 連線」說明文件頁面。 | 按鈕 |
建立開發人員副本 | 為提升效能,首次在開發模式中開啟 LookML 專案時,Looker IDE 會顯示專案的正式環境模式版本,以及「建立開發人員副本」按鈕。點選專案的「建立開發人員副本」按鈕後,Looker IDE 會建立個人 Git 分支,並以開發模式載入 LookML 專案。 | 按鈕 |
從遠端部署 | 如果開發人員對專案具有唯讀存取權,則「從遠端部署」按鈕會從遠端正式版分支部署。 | 按鈕 |
部署至正式環境 | 提交變更後,請使用「Deploy to Production」(部署至正式環境) 選項,將開發分支中提交的變更更新至正式環境分支。如果專案已設定必須有提取要求,就無法使用這個選項。此外,如果專案已啟用進階部署模式,您就不會看到「Deploy to Production」按鈕。而是會看到「合併至主要分支」。 | 按鈕、「Git Actions」面板 |
不要解決問題 | 如果專案中有一或多個開發人員或開發分支發生合併衝突,就會顯示「不要解決」按鈕。「Don't Resolve」按鈕會將目前的分支版本 (包含所有合併衝突標記) 推送至遠端。只有進階 Git 使用者才應使用這個選項,因為合併衝突標記可能會導致模型無法使用。 | 按鈕 |
合併至主要分支版本 | 如果專案已啟用進階部署模式,系統會在您進行修訂後顯示「合併至主要分支版本」按鈕。系統會提示您將變更合併至主要分支版本。將變更合併至主要分支後,具有 deploy 權限的 Looker 開發人員即可使用 Webhook、API 或 Looker IDE 中的部署管理員 UI,將變更部署至正式環境。
|
按鈕 |
開啟 (Git 供應商) | 「開啟 (Git 供應商)」選項會開啟瀏覽器視窗,顯示 Git 供應商介面上的專案檔案。 | 按鈕 |
開啟提取要求 | 如果專案建議或必須使用提取要求,「開啟提取要求」選項會開啟新的瀏覽器視窗,前往 Git 供應商的新提取要求頁面。然後為開發人員分支版本建立提取要求。注意:在提取要求獲得核准和/或關閉之前,分支上的所有後續提交都會納入同一個提取要求。 | 「Git Actions」面板 |
提取及合併其他變更 | 「提取並合併其他變更」按鈕與「從 (正式版分支) 提取」按鈕的功能相同,但「提取並合併其他變更」按鈕會在不同情況下顯示,也就是當您在分支版本上提交變更,但尚未部署這些變更,且分支版本上也有遠端、未部署的已提交變更時。在這種情況下,您需要從遠端提取變更,並將其合併至您的分支版本。 | 按鈕 |
從主要分支版本提取 | 如果專案已啟用進階部署模式,當主要分支有開發人員分支沒有的提交內容時,系統會顯示「從主要分支提取」選項。 | 按鈕 |
從 (正式環境的分支版本) 提取 | 如果目前的開發人員分支版本有未提交的變更,就無法使用「從 (正式版分支版本) 提取」選項。您必須先提交分支的變更,才會看到「從 (正式版分支) 提取」選項。 | 按鈕、「Git Actions」面板 |
提取遠端變更 | 如果其他人在分支版本上提交並推送變更,分支版本的遠端版本會比分支版本的本機版本更先進。「Pull Remote Changes」(提取遠端變更) 按鈕會套用至您目前使用的分支。按一下「Pull Remote Changes」按鈕,從遠端擷取分支版本中所有變更檔案的最新版本,並同步至本機檔案。 | 按鈕 |
將分支版本推送至遠端 | 如果您建立的分支版本不存在於遠端,系統會顯示「Push Branch to Remote」(將分支版本推送至遠端) 按鈕。「將分支版本推送至遠端」選項會在遠端建立分支版本,並將本機檔案中所有已提交的變更推送至遠端。請注意,這不會將變更部署至正式版分支。 | 按鈕 |
將變更推送至遠端 | 如果已將變更提交至目前的分支版本,但尚未推送至該分支版本的遠端版本,系統會顯示「將變更推送至遠端」選項。「將變更推送至遠端」作業會套用至您目前所在的分支。按一下「Push Changes to Remote」按鈕,推送本機檔案中所有已提交的變更,並同步至遠端。 | 按鈕、「Git Actions」面板 |
還原為遠端版本 |
「還原為遠端」選項會捨棄本機分支中的所有變更,並將本機檔案同步至遠端分支中的目前檔案。請注意,這會產生兩項影響:
|
按鈕 |
還原為共用 |
「還原為共用」選項會捨棄本機分支中的所有變更,並將本機檔案同步至遠端分支中的目前檔案。請注意,這會產生兩項影響:
|
按鈕 |
還原未提交的變更 | 如果您已儲存但尚未提交變更,可以使用「還原未提交的變更」選項,捨棄所有未提交的變更。詳情請參閱「使用版本控管和部署」說明文件頁面。 | 按鈕 |
執行測試 |
如果專案已設定為必須先通過資料測試,才能部署至正式環境,IDE 會在您將變更提交至專案後,顯示「執行測試」按鈕。您必須先通過資料測試,才能將變更部署至正式環境。您也可以點選「專案健康狀態」面板中的「執行資料測試」圖示,手動執行測試。如要瞭解如何執行資料測試,請參閱「使用版本控管和部署」說明文件頁面。如要瞭解如何在專案中設定資料測試,請參閱 test 參數說明文件頁面。 |
按鈕 |
測試 Git 連線 | 為專案設定 Git 後,您可以使用「測試 Git 連線」選項執行 Git 測試連線工具,確認 Git 連線設定正確無誤。詳情請參閱「測試 Git 連線」說明文件頁面。 | 按鈕、「Git Actions」面板 |
最新資訊 | 如果本機分支版本與遠端分支版本同步,系統會顯示「最新版本」按鈕。 | 按鈕 |
更新依附元件 | 如果專案使用遠端專案匯入功能,首次新增遠端專案時,或專案已匯入遠端專案,且 Looker 偵測到有新的提交內容可匯入專案時,系統會顯示「更新依附元件」選項。使用這個選項匯入遠端專案檔案。如果您剛新增遠端專案,使用這個選項也會建立資訊清單鎖定檔案,Looker 會使用這個檔案追蹤遠端專案的版本。詳情請參閱「從其他專案匯入檔案」說明頁面的「自動偵測遠端專案的新版本」一節。 | 按鈕、「Git Actions」面板 |
驗證 LookML | 如果已將變更儲存至檔案,系統可能會顯示「驗證 LookML」按鈕。(是否需要驗證 LookML 取決於專案的程式碼品質設定)。按一下按鈕,開始驗證模型的 LookML。詳情請參閱「驗證 LookML」說明文件頁面。 | 按鈕 |
在 (Git 供應商) 上查看專案 | 「在 (Git 供應商) 上查看專案」選項會開啟瀏覽器視窗,顯示 Git 供應商介面上的專案檔案。 | 「Git Actions」面板 |
查看未提交的變更 | 如果您已儲存但尚未提交變更,可以使用「查看未提交的變更」選項,查看自上次提交以來儲存的所有變更。詳情請參閱「使用版本控管和部署」說明文件頁面。 | 「Git Actions」面板 |