MaxCompute工具及下载：客户端

本文档将为您介绍如何借助客户端命令行工具使用 MaxCompute 服务的基础功能。在使用 MaxCompute 客户端前，请首先 安装并配置客户端。

注意：

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

安装并配置好客户端后，您可借助命令行工具进行以下操作：

获取帮助


若想显示客户端的帮助信息，命令格式如下所示：

1. odps@ >./bin/odpscmd -h;

您也可以在交互模式下键入“h;”或“help;”（不区分大小写）。
客户端还提供了 help [keyword]; 命令，可获取到与关键字有关的命令提示。例如：输入 help table; 可以得到与 table 操作相关的命令提示，如下所示：

1. odps@ odps> help table;
2. Usage: alter table <tablename> merge smallfiles
3. Usage: show tables [in <projectname>]
4.        list|ls tables [-p,-project <projectname>]
5. Usage: describe|desc [<projectname>.]<tablename> [partition(<spec>)]
6. Usage: read [<project_name>.]<table_name> [(<col_name>[,..])] [PARTITION (<partition_spec>)] [line_num]

启动参数


在启动时，您可指定一系列参数，如下所示：

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

以 -f 参数为例，操作如下：

1. 
   准备本地脚本文件 script.txt，假设在 D 盘，文件内容如下所示：DROP TABLE IF EXISTS test_table_mj;
2. CREATE TABLE test_table_mj (id string, name string);
3. DROP TABLE test_table_mj;

运行如下命令：

1. odpscmd\bin>odpscmd -f ./script.sql;

交互模式


直接运行客户端即可进入到交互模式，如下所示：

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

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

续跑

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

示例如下：
文件/tmp/dual.sql 中有三条 SQL 语句，如下所示：

1. drop table dual;
2. create table dual (dummy string);
3. insert overwrite table dual select count(*) from dual;

若想忽略前两条语句，直接从第三条语句开始执行，命令格式如下所示：

1. odpscmd –k 3 –f dual.sql

获取当前登录用户


若想获取当前登录用户，命令格式如下所示：

1. whoami;

示例如下：

1. odps@ hiveut>whoami;
2. Name: odpstest@aliyun.com
3. End_Point: http://service.odps.aliyun.com/api
4. Project: lijunsecuritytest

通过以上命令，即可获取当前登录用户的云账号、使用的 End_Point 配置和项目名。

退出


若想退出客户端，命令格式如下所示：

1. odps@ > quit;

或输入：

1. odps@ > q;