edit-icon download-icon

コンソール

最終更新日: Jun 19, 2018

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

注意

  • クライアントの出力形式に基づいて分析操作を実行しないでください。クライアントの出力形式は、フォワード互換のため保証されていません。バージョンによってクライアントのコマンド形式と動作が異なります。
  • クライアントの基本コマンドの詳細については、基本コマンドを参照してください。

クライアントをインストールして構成すると、コマンド行を使用して次の操作を実行できます。

ヘルプ

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

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

対話モードで h;help;(大文字小文字を区別しない)を入力することもできます。

コンソールには、キーワードに関連するコマンドプロンプトを表示する help [keyword];コマンドもあります。例えば、テーブル操作に関連するコマンドプロンプトを得るには、 help 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 にあり、コンテンツが次のように表示されます。
    1. DROP TABLE IF EXISTS test_table_mj;
    2. CREATE TABLE test_table_mj (id string, name string);
    3. DROP TABLE test_table_mj;
  2. 次のコマンドを実行します。
    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;

カーソル位置にコマンドを入力(ステートメント終止符としてセミコロンを使用)し、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 つのステートメントを無視し、3 番目のステートメントから実行を開始するには、次のコマンドを実行します。

  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

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

終了

コンソールを終了するには、次のコマンドを実行します。

  1. odps@ > quit;

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

  1. odps@ > q;