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

前提条件

  • 客户端(odpscmd)基于Java开发。在安装前,请确保您的设备上有Java 8或以上版本。
  • 在配置客户端之前,请确保您已创建好项目空间。详情请参见创建项目空间

操作步骤

安装客户端
  1. 单击此处进入客户端下载页面,下载所需版本的MaxCompute客户端。
  2. 解压下载的安装文件,得到binconflibplugins四个文件夹。
配置客户端配置文件
  1. 编辑conf文件夹中的odps_config.ini文件,对客户端进行配置,配置文件示例如下。
    # 指定用户想进入的项目空间名称。
    project_name=my_project
    # Accesss ID及Access Key是用户的云账号信息,可登录阿里云官网,进入管理控制台Access Key页面进行查看,请填写的时候去掉尖括号。
    access_id=*******************
    access_key=********************* 
    # MaxCompute服务的访问链接。请根据创建项目时选择的Region以及网络信息进行选择,具体请参见配置Endpoint填写。
    end_point=xxxxxxxxxxx
    # 当用户执行一个作业后,客户端会返回该作业的Logview地址。打开该地址将会看到作业执行的详细信息。
    log_view_host=http://logview.odps.aliyun.com 
    #决定是否开启HTTPS访问。
    https_check=true 
    
    #确认输入数据最大值(单位:GB)。
    data_size_confirm=100.0
    # odpscmd 更新链接。
    update_url=http://repo.aliyun.com/odpscmd
    # 是否按实例隧道下载SQL结果。
    use_instance_tunnel=true
    # 按实例隧道下载SQL结果时的最大记录数。
    instance_tunnel_max_record=10000
    #  Tunnel服务的访问链接。请根据创建项目时选择的Region以及网络信息进行选择,具体请参见配置Endpoint。
    tunnel_endpoint=xxxxxxxxxxx
    • 建议您根据创建项目时选择的Region信息来配置客户端中的end_pointtunnel_endpoint参数,否则会出现无法访问等错误。请参见配置Endpoint填写。
    • 如果您使用的是DataWorks创建的标准模式下的MaxCompute项目,在填写project_name时,请注意区分生产环境与开发环境(_dev)项目名称,详情请参见简单模式和标准模式的区别
    • odps_config.ini文件中使用#作为注释。MaxCompute客户端内的命令行使用两个减号--作为注释。
    • MaxCompute提供了外网、经典网络和VPC网络三种服务地址Endpoint供您选择,不同的服务地址对您的下载计费结算有不同影响。如果您未配置Tunnel Endpoint,则Tunnel可能自动路由到公网,从而产生下载费用。
运行客户端
  1. 运行bin目录下的MaxCompute客户端(Linux系统下运行./bin/odpscmd,Windows下运行./bin/odpscmd.bat)。出现如下信息,表示运行成功。运行客户端.png

后续步骤

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