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

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

MaxCompute Studio配置选项

在 Settings对话框左侧导航栏上，单击 MaxCompute Studio。 MaxCompute 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，启动代码格式化功能。

  • 脚本提交选项
    • 选中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执行结果选项卡。
    • 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，即可完成修改。