コンソール

最終更新日: Nov 26, 2017

最新のODPSサービスは、旧バージョンと比較して新しいバージョンのクライアントを提供します。新しいクライアントの改善点は次のとおりです。指定されたコマンドを実行するためにコマンドシェルを起動する必要はありません。たとえば、クライアントを入力してSQLコマンドとセキュリティコマンドを新しいバージョンで直接実行することができます。SQL/Security シェルを最初に実行して、対応するコマンドを実行する必要はありません。 新しいバージョンのコマンドは、さらにHiveコマンドに近いです。ほとんどのコマンドはHiveと互換性があります。

また、下記事項に注意する必要があります:

  • このドキュメントは、ODPSのクライアントのユーザーマニュアルの一部です。クライアントのコマンドラインを使用してODPSの基本機能を使用する方法について説明します。
  • クライアントの出力形式に基づいて解析を実行しないでください。クライアントの出力形式は、フォワード互換のために保証されていません。異なるバージョンのクライアントは、コマンド形式と動作が異なります。
  • ODPSクライアントはJavaプログラムであり、JRE環境でのみ実行できます。したがって、JRE 1.6のバージョンをダウンロードしてインストールする必要があります。
  • クライアントの使用方法について知りたい場合は、クイックスタートを参照してください。

ダウンロードとインストール

ODPSクライアントをダウンロードするには、ここをクリックしてください。

ダウンロードしたファイルを解凍すると、次の4つのフォルダが見つかります。

  1. bin/ conf/ lib/ plugins/

‘conf’にodps_conf.iniという名前のファイルがあります。このファイルを編集し、関連情報を記入してください:

  1. project_name=
  2. access_id=<accessid>
  3. access_key=<accesskey>
  4. end_point=http://xxxx

注意:

  • access_idおよびaccess_keyを、www.aliyun.comから取得したaccess_idおよびaccess_keyに置き換えてください。
  • プロジェクトを頻繁に使用する場合、このプロジェクトの名前を “project_name =”の後ろに追加することができます。これにより、クライアントに入る際に “use project_name;”の実行を避けることができます。
  • エンドポイント。各リージョンのアクセスURLは異なります。

設定ファイルが変更されたら、binディレクトリで ‘odpscmd’を実行します。(OSがLinuxの場合は ‘./bin/odpscmd’、OSがWindowsの場合は ‘./bin/odpscmd.bat’を実行してください。)これでODPSコマンドを実行できます:

  1. odps@ test_project> whoami;
  2. Name: ALIYUN$test_user@aliyun.com
  3. End_Point: http://service.ap-southeast-1.maxcompute.aliyun.com
  4. Project: test_project

ヘルプ

ヘルプに関する情報を表示します。コマンドフォーマット:

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

または、対話モードで「h」または「help」と入力することもできます。(大文字小文字を区別しません)

起動パラメータ

クライアントを起動するときには、一連のパラメータを指定できます。

  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’を例として)

  • ローカルスクリプトファイル ‘script.txt’を準備します。ファイルがディスクDにあり、コンテンツが次のように表示されているとします。
  1. 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 d:/script.txt;
  • 実行結果を表示:
  1. ID = 20150528122432906gux77io3
  2. Log view:
  3. http://webconsole.odps.aliyun-inc.com:8080/logview/?h=http://service-corp.odps.aliyun-inc.com/api&p=odps_public_dev&i=2015052
  4. 8122432906gux77io3&token=RnlrSzJoL242YW43dFFIc1dmb1ZWZzFxQ1RFPSxPRFBTX09CTzoxMDcwMDI1NjI3ODA1NjI5LDE0MzM0MjA2NzMseyJTdGF0ZW1l
  5. bnQiOlt7IkFjdGlvbiI6WyJvZHBzOlJlYWQiXSwiRWZmZWN0IjoiQWxsb3ciLCJSZXNvdXJjZSI6WyJhY3M6b2RwczoqOnByb2plY3RzL29kcHNfcHVibGljX2Rld
  6. i9pbnN0YW5jZXMvMjAxNTA1MjgxMjI0MzI5MDZndXg3N2lvMyJdfV0sIlZlcnNpb24iOiIxIn0=
  7. OK
  8. ID = 20150528122439318gcmkk6u1
  9. Log view:
  10. http://webconsole.odps.aliyun-inc.com:8080/logview/?h=http://service-corp.odps.aliyun-inc.com/api&p=odps_public_dev&i=2015052
  11. 8122439318gcmkk6u1&token=dSt0RXdlV0M5YjZET2I1MnJuUFkzWDN1aWpzPSxPRFBTX09CTzoxMDcwMDI1NjI3ODA1NjI5LDE0MzM0MjA2ODAseyJTdGF0ZW1l
  12. bnQiOlt7IkFjdGlvbiI6WyJvZHBzOlJlYWQiXSwiRWZmZWN0IjoiQWxsb3ciLCJSZXNvdXJjZSI6WyJhY3M6b2RwczoqOnByb2plY3RzL29kcHNfcHVibGljX2Rld
  13. i9pbnN0YW5jZXMvMjAxNTA1MjgxMjI0MzkzMThnY21razZ1MSJdfV0sIlZlcnNpb24iOiIxIn0=
  14. OK
  15. ID = 20150528122440389g98cmlmf
  16. Log view:
  17. http://webconsole.odps.aliyun-inc.com:8080/logview/?h=http://service-corp.odps.aliyun-inc.com/api&p=odps_public_dev&i=2015052
  18. 8122440389g98cmlmf&token=NWlwL0EvQThxUXhzcTRERDc5NFg0b2IxZ3QwPSxPRFBTX09CTzoxMDcwMDI1NjI3ODA1NjI5LDE0MzM0MjA2ODAseyJTdGF0ZW1l
  19. bnQiOlt7IkFjdGlvbiI6WyJvZHBzOlJlYWQiXSwiRWZmZWN0IjoiQWxsb3ciLCJSZXNvdXJjZSI6WyJhY3M6b2RwczoqOnByb2plY3RzL29kcHNfcHVibGljX2Rld
  20. i9pbnN0YW5jZXMvMjAxNTA1MjgxMjI0NDAzODlnOThjbWxtZiJdfV0sIlZlcnNpb24iOiIxIn0=
  21. OK

対話モード

クライアントを直接実行すると、対話モードになります

  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;

コマンドをカーソル位置に入力し(セミコロンをステートメント終了マークとして使用)、Enterキーを押して実行します。

連続実行

  • ‘-e’または’-f’オプションを使用してコマンドを実行し、複数のステートメントがあり、前のステートメントを無視して中間ステートメントから実行を開始する場合は、パラメータ ‘-k’で位置を指定して実行できます。指定された”パラメータ <= 0”の場合は、最初の文から実行を開始します。
  • セミコロンで区切られた各ステートメントは、有効なステートメントとみなされます。正常に実行されたか、実行に失敗したステートメントは、実行時に出力されます。
  • たとえば、’/tmp/dual.sql’ファイルには3つのSQL文があります。
  1. drop table dual;
  2. create table dual (dummy string);
  3. insert overwrite table dual select count(*) from dual;

最初の2つのステートメントを無視するには:

  1. odpscmd k 3 f dual.sql

ログイン中のユーザーの情報取得

コマンドフォーマット:

  1. whoami;

使用例:

  1. odps@ hiveut>whoami;
  2. Name: odpstest@aliyun.com
  3. ID: 1090142773636588
  4. End_Point: http://10.249.215.1/odps_debug1
  5. Project: lijunsecuritytest

機能:現在ログイン中のユーザーのaliyunアカウントとエンドポイントの設定を取得します。

終了

コマンド:

  1. odps@ > quit;
  2. or q;