在IntelliJ IDEA上通過MaxCompute Studio使用MaxCompute進行資料開發前,您必須串連MaxCompute專案,才可以查看、管理MaxCompute的資料和資源。本文為您介紹如何在MaxCompute Studio建立或修改MaxCompute專案串連。
步驟一:建立MaxCompute Studio專案
啟動IntelliJ IDEA,在頂部功能表列,單擊 。
在New Project對話方塊的左側導覽列,選擇MaxCompute Studio,單擊Next。
填寫Project name,單擊Finish,完成專案建立。
說明如果有已經開啟的Project,將會提示您是否在當前視窗中開啟,即關閉之前的Project,選擇This Window。
步驟二:建立MaxCompute專案串連
在頂部功能表列,單擊 。
單擊左上方的+,選擇Add project from accessId/Key。
在Add MaxCompute project對話方塊,配置Connection頁簽資訊。
說明單擊對話方塊左下角的即可查看線上文檔。
如果出現逾時錯誤,單擊對話方塊中的Setting頁簽,修改資料同步相關參數:
sync one table timeout(s):同步表逾時參數。預設為5s。
sync one function timeout(s):同步函數逾時參數。預設為30s。
通過設定檔自動設定參數。
參數
說明
Properties File
上傳MaxCompute專案用戶端(odpscmd)的設定檔odps_config.ini,詳情請參見安裝並配置MaxCompute用戶端。用於初始化Access Id、Access Key、Project Name和End Point配置項。
AK Account
串連MaxCompute專案使用的阿里雲帳號。單擊右側+,在Accounts頁面,選擇已存在的帳號。
說明如果沒有帳號資訊,您需要在Accounts頁面,單擊Accounts配置選項。
,通過設定檔自動識別或手動方式添加帳號資訊。更多關於配置Accounts資訊,請參見手動設定參數。
參數
說明
Access Id
串連MaxCompute專案時的AccessKey ID。
Access Key
串連MaxCompute專案時的AccessKey Secret。
Project Name
訪問的目標MaxCompute專案名稱。
說明此處為已建立的MaxCompute專案名稱,非DataWorks工作空間名稱。您可以登入MaxCompute控制台,在工作區 > 專案管理頁面查看已建立的MaxCompute專案名稱或建立專案。
End Point
MaxCompute專案所屬地區的Endpoint,需要注意的是如果安裝的機器不在阿里雲內網環境(如您自己的本地機器),需要使用外網Endpoint進行串連。
配置完成後,單擊OK。在左側Project Explorer頁面中會顯示MaxCompute專案的資訊,包括該專案中的表、視圖、函數以及資源。
步驟三:修改MaxCompute專案串連
在Project Explorer頁面,按右鍵需要修改的MaxCompute專案,選擇Modify project properties。
在Modify MaxCompute project對話方塊,修改MaxCompute專案的配置。
後續步驟
串連MaxCompute專案後,您可以進行如下操作:
管理和查看專案內的資料和資源,詳情請參見管理資料和資源。
在MaxCompute Studio中開發SQL指令碼,詳情請參見開發SQL程式。
在MaxCompute Studio中開發Java程式,詳情請參見開發Java程式。
在MaxCompute Studio中開發Python程式,詳情請參見開發Python程式。
常見報錯
配置Connection頁簽資訊,單擊OK後,常見報錯如下:
報錯:
Test connection fail: ODPS-0420111: Project not found - '<project_name>'.
或Test connection fail:ODPS-0130013:Authorization exception - Authorization Failed [4002], You don't exist in project <project_name>. Context ID:<context ID>. --->Tips: Pricipal:ALIYUN$<account_name> | RAM$[<account_name>:]<RAM使用者名稱稱>;
。可能原因:
串連的目標專案不存在、專案名稱輸入錯誤。
使用的AccessKey對應的阿里雲帳號或RAM使用者未添加到目標專案中。
解決方案:
請您登入MaxCompute控制台,在工作區 > 專案管理頁面擷取已建立正確的MaxCompute專案名稱後,修改Project Name參數。
如果需要其他使用者串連目標專案進行協同開發,需要專案所有者將其他使用者添加到目標專案中,操作詳情請參見添加阿里雲帳號使用者(專案層級)或添加RAM使用者(專案層級)。
報錯:
Test connection fail: connect timed out, the possible reason is that the endpoint '<endpoint>' is wrong, please check your endpoint
。可能原因:填寫的End Point參數值錯誤。例如您在本機電腦上使用MaxCompute Studio串連專案,您卻使用了阿里雲產品互連網絡串連方式下的Endpoint(外網環境使用了內網Endpoint)。
解決方案:請您參照Endpoint文檔,選擇與您要串連專案所屬地區和網路環境相符的Endpoint。
報錯:
Test connection fail: The specified project or table name is not valid or missing.
。可能原因:Endpoint用於MaxCompute服務,Tunnel Endpoint用於MaxCompute的Tunnel服務,您可能誤將Tunnel Endpoint填入End Point。
解決方案:請您參照Endpoint文檔,選擇與您要串連專案所屬地區和網路環境相符的Endpoint,而不是Tunnel Endpoint。