このトピックでは、MaxCompute Studio で SQL スクリプトを作成、設定、および実行する方法について説明します。
前提条件
MaxCompute プロジェクトが接続されています。詳細については、「プロジェクト接続の管理」をご参照ください。
MaxCompute スクリプトモジュールが作成されています。詳細については、「MaxCompute スクリプトモジュールの作成」をご参照ください。
SQL スクリプトの作成
[プロジェクト] ツールウィンドウで、プロジェクト名をクリックし、[スクリプト] を右クリックして、[新規] > [MaxCompute SQL スクリプト] を選択します。

[新規 MaxCompute SQL スクリプト] ダイアログボックスで、次のパラメーターを設定し、[OK] をクリックします。

スクリプト名:スクリプトの名前です。
[MaxCompute プロジェクト]: SQL スクリプトを書き込む MaxCompute プロジェクトです。[+] をクリックして、別の MaxCompute プロジェクトに接続します。詳細については、「プロジェクト接続の管理」をご参照ください。
エディターで SQL スクリプトを作成します。SQL 構文の詳細については、「MaxCompute SQL の概要」をご参照ください。サンプルスクリプト: 注:
プロジェクト間リソース共有がサポートされています。たとえば、Project A にバインドされたスクリプトは、Project B の table1 にアクセスできます。
MaxCompute Studio では、SQL スクリプトエディターを設定できます。詳細については、「概要」をご参照ください。
CREATE TABLE table_5( col1 BIGINT, col2 BIGINT, col3 BIGINT, ds DATETIME ); INSERT INTO TABLE table_5 VALUES (1, 2,3,DATETIME'2025-11-11 00:00:00'); SELECT * FROM table_5 WHERE ds='${bizdate}';
コンパイルパラメーターの設定
SQL スクリプトを送信する前に、エディター上部のツールバーでコンパイルパラメーターを設定します。
エディターモード
| オプション | 説明 |
|---|---|
| ステートメントモード | ;SQL 文をセミコロン (;) で区切り、各文を個別に MaxCompute サーバーに送信します。 |
| [Script Mode] (推奨) | スクリプト全体を一度に MaxCompute サーバーに送信し、全体的な最適化を行います。これは最新の開発モードであり、より優れた実行効率を提供します。 |
型システム
このパラメーターを設定して、SQL 文の実行時に互換性の問題を防止します。
| オプション | 説明 |
|---|---|
| [レガシー型システム] | MaxCompute V1.0 データの型エディションです。 |
| [MaxCompute 型システム] | MaxCompute V2.0 データの型エディションです。 |
| [Hive 互換型システム] | Hive 互換データの型エディションです。 |
実行モード
| オプション | 説明 |
|---|---|
| [Default Version] | 安定版を使用します。 |
| MaxQA | MaxQA 機能を有効にしてジョブを実行します。 |
| [MaxCompute Query Acceleration] | MaxCompute Query Acceleration (MCQA) 機能を有効にしてジョブを実行します。 |
| アクセラレーションが失敗した場合に再実行 | クエリアクセラレーションが失敗した場合にジョブを再実行します。 |
スクリプトの実行
ツールバーまたはサイドバーで、
アイコンをクリックして SQL スクリプトを MaxCompute サーバーに送信します。SQL スクリプトに
${bizdate}などの変数が含まれている場合、ダイアログボックスが変数値の入力を促します。たとえば、2017-11-11 00:00:00を入力して、対応するパーティションのデータをクエリします。IntelliJ IDEA に表示される見積もりコストを確認し、[確認] メッセージで [OK] をクリックします。
注意:テーブルやユーザー定義関数 (UDF) など、SQL スクリプトで使用されるメタデータを更新するには、ツールバーの
アイコンをクリックします。これは、MaxCompute Studio が MaxCompute 内のテーブルと関数を検出できない場合に使用します。SQL スクリプトは、[プロジェクト エクスプローラー] ウィンドウに追加されたメタデータに基づいてコンパイルされます。エラーが検出されない場合、スクリプトは実行のために MaxCompute サーバーに送信されます。
実行中に実行ログが生成されます。MaxCompute で SQL スクリプトが実行されると、ジョブ詳細タブに実行の詳細が表示されます。
SQL ジョブのコスト推定を表示するには、[スクリプト送信時に SQL コスト確認ダイアログを表示] を MaxCompute SQL 設定項目 で選択します。
「[結果]」タブで、実行結果を表示します。複数の文が1つずつ実行された場合、各文の結果がそれぞれ別々に表示されます。
