建立及使用工作區
本文說明如何在 BigQuery 中使用工作區，包括下列工作：
- 建立工作區
- 刪除工作區
- 在工作區中處理檔案
- 對工作區中的檔案執行版本控管
事前準備
如果尚未建立 BigQuery 存放區，請先建立存放區。
必要的角色
工作區的存取權取決於上層存放區授予的角色。 詳情請參閱必要角色。
建立工作區
工作區的建立方式會因您使用的是 BigQuery 存放區或第三方存放區而異。
在 BigQuery 存放區中建立工作區
如要在 BigQuery 存放區中建立新的工作區，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取要建立工作區的存放區。
在編輯器中，按一下「新增工作區」。
在「建立工作區」窗格的「工作區 ID」欄位中，輸入工作區的專屬 ID。
ID 只能使用數字、英文字母、連字號和底線。
點選「建立」。
在第三方存放區中建立工作區
如要在第三方存放區中建立新的工作區，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取要建立工作區的存放區。
在編輯器中，按一下「新增工作區」。系統會開啟「建立工作區」窗格。
視要為工作區使用現有或新分支而定，選擇「現有遠端分支」或「新分支」圓形按鈕。
指定要使用的分支：
- 如果選擇「現有的遠端分支版本」圓形按鈕，請在「遠端分支版本」欄位中選擇現有的分支版本。
如果選擇「New branch」(新分支) 單選按鈕，請在「Workspace ID」(工作區 ID) 欄位中輸入分支名稱。在第三方存放區中建立的分支版本名稱與 BigQuery 工作區 ID 相同。
ID 只能使用數字、英文字母、連字號和底線。
點選「建立」。
在工作區中建立目錄
如要在工作區中建立目錄，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
按一下「新增」 選項。
依序按一下「在存放庫中建立」>「目錄」。
在「Add a directory path」(新增目錄路徑) 欄位中，輸入目錄路徑。
按一下「建立目錄」。
處理工作區中的檔案
您可以在工作區中建立新檔案，或上傳現有檔案。
您可以建立或上傳下列類型的檔案至存放區：
建立檔案
如要在工作區中建立檔案，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
執行下列其中一個步驟：
- 按一下「新增」 選項。
- 選取現有目錄，然後按一下「動作」選項。
按一下「Create in repository」(在存放區中建立)，然後點選要建立的檔案類型。
在「Name」欄位中輸入檔案名稱。
選用：在「父項目錄」欄位中，輸入要建立檔案的目錄路徑。
按一下 [儲存]。
上傳檔案
如要將檔案上傳至工作區，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
執行下列其中一個步驟：
- 按一下「新增」 選項。
- 選取現有目錄，然後按一下「動作」選項。
按一下「Upload to repository」(上傳至存放區)，然後按一下要上傳的檔案類型。
在「上傳」窗格中，執行下列任一操作：
- 在「File upload」(檔案上傳) 欄位中，按一下「Browse」(瀏覽)，選取檔案，然後按一下「Open」(開啟)。
- 在「網址」欄位中輸入檔案網址。
選用：在「父項目錄」欄位中，輸入要建立檔案的目錄路徑。
按一下「上傳」。
刪除檔案
如要從工作區刪除檔案，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
選取要刪除的檔案，按一下「動作」選項，然後按一下「刪除」。
點選「刪除」。
使用檔案的版本管控機制
本節說明如何在 BigQuery 中使用版本控管功能，追蹤工作區中的檔案。
BigQuery 會使用 Git 追蹤存放區內檔案的每項變更。在 BigQuery 存放區中，您可以直接與 Git 存放區互動。在已連結的存放區中，您可以與連結存放區時設定的遠端存放區預設分支互動。
BigQuery 會根據工作區中變更的狀態，顯示版本管控選項。舉例來說，只有在工作區有未提交的本機變更時，BigQuery 才會顯示提交選項。如果工作區中的檔案與預設或預設分支完全相同，BigQuery 會顯示「最新狀態」。
BigQuery 會顯示下列版本控管選項：
- 修訂 X 項變更
- 在工作區或所選已變更的檔案中，提交 X 個本機變更。BigQuery 會顯示未提交的變更。
- 推送至預設分支版本
- 將已提交的變更推送至預設分支版本。如果工作區中沒有未提交的變更，且有未推送的提交，存放區中就會顯示這個選項。
- 推送至「
your-branch-name」 - 將已提交的變更推送至
your-branch-name。 如果存放區已連線至第三方 Git 存放區，且工作區中沒有未提交的變更，即可使用這個選項。第三方存放區中的遠端分支版本名稱與 BigQuery 工作區 ID 相同。 - 從預設分支版本提取
- 使用預設分支版本的最新變更更新工作區。如果工作區中沒有未提交的變更，存放區就會顯示這個選項。
- 從「
your-branch-name」提取 - 從
your-branch-name更新工作區，套用最近的變更。 如果存放區已連線至第三方 Git 存放區，且工作區中沒有未提交的變更，即可使用這個選項。第三方存放區中的遠端分支版本名稱與 BigQuery 工作區 ID 相同。 - 還原為上次修訂版本
- 將工作區中的檔案還原為上次提交時的狀態。
提取變更
如果工作區與存放區不同步，BigQuery 會顯示「Pull」(提取) 選項。
如要將存放區中的變更提取至工作區，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
在工作區窗格中執行下列操作：
- 如果您位於 BigQuery 存放區，請按一下「從預設分支版本提取」。
如果您位於已連結至第三方 Git 存放區的存放區中，請執行下列任一操作：
- 按一下「從預設分支版本提取」，從第三方存放區的預設分支版本提取。
- 按一下「從
your-branch-name提取」，從與目前工作區對應的第三方存放區分支版本提取。
修訂變更
在工作區中進行變更後，BigQuery 會顯示「Commit」(提交) 選項。你可以修訂所有本機變更或選取的檔案。 您新增或修改的檔案會在工作區窗格中以藍點標示。
如要將工作區的變更提交至存放區，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
在工作區窗格中，按一下「提交變更」圖示 X。
在「Commit changes」(提交變更) 窗格中，執行下列操作：
選取要修訂的已變更檔案。
如未選取任何檔案，BigQuery 會修訂所有本機變更。您可以依檔案狀態、檔案名稱和路徑篩選變更的檔案。
在「新增提交訊息」欄位中，輸入提交的說明。
按一下「Commit All changes」或「Commit X changes」。
按鈕名稱會因您選取的待提交檔案而異。
推送變更
提交變更後，BigQuery 會顯示「Push」選項。
如要將工作區的變更推送到存放區，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
在工作區窗格中執行下列操作：
- 如果您位於 BigQuery 存放區，請按一下「Push to default branch」(推送至預設分支)。
如果您位於已連結至第三方 Git 存放區的存放區中，請執行下列任一操作：
- 按一下「推送至預設分支版本」，將變更推送至第三方存放區的預設分支版本。
- 按一下「推送至」
your-branch-name，將變更推送至與目前工作區對應的第三方存放區分支。
還原未提交的變更
如要還原未提交的變更，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
在工作區窗格中，按一下版本控管按鈕上的 箭頭下拉式選單，然後按一下「Revert to last commit」(還原至上次提交)。
解決合併衝突
如果工作區的本機變更與存放區預設分支版本的變更不相容，就可能發生合併衝突。如果多位使用者同時編輯同一個檔案，通常會發生合併衝突。
通常在其他使用者將衝突變更推送至同一分支後，您從該分支提取時會遇到合併衝突。您必須編輯受影響的檔案，手動解決合併衝突。
以下程式碼範例顯示 SQL 檔案中顯示的合併衝突：
<<<<<<< HEAD
SELECT 1 as CustomerOrders
=======
SELECT 1 as Orders
>>>>>>> refs/heads/main
如要解決合併衝突，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
選取受影響的檔案，並根據所選變更進行編輯。
修訂變更。
選用：推送變更。
查看修訂記錄
如要查看提交記錄，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，展開「Repositories」資料夾。
選取包含要使用的工作區的存放區。
在編輯器中找出工作區，然後按一下「開啟」。
工作區窗格隨即開啟：
在工作區窗格中，按一下版本控管按鈕上的箭頭下拉式選單，然後點選「查看提交記錄」。
刪除工作區
如要刪除工作區和當中所有內容，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，按一下「Repositories」資料夾。
在「Git Repositories」(Git 存放區) 窗格中，選取要刪除的工作區。
按一下 「動作」選項，然後按一下「刪除」。
點選「刪除」。
後續步驟
- 瞭解如何建立存放區。