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

前提条件

  • 待安装MaxCompute客户端的设备已安装Java 8或以上版本。MaxCompute客户端(odpscmd)是基于Java开发的。
  • 已创建项目空间,详情请参见创建项目空间
  • 如果是RAM用户且未创建项目空间,请确认已添加为主账号对应的项目空间成员并设置角色,详情请参见添加项目空间成员并设置角色

背景信息

您可以通过如下方式完成MaxCompute项目数据开发,本文仅引导您完成MaxCompute客户端(odpscmd)的安装和配置,其他方式请您参见对应文档进行操作:
  • MaxCompute客户端(odpscmd):使用详情请参见客户端
  • MaxCompute Studio:可以实现完整的数据开发流程,您可以基于该工具开发SQL、Java(UDF、MapReduce、Graph)、Python脚本。MaxCompute客户端(odpscmd)已集成在MaxCompute Studio工具中。如果您需要构造完整的数据开发流程,推荐您使用该工具。详情请参见MaxCompute Studio
  • DataWorks:您可以在DataWorks控制台中创建的项目空间右侧,单击进入数据开发,进入开发界面。
  • 第三方工具:基于IntelliJ IDEA开发Java SDKPython SDK;基于JDBC配合Tableau完成数据可视化分析、配合SQL Workbench/J执行SQL语句。

操作步骤

  1. 下载客户端安装包
  2. 解压下载的安装包文件,得到binconflibplugins文件夹。
  3. 编辑conf文件夹中的odps_config.ini文件,对客户端进行配置。配置文件示例如下。
    # 指定您要访问的项目空间名称。
    project_name=<my_project>
    # Accesss ID及Access Key是您的云账号AccessKey信息,您可以登录阿里云官网,进入管理控制台,在AccessKey管理页面查看对应信息。
    access_id=*******************
    access_key=********************* 
    # MaxCompute服务的连接地址。请根据创建项目时选择的区域以及网络信息进行选择。
    end_point=xxxxxxxxxxx
    # 当您执行一个作业后,MaxCompute客户端会返回该作业的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服务的外网访问链接。请根据创建项目空间时选择的区域以及网络信息进行选择。
    tunnel_endpoint=xxxxxxxxxxx
    • 建议您根据创建项目空间时选择的区域来配置end_pointtunnel_endpoint,否则会出现无法访问错误。配置详情请参见配置Endpoint
    • 如果您创建了标准模式的MaxCompute项目,在配置project_name时,请注意区分生产环境与开发环境(_dev)项目名称,详情请参见简单模式和标准模式的区别
    • odps_config.ini文件中使用#作为注释。MaxCompute客户端的命令行使用两个减号(--)作为注释。
    • MaxCompute提供了外网、经典网络和VPC网络三种服务地址供您选择,不同的服务地址对您的下载计费结算有不同影响。如果您未配置Tunnel Endpoint,则Tunnel可能自动路由到外网,从而产生下载费用。详情请参见Endpoint
  4. 运行bin目录下的MaxCompute客户端(Linux系统下运行./bin/odpscmd,Windows下运行./bin/odpscmd.bat)。
    出现如下信息,表示运行成功。运行客户端.png