すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Jun 09, 2026

    MaxCompute Studio で SQL スクリプトを作成および実行して、テーブルの作成、データの挿入、結果のクエリを行います。

    前提条件

    SQL スクリプトファイルの作成

    1. [Project] ツールウィンドウで、[scripts] を右クリックし、[新規] > [MaxCompute SQL スクリプト] を選択します。

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

      • スクリプト名：スクリプト名。

      • MaxCompute プロジェクト：ターゲットプロジェクト。 [+] をクリックしてプロジェクト接続を追加します。 プロジェクト接続の管理。

    3. エディターで SQL スクリプトを作成します。構文については、「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}';
      説明

      • スクリプトモードは、プロジェクト間のリソース依存関係をサポートしています。たとえば、プロジェクト A にバインドされたスクリプトは、プロジェクト B の table1 (ProjectB.table1) にもアクセスできます。

      • SQL スクリプトエディターはカスタマイズできます。詳細については、「概要」をご参照ください。

    SQL スクリプトの送信

    スクリプトを送信する前に、エディターの上部にあるツールバーで次の項目を設定します：

    • エディターモード：

      • [ステートメントモード]: スクリプトを ; で分割し、各ステートメントを個別に送信します。

      • [スクリプトモード]: 1 回のリクエストでスクリプト全体を送信し、全体的な最適化を行います。推奨。

    • 型システム：SQL の互換性を決定します。

      • [レガシー型システム]: 従来の MaxCompute 型システムです。

      • [MaxCompute 型システム]: MaxCompute 2.0 で導入された型システムです。

      • [Hive 互換型システム]: MaxCompute 2.0 の Hive 互換型システムです。

    • 実行モード：

      • [デフォルト]：安定した実行モードです。

      • MaxQA：MaxQA クエリ高速化機能を使用します。

      • [MaxCompute クエリ高速化]: 最新の MCQA 機能を有効にします。

      • [アクセラレーション失敗時に再実行]: クエリ アクセラレーションが失敗した場合、ジョブを自動的に再実行します。

    1. ツールバーまたはサイドバーの Run アイコンをクリックして、スクリプトを実行します。

      説明

      スクリプトに ${bizdate} などの変数が含まれている場合、ダイアログボックスが表示され、値の入力が求められます。たとえば、2017-11-11 00:00:00 と入力して、ターゲットパーティションのデータをクエリします。

    2. [確認] ダイアログボックスで推定コストを確認し、[OK] をクリックします。

      ダイアログボックスには、コスト見積もりの指標として、[Inputs] (入力データサイズ、単位：バイト)、[UDF Count] (UDF の数)、および [Complexity] が表示されます。このダイアログボックスを今後表示しないようにするには、[Do not show this dialog again] を選択します。

      説明

      • ツールバーの Refresh アイコンをクリックすると、メタデータ (テーブルと UDF) が更新されます。サーバー上にテーブルや関数が存在するにもかかわらず、MaxCompute Studio で「存在しない」と表示される場合は、この機能を使用してください。

      • スクリプトは、[Project Explorer] ウィンドウのプロジェクトメタデータと照合してローカルでコンパイルされます。コンパイルが成功すると、スクリプトはサーバーに送信されます。

      • 実行中に実行ログが表示されます。サーバーでジョブが開始されると、[Job Details] タブが自動的に開きます。

      • 推定コストを表示するには、MaxCompute SQL 設定オプションで [スクリプト送信時に SQL コスト確認ダイアログを表示する] チェックボックスを選択します。

    3. コンソールの結果タブで実行結果を表示します。

      ステートメントモードでは、各ステートメントの結果が個別に表示されます。

      [Result] タブには、各ステートメント ( INSERT INTO TABLE... や SELECT * FROM... など) の出力が、対応する SQL と返されたデータとともに、個別のセクションに表示されます。