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

MaxCompute:SQL スクリプトの開発と送信

最終更新日:Feb 28, 2026

このトピックでは、MaxCompute Studio で SQL スクリプトを作成、設定、および実行する方法について説明します。

前提条件

SQL スクリプトの作成

  1. [プロジェクト] ツールウィンドウで、プロジェクト名をクリックし、[スクリプト] を右クリックして、[新規] > [MaxCompute SQL スクリプト] を選択します。Create an SQL script

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

    • スクリプト名:スクリプトの名前です。

    • [MaxCompute プロジェクト]: SQL スクリプトを書き込む MaxCompute プロジェクトです。[+] をクリックして、別の MaxCompute プロジェクトに接続します。詳細については、「プロジェクト接続の管理」をご参照ください。

  3. エディターで 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]安定版を使用します。
MaxQAMaxQA 機能を有効にしてジョブを実行します。
[MaxCompute Query Acceleration]MaxCompute Query Acceleration (MCQA) 機能を有効にしてジョブを実行します。
アクセラレーションが失敗した場合に再実行クエリアクセラレーションが失敗した場合にジョブを再実行します。

スクリプトの実行

  1. ツールバーまたはサイドバーで、Run icon アイコンをクリックして SQL スクリプトを MaxCompute サーバーに送信します。

    SQL スクリプトに ${bizdate} などの変数が含まれている場合、ダイアログボックスが変数値の入力を促します。たとえば、2017-11-11 00:00:00 を入力して、対応するパーティションのデータをクエリします。
  2. IntelliJ IDEA に表示される見積もりコストを確認し、[確認] メッセージで [OK] をクリックします。Cost confirmation 注意:

    • テーブルやユーザー定義関数 (UDF) など、SQL スクリプトで使用されるメタデータを更新するには、ツールバーの Refresh icon アイコンをクリックします。これは、MaxCompute Studio が MaxCompute 内のテーブルと関数を検出できない場合に使用します。

    • SQL スクリプトは、[プロジェクト エクスプローラー] ウィンドウに追加されたメタデータに基づいてコンパイルされます。エラーが検出されない場合、スクリプトは実行のために MaxCompute サーバーに送信されます。

    • 実行中に実行ログが生成されます。MaxCompute で SQL スクリプトが実行されると、ジョブ詳細タブに実行の詳細が表示されます。

    • SQL ジョブのコスト推定を表示するには、[スクリプト送信時に SQL コスト確認ダイアログを表示]MaxCompute SQL 設定項目 で選択します。

  3. [結果]」タブで、実行結果を表示します。複数の文が1つずつ実行された場合、各文の結果がそれぞれ別々に表示されます。実行結果