すべてのプロダクト
Search

このプロダクト

    MaxCompute:Cloud Shell で odpscmd を使用して MaxCompute に接続する

    ドキュメントセンター

    MaxCompute:Cloud Shell で odpscmd を使用して MaxCompute に接続する

    最終更新日:Nov 09, 2025

    MaxCompute は Alibaba Cloud Shell と統合されており、Web ベースのコマンドラインクライアントを提供します。これにより、ローカルクライアントをインストールすることなく、ブラウザから直接 odpscmd コマンドを実行できます。このトピックでは、重要な考慮事項について説明し、Cloud Shell で odpscmd を使い始めるための基本的な例を示します。

    前提条件

    RAM ユーザーとして接続する場合、ユーザーに [AliyunCloudShellFullAccess] 権限があることを確認してください。権限の付与に関する詳細については、「RAM ユーザーへの権限付与」をご参照ください。

    制限事項

    説明

    Cloud Shell は、Alibaba Cloud が提供する Web ベースのコマンドラインツールです。MaxCompute は Cloud Shell と統合されており、事前に設定されたクライアント環境を提供するため、手動でインストールすることなく odpscmd を使用できます。Cloud Shell の詳細については、「Cloud Shell とは」をご参照ください。

    • Cloud Shell の制限事項

      項目

      説明

      VM の数

      開かれている Cloud Shell セッションの数に関係なく、一度に作成できる仮想マシン (VM) は 1 つだけです。開かれているすべての Cloud Shell セッションは、自動的にその VM に接続されます。

      セッションウィンドウの数

      一度に最大 5 つのセッションを開くことができます。

      インタラクションがない場合の VM の破棄

      30 分間インタラクティブな操作が実行されない場合、またはすべてのセッションが閉じられた場合、VM は 15 分で破棄されます。Cloud Shell を再起動すると、新しい VM が作成されます。

      有効期限切れによる VM の破棄

      Cloud Shell によって作成された VM は 1 時間のみ有効です。VM の有効期限が切れると、Cloud Shell は直ちに VM を破棄します。Cloud Shell を再起動すると、新しい VM が作成されます。

      ファイルストレージ

      Cloud Shell は 10 GB の一時記憶領域を提供します。ファイルは /home/shell ディレクトリに保存できます。ただし、このディレクトリは VM が破棄されるとリセットされます。ストレージ用のストレージ領域をマウントすることを選択でき、これは Cloud Shell が起動するたびに自動的にロードされます。

      禁止事項

      長期間の使用や、コンピューティングおよびネットワーク集約型の悪意のあるプロセスはサポートされていません。このような場合、セッションは警告なしに終了されたり、禁止されたりすることがあります。

    • サポートされているリージョン

      Cloud Shell を使用して、次のリージョンの MaxCompute プロジェクトに接続できます: 中国 (杭州)、中国 (上海)、中国 (北京)、および中国 (深圳)。

    使用上の注意

    データの常駐とセキュリティ: Cloud Shell サービスとその一時記憶領域は、中国 (上海) リージョンでホストされています。別のリージョンの MaxCompute プロジェクトに接続すると、データは処理のためにリージョンを越えて上海に転送されます。続行する前に、このリージョン間のデータ転送が組織のデータ常駐ポリシーに準拠していることを確認してください。

    Cloud Shell で odpscmd を開始する

    1. MaxCompute コンソールにログオンし、左上隅でリージョンを選択します。

    2. [ワークスペース] > [プロジェクト] ページで、右上隅にある [コマンドライン] をクリックします。

    3. [プロジェクトの選択] ダイアログボックスで、管理するプロジェクトを選択し、[OK] をクリックします。

      説明

      NAS ファイルシステムのマウントに関するダイアログボックスが表示された場合は、必要に応じてマウントできます。詳細については、「(オプション) NAS ファイルシステムをマウントする」をご参照ください。

      Cloud Shell (odpscmd) がロードされると、次の図に示すようにインターフェイスが表示されます。image.png

    (オプション) NAS ファイルシステムをマウントする

    Cloud Shell は 10 GB の一時記憶領域を提供します。この領域は、仮想マシンが破棄されるとリセットされます。永続ストレージの場合は、NAS ファイルシステムをマウントできます。これは、Cloud Shell が起動するたびに自動的にロードされます。NAS ファイルシステムをマウントするには、次のステップを実行します。

    [MaxCompute Cloud CMD] ウィンドウで、image.png アイコンをクリックし、[ストレージ領域のマウント] を選択して、NAS ファイルシステムをアタッチします。

    説明

    NAS ファイルシステムをマウントすると、ストレージ料金が発生します。ファイルシステムの使用が終了したら、速やかにデタッチしてください。NAS ストレージ料金の詳細については、「課金の概要」をご参照ください。

    Cloud Shell (odpscmd) の使用

    MaxCompute 用の Cloud Shell (odpscmd) は、ローカルクライアントで実行できるすべての SQL コマンドをサポートしています。このセクションでは、Cloud Shell (odpscmd) を使用して SQL コマンドを実行し、データを転送する方法の例を示します。

    SQL コマンドの実行

    result_table1 という名前のテーブルを作成するには、次のコマンドを実行します:

    CREATE TABLE IF NOT EXISTS result_table1 (
 education STRING comment '学歴',
 num BIGINT comment '人数');

    テーブルが作成されたら、次のコマンドを実行して表示します:

    SHOW TABLES;

    データ転送

    • ファイルのアップロード

      1. image.png アイコンをクリックし、[アップロード] を選択してローカルファイルをアップロードします。このトピックでは、result.txt ファイルを例として使用します。

        アップロードが完了したら、Ctrl+C を押して Cloud Shell (odpscmd) 環境を終了します。次に、ll コマンドを実行してファイルがアップロードされたことを確認し、ファイルパスを表示します。

        image.png

        ファイルがアップロードされたことを確認したら、次のコマンドを実行して Cloud Shell (odpscmd) 環境に戻ります:

        cloudshell-odpscmd -p <project.name>

      2. 次のコマンドを実行して、result.txt ファイルを MaxCompute にアップロードします:

        tunnel upload result.txt result_table1;

    • ファイルのダウンロード

      1. 次のコマンドを実行して、MaxCompute から Cloud Shell (odpscmd) に result_table1 テーブルをダウンロードします:

        Tunnel download result_table1 result_table1.txt;

      2. image.png アイコンをクリックし、[ダウンロード] を選択して result_table1.txt ファイルをローカルコンピューターにダウンロードします。

        ダウンロードが完了すると、結果は次の図のようになります。

        image.png