MaxComputeクライアント (odpscmd) は、Alibaba CloudのwebベースのCLIツールであるCloud Shellを介して、手動でインストールすることなく使用できます。 このトピックでは、MaxCompute with Cloud Shell (odpscmd) を運用するための使用法ノートと基本的な例を示します。 Clout Shellの詳細については、Cloud Shellとはをご参照ください。
前提条件
MaxComputeのCloud Shell (odpscmd) をRAMユーザーとして使用する場合は、RAMユーザーにAliyunCloudShellFullAccess権限があることを確認してください。 詳細については、「RAM ユーザーへの権限付与」をご参照ください。
制限事項
クラウドシェルの制限
項目
説明
VMの数
開かれるCloud Shellセッションの数に関係なく、一度に作成できる仮想マシン (VM) は1つだけです。 開かれたすべてのCloud Shellセッションは自動的にVMに接続されます。
セッション数
一度に最大5つのセッションを開くことができます。
VMの破壊
30分間対話操作が実行されない場合、またはすべてのセッションが閉じられている場合、VMは15分で破棄されます。 Cloud Shellを再起動すると、新しいVMが作成されます。
期限切れの破壊
Cloud Shellによって作成されたVMは、1時間のみ有効です。 VMの有効期限が切れると、Cloud ShellはすぐにVMを破棄します。Cloud Shellを再起動すると、新しいVMが作成されます。
ファイルストレージ
Cloud Shellは10 GBの一時ストレージを提供します。 ファイルは /home/shellディレクトリに保存できます。 ただし、VMが破壊されるとディレクトリはリセットされます。 Cloud ShellインスタンスをFile Storage NASにアタッチして、永続的に保存できます。 その後、Cloud Shellが起動するたびにファイルが自動的にロードされます。
禁止
長期使用またはコンピューティングおよび集中的な悪意のあるプロセスはサポートされません。 これらの場合、セッションは警告なしに終了されるか、または禁止されることさえある。
リージョン制限
リージョン中国 (杭州) 、中国 (上海) 、中国 (北京) 、
中国 (深セン) は、MaxComputeに接続するためのCloud Shellをサポートしています。
注意事項
デフォルトでは、任意のリージョンでMaxComputeのCloud Shell (odpscmd) を起動すると、Cloud Shellサービスと一時ストレージサービスが中国 (上海) リージョンにデプロイされます。 プロジェクトが別のリージョンにある場合は、この機能を使用するとデータのセキュリティリスクが発生する可能性があることに注意してください。
Cloud Shell (odpscmd) 環境に入る
MaxComputeコンソールにログインし、左上隅のリージョンを選択します。
右上隅の [コマンドライン] をクリックします。
[プロジェクトの選択] ダイアログボックスで、管理するプロジェクトを選択し、[OK] をクリックします。
説明NASのマウントについてプロンプトが表示されたら、必要に応じてマウントできます。 詳細については、「 (オプション) マウントNAS」をご参照ください。
Cloud Shell (odpscmd) が読み込まれると、次のようにインターフェイスが表示されます。
(オプション) マウントNAS
Cloud Shellには10 GBの一時ストレージがあり、仮想マシンの終了時にリセットされます。 Cloud Shellが起動するたびに自動的にロードされるストレージ用のストレージスペースをマウントできます。 NASをマウントする手順は次のとおりです。
[MaxCompute Cloud CMD] ウィンドウで、アイコンをクリックし、[ファイルストレージのマウント] を選択してNASストレージをアタッチします。
NASのマウントにはNASストレージ料金がかかります。 使用後、すぐにストレージスペースを切り離すことができます。 NASストレージ料金の詳細については、「課金の概要」をご参照ください。
Cloud Shell (odpscmd) の使用
Cloud Shell (odpscmd) は、ローカルクライアントで使用可能なすべてのSQLコマンドの実行をサポートします。 このセクションでは、Cloud Shell (odpscmd) の操作方法について、SQLコマンドの実行とデータ送信の例を示します。
SQLコマンドの実行
次のコマンド例を使用して、result_table1
という名前のテーブルを作成します。
create table if not exists result_table1
(
education STRING comment 'education level',
num BIGINT comment 'number of people');
以下のコマンド例を使用して作成したテーブルを表示します。
show tables;
データ伝送
ファイルのアップロード
アイコンをクリックして [アップロード] を選択し、ローカルファイルをアップロードします。 例として、このトピックではresult.txtファイルを使用します。
アップロードが完了したら、
Ctrl + c
でCloud Shell (odpscmd) 環境を終了し、ll
を実行してアップロードの成功とファイルパスを確認します。次のコマンドでCloud Shell (odpscmd) 環境に戻ります。
cloudshell-odpscmd -p <project.name>
提供されたコマンド例を使用して、ファイル
result.txt
をMaxComputeにアップロードします。tunnel upload result.txt result_table1;
ファイルダウンロード
以下のコマンド例を使用して、MaxComputeテーブル
result_table1
をCloud Shell (odpscmd) にダウンロードします。Tunnel download result_table1 result_table1.txt;
アイコンをクリックして [ダウンロード] を選択し、
result_table1.txt
ファイルをローカルデバイスにダウンロードします。ダウンロードが完了すると、次のようにインターフェイスが表示されます。