91      iPhone_iPad_Mac_apple

客户端___工具_大数据计算服务-阿里云

• 本文档是 MaxCompute 客户端用户手册的一部分，说明如何借助客户端命令行工具使用ODPS服务的基础功能。

• 请不要依赖客户端的输出格式来做任何的解析工作。客户端的输出格式不承诺向前兼容。不同版本间的客户端命令格式及行为有差异。

• MaxCompute 客户端是一个java程序，需要JRE环境才能运行，请下载并安装JRE 1.6版本。

• 如果想快速了解客户端的使用方式，请参考开篇的 快速开始 部分关于客户端安装使用的介绍。

• 客户端的基本命令介绍，请参考 基本命令。

下载安装

客户端下载请点击这里。解压下载的文件，可以看到如下4个文件夹：

 bin/  conf/  lib/  plugins/

在conf文件夹中有odps_config.ini文件。编辑此文件，填写相关信息：

 project_name=
 access_id=<accessid>
 access_key=<accesskey>
 end_point=https://service.odps.aliyun.com/api

备注：

• 将其中的access_id和access_key替换为从www.aliyun.com网站上申请到的access_id和access_key。
• 如果你经常使用某个project，可以将该project的名字添加到”project_name=”之后。这样可以避免每次进入客户端后均需要执行”use project_name;”命令。

修改好配置文件后运行bin目录下的odpscmd(在Linux系统下是./bin/odpscmd，Windows下运行./bin/odpscmd.bat)，现在可以运行 MaxCompute 命令，如：

 odps@ test_project> whoami;
 Name: ALIYUN$test_user@aliyun.com
 End_Point: https://service.odps.aliyun.com/api
 Project: test_project

获取帮助

显示客户端的帮助信息，命令格式:

odps@ >./bin/odpscmd -h;

或者也可以在交互模式下键入”h;”或”help;”（不区分大小写）;

客户端还提供了 help [keyword]; 命令，可获取到与关键字有关的命令提示。例如：输入 help table; 可以得到与 table 操作相关的命令提示：

odps@ odps> help table;
Usage: show tables [in <projectname>]
       list|ls tables [-p,-project <projectname>]
Usage: export table <tablename>
Usage: alter table <tablename> merge smallfiles
Usage: read  <table_name> [<(col_name>[,..])][PARTITION <(partition_spec)>][line_num]

启动参数

在启动时，可以指定一系列参数：

Usage: odpscmd [OPTION]...
where options include:
    --help                                  (-h)for help
    --project=<prj_name>                    use project
    --endpoint=<https://host:port>           set endpoint
    -u <user_name> -p <password>            user name and password
    -k <n>                                  will skip begining queries and start from specified position
    -r <n>                                  set retry times
    -f <"file_path;">                       execute command in file
    -e <"command;[command;]...">            execute command, include sql command
    -C                                      will display job counters

示例：（以-f 参数为例）

• 准备本地脚本文件script.txt,假设在D盘，文件内容如下：

DROP TABLE IF EXISTS test_table_mj;
CREATE TABLE test_table_mj (id string, name string);
DROP TABLE test_table_mj;

• 运行命令：

odpscmdbin>odpscmd -f ./script.sql;

交互模式

直接运行客户端将进入到交互模式。

[admin: ~]$odpscmd
Aliyun ODPS Command Line Tool
Version 1.0
@Copyright 2012 Alibaba Cloud Computing Co., Ltd. All rights reserved.
odps@ odps> INSERT OVERWRITE TABLE DUAL SELECT * FROM DUAL;

在光标位置输入命令（以分号作为语句结束标志），回车即可运行。

续跑

• 在用-e或-f模式运行时，如果有多个语句，并且想从中间某个语句开始运行，可以指定参数-k， 表示忽略前面的语句，从指定位置的语句开始运行。当指定参数 <= 0时，从第一条语句开始执行。
• 每个以分号分隔的语句被视为一个有效语句，在运行时会打印出当前运行成功或者失败的是第几个语句。
• 如文件/tmp/dual.sql 中有三条sql语句

drop table dual;
create table dual (dummy string);
insert overwrite table dual select count(*) from dual;

想忽略前面两条语句

odpscmd –k 3 –f dual.sql

获取当前登录用户

命令格式

whoami;

使用示例：

odps@ hiveut>whoami;
Name: odpstest@aliyun.com
ID: 1090142773636588
End_Point: https://10.249.215.1/odps_debug1
Project: lijunsecuritytest

用途：获取当前登录用户云帐号及使用的end point配置。

退出

命令

odps@ > quit;
或q;

最后更新：2016-11-23 17:16:04

  上一篇： Python SDK__SDK_大数据计算服务-阿里云

  下一篇： 创建ODPS工程__Eclipse开发插件_工具_大数据计算服务-阿里云