すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Apr 10, 2025

    このトピックでは、MaxCompute Studio で SQL スクリプトを開発および送信する方法について説明します。SQL スクリプトの開発には、SQL スクリプトの作成と実行が含まれます。

    前提条件

    SQL スクリプトの作成

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

      创建

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

      脚本名称

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

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

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

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

    SQL スクリプトの送信

    SQL スクリプトを送信する前に、ビジネス要件に基づいてコンパイルパラメーターを設定する必要があります。MaxCompute Studio はさまざまなコンパイルパラメーターを提供します。エディターの上にあるツールバーでパラメーターを設定できます。次のコンパイルパラメーターを設定できます。

    • エディターモード

      • ステートメントモード: このモードでは、エディターはスクリプト内の SQL ステートメントをセミコロン (;) で区切り、ステートメントを 1 つずつ MaxCompute サーバーに送信して実行します。

      • スクリプトモード: これは最新の開発モードです。このモードでは、エディターはスクリプト全体を一度に MaxCompute サーバーに送信して、全体的な最適化を行います。実行効率を向上させるために、このモードを使用することをお勧めします。

    • 型システム: SQL ステートメントを実行するときの互換性の問題を防ぐために、このパラメーターを設定できます。有効な値:

      • レガシー型システム: MaxCompute V1.0 データ型エディションを示します。

      • MaxCompute 型システム: MaxCompute V2.0 データ型エディションを示します。

      • Hive 互換型システム: Hive 互換データ型エディションを示します。

    • 実行モード

      • デフォルトバージョン: 安定バージョンが使用されていることを示します。

      • MaxQA: ジョブを実行するために MaxQA 機能が有効になっていることを示します。

      • MaxCompute クエリ高速化: ジョブを実行するために MaxCompute クエリ高速化 (MCQA) 機能が有効になっていることを示します。

      • 高速化に失敗した場合に再実行: クエリ高速化に失敗した場合にシステムがジョブを再実行することを示します。

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

      説明

      前のコードの ${bizdate} などの変数が SQL スクリプトに存在する場合、変数の値を入力するように求めるダイアログボックスが表示されます。この例では、2017-11-11 00:00:00 を入力して、現在のパーティションのデータをクエリできます。

    2. MaxCompute が SQL スクリプトを実行する前に、IntelliJ IDEA は SQL スクリプトの推定コストを表示します。推定コストを確認し、[OK] を [確認] メッセージでクリックします。

      确认费用

      説明

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

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

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

      • SQL ジョブのコスト見積もりを表示する場合は、MaxCompute SQL 設定項目 から [スクリプト送信時に SQL コスト確認ダイアログを表示する] を選択できます。MaxCompute SQL 設定項目

    3. [結果] タブで、実行結果を表示します。

      複数のステートメントが 1 つずつ実行される場合、各ステートメントの実行結果が表示されます。

      运行结果