個人目錄 - DataWorks

個人目錄是為每位開發人員提供的私人儲存與開發空間，用於代碼的管理和調試。您可以在此目錄中建立和維護個人代碼。

個人目錄說明

個人目錄下的檔案分為兩類：我的檔案和本地檔案。以下為這兩種檔案類型的介紹：

目錄類型	儲存目錄	儲存提供方	儲存路徑	是否允許終端直接操作檔案
我的檔案	個人目錄下預設存在的目錄。	DataWorks	——	否
本地檔案	使用個人開發環境時，個人開發環境執行個體的預設儲存目錄。說明需要先建立個人開發環境執行個體。	個人開發環境執行個體指定資料集時，儲存提供方為資料集配置的NAS服務。	在建立個人開發環境執行個體時指定。	是
	使用個人開發環境時，個人開發環境執行個體的預設儲存目錄。說明需要先建立個人開發環境執行個體。	個人開發環境執行個體未指定資料集時，儲存提供方為DataWorks。	`/mnt/workspace/.virtual_documents`	是
	未使用個人開發環境時，支援將使用者當前操作裝置上的路徑添加到個人目錄下。	使用者當前操作裝置	以實際添加本地檔案夾時選擇的路徑為準。	否

檔案類型

個人目錄下建立的檔案類型無限制，但僅支援運行以下類型的檔案：

.ipynb：Notebook檔案。
.sh：Shell檔案。
.py：Python檔案。
.sql：SQL檔案。

說明

個人目錄可以讀寫Visual Studio Code支援的其他開發語言對應的檔案類型，但不提供文法提示和開發環境，不支援運行。

前提條件

已建立工作空間並綁定計算資源，詳情請參見建立工作空間、綁定計算資源。
已建立資源群組並綁定至目標工作空間。

進入個人目錄

進入DataWorks工作空間列表頁，在頂部切換至目標地區，找到目標工作空間，單擊操作列的快速進入 > Data Studio，進入Data Studio。
在Data Studio頁面左側導覽列單擊按鈕，進入資料開發頁面後，單擊左側分類樹中的個人目錄，進入個人目錄。

添加個人檔案

您可以按需選擇添加個人檔案位置及方式。

建立個人檔案

在個人目錄中單擊我的檔案，然後在工具列選擇表徵圖可快速在我的檔案下建立個人檔案。建立時需指定檔案尾碼以確定檔案類型，支援的檔案類型及其說明，請參見檔案類型。

您也可以單擊表徵圖，規劃我的檔案下的目錄結構。

添加本地檔案

除了使用個人目錄預設提供的我的檔案目錄外，您還可以將本地檔案夾（包括檔案夾內的檔案、程式碼程式庫等）直接添加至個人目錄中進行管理。

未使用個人開發環境時，在工具列單擊表徵圖，將本地（您當前操作裝置）檔案夾添加到個人目錄，按需選擇目標檔案夾。
該操作需要您授權瀏覽器讀取本地檔案相關許可權。
使用個人開發環境時，在工具列單擊表徵圖，將本地（個人開發環境執行個體）檔案夾添加到個人目錄，按需選擇目標檔案夾。

編輯個人檔案

添加完個人檔案後，您可以通過單擊檔案名稱進入編輯頁面，並開始編輯檔案內容。例如，在 .sql 檔案中編寫SQL語句。如下所示：

SELECT * FROM dw_work WHERE work_title IS NOT NULL;

使用個人檔案

您可參照下文使用個人檔案，其中：

在個人目錄支援啟動並執行檔案類型中，.sql檔案和.py檔案可以指定將代碼下發至空間綁定的計算資源執行。
個人目錄支援的檔案類型（.ipynb、.sh、.py、.sql）可以提交到專案目錄運行，並配置調度屬性發布至生產環境。
個人目錄下的.py檔案支援提交為MaxCompute的資源或函數，在MaxCompute作業開發時使用。

方式一：在個人目錄下運行

這種方式適合日常開發、測試和臨時查詢。在開發過程中，您需要測試一小段代碼邏輯是否按預期工作，可以在個人目錄下建立臨時檔案來測試代碼。

配置調試參數。
- 在個人目錄下，找到需要啟動並執行Shell、Python或SQL檔案，單擊進入編輯頁面，在右側的調試配置中設定任務運行參數。
  參數
  說明
  類型
  選擇執行檔案所需的計算資源類型。
  計算資源
  選擇當前空間下已綁定的計算資源。
  資源群組
  選擇執行檔案使用的資源群組。
- Notebook檔案需運行在個人開發環境中，詳情請參見運行Notebook。
調試運行代碼。
在檔案詳情頁面，單擊工具列中的按鈕即可快速運行任務。

方式二：提交至專案目錄運行

若個人目錄下的代碼需要在生產環境中周期性調度執行，可以通過提交到專案目錄的功能，基於個人檔案快速建立調度節點，並按照專案目錄的流程建立周期任務，完成後續的開發操作。

進入提交流程。
在個人目錄下找到需要提交至專案目錄的檔案，雙擊檔案名稱開啟檔案詳情。在檔案頂部工具列中，單擊按鈕將檔案提交至專案目錄。

配置提交參數。

配置	描述
選擇節點類型	選擇將個人檔案提交為專案目錄中的節點類型。請注意，當前代碼需與所選節點類型匹配。
選擇建立節點所屬的路徑	選擇節點在專案目錄中的儲存路徑。
確定節點名稱	確認是否使用個人檔案名稱作為節點名，或重新定義節點名。

方式三：將Python檔案提交為資源或函數

Data Studio支援將個人目錄中的.py檔案提交為MaxCompute的資源或函數，以便在資料開發節點中使用。

進入提交流程。
在個人目錄下找到需要提交至專案目錄的.py檔案，雙擊檔案名稱開啟檔案詳情。在檔案頂部工具列中，單擊按鈕後的下拉式功能表，選擇提交為函數或提交為資源。

配置提交參數。

配置	描述
類型	選擇提交為函數時，類型預設為`MaxCompute Function`。選擇提交為資源時，類型預設為`MaxCompute Python`。
路徑	選擇資源或函數在資源管理中的路徑。預設為`/`，表示存放在資源管理的根目錄，如需調整，請先到資源管理中手動建立目錄後，再在此處選擇。
提交類型	建立：在資源管理指定路徑下建立新的函數或資源，選擇此參數時，需要配置資源或函數名稱。關聯舊檔案：選擇關聯的已有資源或函數，選擇此參數時，需要配置已存在資源。當關聯已有函數時，將使用當前`.py`檔案中的Python代碼替換原函數中的代碼。當關聯已有資源時，將使用當前`.py`檔案替換原資源中的檔案內容。

單擊確認後，根據頁面提示完成後續操作。
- 如果提交類型選擇為建立，則會進入對應資源或函數的建立頁面。
- 如果提交類型選擇為關聯舊檔案，則會進入已有函數或資源的編輯頁面。
MaxCompute函數和資源的配置參數詳細說明，請參見MaxCompute資源與函數。

管理個人檔案

個人目錄下的檔案，均可以通過檔案右鍵菜單進行管理，例如下載檔案至本地，刪除檔案、重新命名檔案。

針對個人開發環境的檔案，除上述方式外，您還可以通過終端進行管理。

在整合終端中開啟
在本地檔案目錄下，找到目標檔案並按右鍵，在彈出的菜單中選擇在整合終端中開啟，此操作將快速開啟終端視窗，並自動定位到該檔案。
將本地檔案夾添加到個人目錄
在本地檔案目錄下，找到目標檔案並按右鍵，在彈出的菜單中選擇將本地檔案夾添加到個人目錄...，可快速將您通過終端建立的檔案載入至個人目錄。
將本地檔案夾從個人目錄刪除
在本地檔案目錄下，找到目標檔案並按右鍵，在彈出的菜單中選擇將本地檔案夾從個人目錄刪除...，此操作可快速將個人目錄下的檔案移除，但不會徹底刪除該檔案。

附錄：個人目錄介面功能

Data Studio個人目錄具體支援的操作如下：

介面功能	功能描述
	將本地檔案夾添加到個人目錄。未使用個人開發環境時，在工具列單擊表徵圖，將本地（您當前操作裝置）檔案夾添加到個人目錄，按需選擇目標檔案夾。該操作需要您授權瀏覽器讀取本地檔案相關許可權。使用個人開發環境時，在工具列單擊表徵圖，將本地（個人開發環境執行個體）檔案夾添加到個人目錄，按需選擇目標檔案夾。
	建立Notebook。
	建立檔案。
	建立檔案夾。
	重新整理。
	收合檔案夾。

參數	說明
類型	選擇執行檔案所需的計算資源類型。
計算資源	選擇當前空間下已綁定的計算資源。
資源群組	選擇執行檔案使用的資源群組。