91      財經資訊

客戶端___工具_大數據計算服務-阿裏雲

• 本文檔是 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開發插件_工具_大數據計算服務-阿裏雲