配置MaxCompute Studio

本文为您介绍如何配置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目录。

      说明

      如果您保持默认值,请确认本地目录下.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.aliyun.com,此处需要配置为user_test。如果添加的账号为RAM用户,例如user_ram@xxxxx.onaliyun.com,归属的阿里云账号为user_****@test.aliyun.com,此处需要配置为user_****:user_ram

      • Using properties file:如果您此前配置过odpscmd或Studio,本地有已配置好的odps_config.ini文件,您可以选择从配置文件中读取AccessKey ID和AccessKey Secret。如果您选择了此种方式,需要上传本地的配置文件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,即可完成修改。