ここでは、クライアントコマンドラインツールを使用して、MaxCompute の基本機能を使用する方法について説明します。 MaxCompute クライアントを使用する前に、クライアントをインストールして設定する必要があります。

  • クライアントの出力形式に基づいて、分析操作を実行しないでください。 クライアントの出力形式は、上位互換性が保証されていません。 クライアントのバージョンが異なると、コマンドの形式や動作も異なります。
  • クライアントの基本的なコマンドの詳細は、「基本コマンド」をご参照ください。
  • MaxCompute コンソールをダウンロードします。
  • JDK バージョン 1.9 をサポートしているのは、クライアントのバージョン 0.28.0 以降です。以前のバージョンでは、JDK 1.8 のみ使用できます。
  • MaxCompute 2.0 の新規データ型をサポートしているのは、クライアントのバージョン 0.27.0 以降です。

クライアントのインストールと設定を完了したら、コマンドラインから次の操作を実行できます。

ヘルプの表示

コンソールのヘルプ情報を表示するコマンドの形式は次のとおりです。

odps @> ./ bin / odpscmd-h;

インタラクティブモードでは、h; または help; (大文字と小文字は区別されません) と入力することもできます。

コンソールには 、キーワードに関連するコマンドプロンプトを取得するための help[keyword]; コマンドもあります。 たとえば、 help table; と入力すると、テーブル操作に関連するコマンドプロンプトが次のように表示されます。



odps @ odps> help table;
Usage: alter table merge smallfiles
Usage: show tables [in]
      a list of tables | ls [-p,-project]
Usage: describe deserves mention | [.] [partition ()]
Usage: read [.] [partition ()] [line_num]

起動パラメーター

コンソールの起動時、次に示す一連のパラメーターを指定できます。



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

例として -f パラメーターを取ります。操作は次のとおりです。

  1. ローカルスクリプトファイル script.txt を準備します。 ファイルがディスク D にあり、内容は次のとおりとします。

    
    
    DROP TABLE IF EXISTS test_table_mj;
    CREATE TABLE test_table_mj (id string, name string);
    DROP TABLE test_table_mj;
  2. 次のコマンドを実行します。

    odpscmd\bin>odpscmd -f D:/script.txt;

インタラクティブモード

コンソールを実行して、直接インタラクティブモードに入ります。



[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;

カーソル位置にコマンドを入力し (文の終了文字としてセミコロンを使用)、Enter を押して実行します。

継続実行

  • -e または -f オプションを使用してコマンドを実行するときに、複数の文があり、途中の文から実行を開始したい場合は、パラメーター -k を指定して、前のステートメントを無視し、指定された位置から実行を開始できます。パラメーター <= 0 が指定されている場合、最初の文から実行が開始されます。
  • セミコロンで区切られた各文は、有効な文と見なされます。 正常に実行された、または実行に失敗した文は、実行時に出力されます。

たとえば、

ファイル /tmp/dual.sql に3つの SQL 文があるとします。



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

最初の2つの文を無視し、3番目の文から実行を開始するコマンドの形式は次のとおりです。

odpscmd -k 3 -f dual.sql

現在のログインユーザーの取得

現在のログインユーザーを取得するコマンドの形式は、次のとおりです。

whoami;

使用例:



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

上記のコマンドを使用して、現在のログインユーザー Alibaba Cloud アカウント、エンドポイント設定、およびプロジェクト名を取得します。

終了

コンソールを終了するコマンドの形式は、次のとおりです。

odps@ > quit;

次のコマンドでコンソールを終了することもできます。

odps@ > q;