本文为您介绍如何配置MaxCompute Studio以及各项配置项信息。

安装MaxCompute Studio插件后,在顶部菜单栏,单击File > Settings...,即可进入MaxCompute Studio配置对话框。

MaxCompute Studio配置选项

Settings对话框左侧导航栏上,单击MaxCompute StudioMaxCompute Studio配置选项页提供以下配置项:
  • 基本参数
    • Local meta store location:本地元数据仓库存储路径。指定本地存储MaxCompute项目空间元数据的路径。MaxCompute Studio的默认设置是本地用户目录下的.odps.studio\meta目录。
    • Table preview rows:表的最大预览行数。
    • 本地作业保存目录:MaxCompute Studio作业的本地保存路径。MaxCompute Studio的默认设置是本地用户目录下的.odps.studio\job目录。
    • Python path to resolve UDF:Python的本地安装路径。
  • 版本更新选项
    • Automatically checks for new version:控制MaxCompute Studio是否自动检查更新版本。默认情况下是选中状态,支持自动更新。
    • Check new versions:用于手动检查新版本。单击后,如果有新版本可以更新,将显示Install latest version。单击Install latest version安装最新版本软件,安装完成后需要重启IntelliJ IDEA。

SDK & Console配置选项

Settings对话框左侧导航栏上,单击MaxCompute Studio > SDK & Console,进入SDK & Console配置选项页。

SDK & Console配置选项对话框提供了Installed Location配置项,用以指定本地安装MaxCompute客户端的安装路径。MaxCompute Studio会自动检测路径中安装的MaxCompute客户端的版本,如果检测失败,会返回错误信息。
说明 MaxCompute Studio 2.6.1之后的版本自带了最新的MaxCompute客户端,不需要您特别指定。如果您希望使用自己特定版本的MaxCompute客户端,可以在此处指定路径。

MaxCompute SQL配置选项

Settings对话框左侧导航栏上,单击MaxCompute Studio > MaxCompute SQL,进入MaxCompute SQL配置选项页。

在MaxCompute SQL配置选项对话框配置如下信息:
  • 语法高亮

    选中Enable syntax coloring,启动语法高亮功能。

  • 代码自动补全
    • 选中Enable code completion,启动代码自动补全功能。
    • 选中Invoke code completion when you enter a space,启动输入空格时自动结束代码补全功能。
  • 代码格式化
    • 选中Enable code formatting,启动代码格式化功能。
    • 选中Enable code folding,启动代码折叠功能。
  • 脚本提交选项
    • 选中Show job detail when script submitted,脚本提交时会显示作业详情。
    • 选中Record sql history when script submitted,脚本提交时记录SQL历史记录。
    • 选中Show sql cost confirm dialog when script submitted,提交脚本时显示SQL成本确认对话框。
    • 选中Pin sql execution result tab by default,默认情况下锁定SQL执行结果选项卡。
    • Ignore local compile error when submit script(可选),提交脚本时忽略本地编译错误。
    • Use tunnel to download query acceleration result(可选),使用Tunnel下载查询加速结果。
    • Job Name:作业名称
      • use script file name as default:默认使用脚本的名称作为工作名称。
      • input job name when first submit:第一次提交时输入作业名称。
      • input job name for every submit:每一次提交时输入作业名称。
  • 编译器选项
    此处设置的选项为全局默认的编译器选项。以下选项还可以在SQL编辑器的工具栏中为每个文件单独设置。
    • 编译器模式(Compiler Mode)
      • 单句模式(Statement Mode):在该模式下,编译器将SQL文件中的单条语句作为单元进行编译、提交。
      • 脚本模式(Script Mode):在该模式下,编译器将整个SQL文件作为单元进行编译、提交。脚本模式有利于编译器和优化器最大程度地优化执行计划,提高整体执行效率。
    • 类型系统
      • 旧有类型系统(Legacy TypeSystem):原有MaxCompute的类型系统。
      • MaxCompute类型系统(MaxCompute TypeSystem):MaxCompute 2.0引入的新类型系统。
      • Hive类型系统(Hive Compatible TypeSystem):MaxCompute 2.0引入的Hive兼容模式下的类型系统。
    • 执行模式
      • 默认:MaxCompute Studio默认使用的编译器。
      • 查询加速:具备查询加速功能的编译器。
      • 加速失败重跑:查询加速失败后可以重跑作业的编译器。

MaxCompute Job配置选项

Settings对话框左侧导航栏上,单击MaxCompute Studio > MaxCompute Job,进入MaxCompute Job配置选项页。

在MaxCompute Job配置选项对话框配置如下信息:
  • Maximum jobs shown in job explorer table list:默认为1000。设置作业浏览器页面展示的最大作业数量。
  • 选中Reset filter when switch MaxCompute project,切换MaxCompute项目时重置。
  • 选中Cache history instance in local database,在本地数据仓库中缓存历史Instance信息。

Accounts配置选项

Settings对话框左侧导航栏上,单击MaxCompute Studio > Accounts,进入Accounts配置选项页。

Accounts配置选项对话框用于管理访问MaxCompute的所用账户,关于账户更多信息请参见用户认证
说明 MaxCompute Studio需要通过用户指定的账号访问MaxCompute的项目空间和执行提交作业等操作。
  • 添加账户
    1. 在右侧导航栏上,单击+ > Aliyun Account By AccessKey
    2. Add MaxCompute Account对话框配置如下参数:
      • Account Name:该账户在MaxCompute Studio中的标识名称。如果添加的账号为阿里云账号,例如user_test@test.aliyun.com,此处需要配置为user_test。如果添加的账号为RAM用户,例如user_ram@xxxxx.onaliyun.com,归属的阿里云账号为user_test@test.aliyun.com,此处需要配置为user_test:user_ram
      • Using properties file:从配置文件中读取AccessKey ID和AccessKey Secret。如果您选择了此种方式,需要上传在用户认证中的配置文件conf/odps_config.ini
      • Using properties:手动填入AccessKey ID和AccessKey Secret。此选项与Using properties file选项二选一即可。
        • Access Id:填入阿里云账号或RAM用户的AccessKey ID。
        • Access Key:填入阿里云账号或RAM用户的AccessKey Secret。
    3. 单击OK。添加完成后账号会出现在Accounts配置选项对话框的列表中。
  • 删除账户
    该操作仅在MaxCompute Studio配置中删除账户配置,对您账户本身不产生影响:
    1. 在Accounts列表中选择要删除的账户名称。
    2. 在右侧导航栏上,单击-
    3. 在弹出的确认对话框中,选择OK,即可完成删除。
  • 修改账户信息
    1. 在Accounts列表中选择要修改的账户名称。
    2. 在右侧导航栏上,单击修改图标。
    3. 在弹出的Edit MaxCompute Account对话框中,编辑Account配置信息如下:
      • Access Id:填入修改后的阿里云账号或RAM用户的AccessKey ID。
      • Access Key:填入修改后的阿里云账号或RAM用户的AccessKey Secret。
    4. 单击OK,即可完成修改。