すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:MaxCompute Studio の設定

最終更新日:May 14, 2026

このトピックでは、MaxCompute Studio を設定する方法について説明します。

MaxCompute Studio プラグインをインストールした後、[File] > [Settings...] に移動して、[MaxCompute Studio] 設定ダイアログボックスを開きます。

MaxCompute Studio の設定項目

[Settings] ダイアログボックスで、左側メニューの [MaxCompute Studio] をクリックします。次の設定オプションがあります。

  • General Settings

    • [Local meta store location]:MaxCompute プロジェクトのメタデータを保存するローカルパスを指定します。デフォルトでは、MaxCompute Studio はユーザーホームディレクトリ内の .odps.studio\meta ディレクトリを使用します。

    • [Table preview rows]:テーブルプレビューに表示する最大行数です。

    • [Local directory for jobs]:MaxCompute Studio ジョブのデータを保存するローカルパスです。デフォルトでは、MaxCompute Studio はローカルパス .odps.studio\job にデータを保存します。

      説明

      デフォルト値を維持する場合は、パス .odps.studio\job が存在し、MaxCompute Studio がそのパスに対する書き込み権限を持っていることを確認する必要があります。そうでない場合、設定を確定する際にエラーが発生する可能性があります。

    • [Python path to resolve UDF]:Python のローカルインストールパスです。

  • Updates Checking

    • [Automatically checks for new version]:選択すると、MaxCompute Studio が自動的に更新を確認します。このオプションはデフォルトで有効になっています。

    • [Check new versions]:クリックして手動で更新を確認します。新しいバージョンが見つかった場合は、[Install latest version] をクリックしてインストールします。その後、変更を有効にするには IntelliJ IDEA を再起動する必要があります。

SDK & Console の設定項目

[Settings] ダイアログボックスの左側メニューで [MaxCompute Studio > SDK & Console] をクリックし、SDK & Console の設定ページを開きます。

このページでは、[Installed Location] オプションを使用して、ローカルの MaxCompute クライアントのインストールパスを指定します。MaxCompute Studio は、指定したパス内のクライアントバージョンを自動的に検出します。検出に失敗した場合は、エラーメッセージが表示されます。

説明

MaxCompute Studio のバージョンが V2.6.1 より新しい場合、MaxCompute Studio が最新の MaxCompute クライアントを自動的にインストールするため、パスを指定する必要はありません。特定バージョンの MaxCompute クライアントを使用する場合は、パスを指定できます。

MaxCompute SQL の設定項目

[Settings] ダイアログボックスの左側メニューで [MaxCompute Studio > MaxCompute SQL] をクリックし、MaxCompute SQL の設定ページを開きます。

次の設定項目がダイアログボックスの右側に表示されます。

  • Color and Annotator

    [Enable syntax coloring] を選択すると、コードにシンタックスハイライトが適用されます。

  • Code Completion

    • [Enable code completion] を選択すると、入力に応じて自動的に候補が表示されます。

    • このオプションを選択すると、スペースバーを押したときにコード補完がトリガーされます。

  • Code Formatting

    • [Enable code formatting] を選択すると、SQL コードの再フォーマットを実行できます。

    • [Enable code folding] を選択すると、コードブロックの折りたたみと展開を実行できます。

  • Script Submit

    • [Show job detail when script submitted]:選択すると、スクリプトの送信後にジョブの詳細が自動的に表示されます。

    • [Record SQL history when script submitted]:選択すると、送信した SQL スクリプトが履歴に保存されます。

    • [Show SQL cost confirm dialog when script submitted]:選択すると、スクリプトの送信前にコスト確認ダイアログが表示されます。

    • [Pin SQL execution result tab by default]:選択すると、SQL 実行結果タブがデフォルトで固定されます。

    • [Ignore local compile error when submit script] (Optional):スクリプトの送信時にローカルのコンパイルエラーを無視します。

    • [Use tunnel to download query acceleration result] (Optional):トンネルを使用してクエリ高速化の結果をダウンロードします。

    • [Job Name]:デフォルトのジョブ名の生成方法を設定します。

      • [Use script file name as default]:スクリプトのファイル名をデフォルトのジョブ名として使用します。

      • [Input job name when first submit]:初回の送信時にジョブ名の入力を求めます。

      • [Input job name for every submit]:送信のたびにジョブ名の入力を求めます。

  • Compile | Submit

    このセクションでは、グローバルなコンパイラ設定のデフォルト値を説明します。SQL コンパイラのツールバーで、各ファイルの設定項目を個別に設定できます。

    • [Compiler Mode]

      • [Statement Mode]:このモードでは、コンパイラは SQL ファイル内の各ステートメントを単位としてコンパイルし、送信します。

      • Script Mode:SQL ファイル全体を単一のスクリプトとしてコンパイルし、送信します。このモードでは、オプティマイザが実行計画を改善し、全体の効率を向上させることができます。

    • [Data type edition]

      • [Legacy TypeSystem]:MaxCompute V1.0 のデータ型エディションを使用します。

      • [MaxCompute TypeSystem]:MaxCompute V2.0 のデータ型エディションを使用します。

      • [Hive Compatible TypeSystem]:MaxCompute V2.0 のデータ型エディションに基づく Hive 互換のデータ型エディションを使用します。

    • 実行モード

      • デフォルト:MaxCompute が提供する標準の実行エンジンを使用します。

      • [UseShortQueryAcceleration]:クエリを高速化できるコンパイラを使用します。

      • [FallbackWhenFailed]:クエリ高速化に失敗した場合に、ジョブを再実行するコンパイラを使用します。

MaxCompute Job の設定項目

[Settings] ダイアログボックスの左側メニューで [MaxCompute Studio > MaxCompute Job] をクリックし、MaxCompute Job の設定ページを開きます。

次の設定項目がダイアログボックスの右側に表示されます。

  • Maximum jobs shown in job explorer table list:Job Explorer ページに表示できるジョブの最大数です。デフォルト値:1000

  • Reset filter when switch MaxCompute project:この設定項目を選択すると、MaxCompute プロジェクトを切り替える際にジョブ設定がリセットされます。

  • Cache history instance in local database:この設定項目を選択すると、過去のインスタンス情報がローカルデータベースにキャッシュされます。

Accounts の設定項目

[Settings] ダイアログボックスの左側メニューで [MaxCompute Studio > Accounts] をクリックし、Accounts の設定ページを開きます。

このページでは、MaxCompute にアクセスするアカウントを管理します。アカウントの詳細については、「ユーザー認証」をご参照ください。

説明

MaxCompute Studio は、指定したアカウントを使用して MaxCompute プロジェクトにアクセスし、ジョブを実行します。

  • アカウントの追加

    1. 右側のナビゲーションペインで [+] をクリックし、[Alibaba Cloud account by AccessKey] を選択します。

    2. [Add MaxCompute Account] ダイアログボックスで、次のパラメータを設定します。

      • [Account Name]:MaxCompute Studio に表示するアカウント名です。 user_****@test.aliyun.com のような Alibaba Cloud アカウントの場合、このフィールドを user_test に設定します。 user_****@test.aliyun.com の Alibaba Cloud アカウントに属する user_ram@xxxxx.onaliyun.com のような RAM ユーザーの場合、このフィールドを user_****:user_ram に設定します。

      • [Using properties file]:以前に MaxCompute クライアントまたは MaxCompute Studio を設定しており、ローカルに odps_config.ini ファイルがある場合は、このオプションを選択して、設定ファイルから AccessKey ID と AccessKey Secret を読み取れます。このオプションを選択した場合は、ローカルの odps_config.ini ファイルをアップロードする必要があります。

      • [Using properties]:AccessKey ID と AccessKey Secret を手動で入力します。このオプションまたは [Using properties file] のいずれかを選択できます。

        • [AccessKey ID]:Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID を入力します。

        • [AccessKey Secret]:Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey Secret を入力します。

    3. [OK] をクリックします。新しいアカウントが [Accounts] ページのリストに表示されます。

  • アカウントの削除

    次の手順を実行して、MaxCompute Studio からアカウントを削除できます。この操作は、Alibaba Cloud アカウント、またはその Alibaba Cloud アカウントに属する RAM ユーザーには影響しません。

    1. アカウントリストから削除するアカウントを選択します。

    2. 右側のナビゲーションペインで - をクリックします。

    3. 表示された確認ダイアログボックスで [OK] をクリックし、アカウントを削除します。

  • アカウント情報の変更

    1. アカウントリストから、情報を変更するアカウントを選択します。

    2. 右側のナビゲーションペインで 修改 アイコンをクリックします。

    3. [Edit MaxCompute Account] ダイアログボックスで、次のアカウント情報を編集します。

      • [AccessKey ID]:更新後の Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID を入力します。

      • [AccessKey Secret]:更新後の Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey Secret を入力します。

    4. [OK] をクリックして変更を保存します。