Git 指令參考資料

您可以透過 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 開發人員即可使用 WebhookAPI 或 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」面板
還原為遠端版本 「還原為遠端」選項會捨棄本機分支中的所有變更,並將本機檔案同步至遠端分支中的目前檔案。請注意,這會產生兩項影響:
  1. 捨棄所有已提交和未提交的變更,這些變更尚未部署至正式版
  2. 使用其他使用者對分支所做的任何變更,更新分支的本機版本
按鈕
還原為共用 「還原為共用」選項會捨棄本機分支中的所有變更,並將本機檔案同步至遠端分支中的目前檔案。請注意,這會產生兩項影響:
  1. 捨棄所有已提交和未提交的變更,這些變更尚未部署至正式版
  2. 使用其他使用者對分支所做的任何變更,更新分支的本機版本
按鈕
還原未提交的變更 如果您已儲存但尚未提交變更,可以使用「還原未提交的變更」選項,捨棄所有未提交的變更。詳情請參閱「使用版本控管和部署」說明文件頁面。 按鈕
執行測試 如果專案已設定為必須先通過資料測試,才能部署至正式環境,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」面板