您可以通过客户端(odpscmd)访问MaxCompute的项目空间并使用各项功能。本文为您介绍如何安装、配置、运行客户端。

客户端(odpscmd)的具体使用方法请参见客户端介绍
说明
  • 推荐您使用MaxCompute Studio工具进行完整的大数据开发流程。该工具集成Java环境,可进行MaxCompute SQL脚本开发/执行、数据管理、可视化分析日志、Java(UDFMR)开发。客户端(odpscmd)目前也已集成该工具中。
  • 您也可以通过DataWorks使用MaxCompute:在控制台中创建项目(工作空间)后,直接点击工作空间列表 > 进入数据开发
  • 使用DataWorks进行添加用户及授权等操作请参见添加工作空间成员和角色

安装客户端

说明 客户端(odpscmd)基于Java开发。在安装前,请确保您的机器上有JRE 1.7或以上版本(建议优先使用JRE 1.7/1.8,其中JRE 1.9已经支持,JRE 1.10暂不支持)。
  1. 单击此处下载MaxCompute客户端。
  2. 解压下载的安装文件,得到binconflibplugins四个文件夹。

配置客户端

编辑conf文件夹中的odps_config.ini文件,对客户端进行配置,如下所示。
access_id=*******************
access_key=********************* 
# Accesss ID及Access Key是用户的云账号信息,可登录阿里云官网,进入管理控制台accesskeys页面进行查看。
project_name=my_project # 指定用户想进入的项目空间。
end_point=https://service.odps.aliyun.com/api # MaxCompute服务的访问链接。
tunnel_endpoint=https://dt.odps.aliyun.com # MaxCompute Tunnel服务的访问链接。
log_view_host=http://logview.odps.aliyun.com 
# 当用户执行一个作业后,客户端会返回该作业的LogView地址。打开该地址将会看到作业执行的详细信息。
https_check=true #决定是否开启HTTPS访问
说明
  • 建议您根据创建项目时选择的Region信息来配置客户端中的end_pointtunnel_endpoint参数,否则会出现无法访问等错误。
  • 如果您使用的是DataWorks创建的标准模式下的MaxCompute项目,在填写project_name时,请注意区分生产环境与开发环境(_dev)项目名称,详情请参见简单模式和标准模式的区别
  • odps_config.ini文件中使用#作为注释。MaxCompute客户端内的命令行使用两个减号,即--作为注释。
  • 您要提前创建好项目空间方可在配置文件中进行指定您想进入的项目,详情请参见创建项目空间
  • MaxCompute提供了公网和私网两种服务地址Endpoint供您选择,不同的服务地址对您的下载计费结算有不同影响。如果您未配置Tunnel Endpoint,则Tunnel可能自动路由到公网,从而产生下载费用。

运行客户端

修改好配置文件后,便可运行bin目录下的MaxCompute客户端(Linux系统下运行./bin/odpscmd,Windows下运行./bin/odpscmd.bat)。

您可以在客户端中运行命令行语句,示例如下:
create table tbl1(id bigint);
insert overwrite table tbl1 select count(*) from tbl1;
select 'welcome to MaxCompute!' from tbl1;

更多SQL语句的介绍请参见SQL概述