管理项目连接

在IntelliJ IDEA上通过MaxCompute Studio使用MaxCompute进行数据开发前,您必须连接MaxCompute项目,才可以查看、管理MaxCompute的数据和资源。本文为您介绍如何在MaxCompute Studio创建或修改MaxCompute项目连接。

步骤一:创建MaxCompute Studio项目

  1. 启动IntelliJ IDEA,在顶部菜单栏,单击File > New > Project

  2. New Project对话框的左侧导航栏,选择MaxCompute Studio,单击Next

    新建项目

  3. 填写Project name,单击Finish,完成项目创建。

    配置项目名称

    说明

    如果有已经打开的Project,将会提示您是否在当前窗口中打开,即关闭之前的Project,选择This Window

步骤二:创建MaxCompute项目连接

  1. 在顶部菜单栏,单击View > Tool Windows > Project Explorer

    project explorer

  2. 单击左上角的+,选择Add project from accessId/Key

    **

  3. 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 IdAccess KeyProject NameEnd Point配置项。

      AK Account

      连接MaxCompute项目使用的阿里云账号。单击右侧+,在Accounts页面,选择已存在的账号。

      说明

      如果没有账号信息,您需要在Accounts页面,单击+ > Aliyun Account By AccessKey,通过配置文件自动识别或手动方式添加账号信息。更多关于配置Accounts信息,请参见Accounts配置选项

    • 手动配置参数。

      参数

      说明

      Access Id

      连接MaxCompute项目时的AccessKey ID。

      Access Key

      连接MaxCompute项目时的AccessKey Secret。

      Project Name

      访问的目标MaxCompute项目名称。

      说明

      此处为已创建的MaxCompute项目名称,非DataWorks工作空间名称。您可以登录MaxCompute控制台,在工作区 > 项目管理页面查看已创建的MaxCompute项目名称或新建项目。

      End Point

      MaxCompute项目所属区域的Endpoint,需要注意的是如果安装的机器不在阿里云内网环境(如您自己的本地机器),需要使用外网Endpoint进行连接。

  4. 配置完成后,单击OK。在左侧Project Explorer页面中会显示MaxCompute项目的信息,包括该项目中的表、视图、函数以及资源。

步骤三:修改MaxCompute项目连接

  1. Project Explorer页面,右键单击需要修改的MaxCompute项目,选择Modify project properties

    **

  2. Modify MaxCompute project对话框,修改MaxCompute项目的配置。

后续步骤

连接MaxCompute项目后,您可以进行如下操作:

常见报错

配置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用户未添加到目标项目中。

    • 解决方法:

  • 报错: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。