すべてのプロダクト
Search

このプロダクト

    MaxCompute:SQL Analysis の使用

    ドキュメントセンター

    MaxCompute:SQL Analysis の使用

    最終更新日:Feb 28, 2026

    このトピックでは、MaxCompute コンソールの SQL Analysis 機能を使用して、SQL 文をオンラインで編集・実行し、その結果を分析する方法について説明します。

    重要

    クラウドネイティブ技術の進化に対応し、ますます複雑化するデータ分析ニーズを満たすため、Alibaba Cloud MaxCompute コンソールの SQL Analysis 機能がアップグレードされ、すべてのリージョンで利用可能になりました。新機能および有効化方法の詳細については、「SQL Analysis（新バージョン）を使用した接続」をご参照ください。

    旧バージョンの SQL Analysis のエントリポイントは 2026 年 3 月 31 日（UTC + 08:00）に廃止されます。旧ワークスペース内のローカルファイルは速やかに整理してください。今後の利用に備えて、手動でそれらのファイルを SQL Analysis 新バージョンの個人フォルダに移動することを推奨します。

    機能概要

    • SQL 文をオンラインで編集・実行し、クエリ結果をチャートで分析できます。

    • MaxCompute の機能をすぐに体験・テストできるよう、組み込みの公開データセットデモが用意されています。

    ユースケース

    • クイック体験：公開データセットに基づき、MaxCompute の主要機能をすぐに体験できます。

    • アドホックテスト：テーブルデータの確認など、一時的なテスト目的で SQL コマンドを実行できます。

    SQL Analysis インターフェイス

    エディターエリア

    image

    モジュール

    説明

    タブバー

    ファイルタブです。複数のファイルを同時に開くことができます。

    • タブバーの空白部分をダブルクリックすると、.sql ファイルを素早く作成できます。

    • タブバーの空白部分を右クリックし、[新規ファイル] を選択します。

    ツールバー

    • [実行]：SQL スクリプトを実行します。現在のファイル内で SQL スクリプトの一部を選択して実行できます。選択しない場合は、ファイル内のすべての SQL スクリプトがデフォルトで実行されます。

    • [停止]：[停止] ボタンは、[実行] をクリックした後に表示されます。

    • [保存]：現在のパブリックプレビュー版では、オンラインでのファイルストレージはサポートされていません。ローカルへの保存のみ可能です。.sql ファイルとして保存してください。

    • [フォーマット]：現在のファイル内の SQL コードを整形します。

    • [実行結果]：現在のファイルで SQL スクリプトが実行済みで、結果エリアが非表示になっている場合、このボタンをクリックして表示します。

    • [コスト分析]：COST SQL 文を実行し、課金量を推定します。スキャンされるデータ量および SQL 文の複雑度が返されます。

    エディター

    • スクリプトの最初の行は、実行可能な文である必要があります。

    • .sql ファイルに複数の SQL スクリプトが含まれる場合、フラグ（SET 文）はファイルの先頭に配置する必要があります。これらのフラグはファイル内のすべての SQL 文に適用されます。

    • 全画面モードをサポートしており、入力・実行・結果の確認を全画面で行えます。

    実行時パラメーター構成エリア

    image

    モジュール

    説明

    プロジェクト

    • SQL コードを実行するプロジェクトを選択します。この設定は必須です。

    • 選択したプロジェクトに対して、現在のアカウントが create instance 権限を持っている必要があります。

    • 初回実行時にはプロジェクトを選択する必要があります。その後、最後に選択したプロジェクトがキャッシュに記録されます。いつでもプロジェクトを変更できます。

    • この選択は、すべてのファイルタブに適用されます。

    コンピューティングクォータ

    • 使用する計算クォータを選択します。この設定は任意です。

    • クォータを選択する場合、現在のアカウントがそのクォータに対する usage 権限を持っている必要があります。

    • クォータを選択しない場合、プロジェクトの デフォルト計算クォータ が使用されます。

    • この選択は、すべてのファイルタブに適用されます。

    結果エリア

    image

    モジュール

    説明

    問題

    スクリプト実行前に、エディターエリアで開いているすべてのファイルのスクリプトについて、構文と標準が自動的にチェックされます。

    [METADATA]

    [テーブルデータ] または [公開データセット] からテーブル、リソース、ユーザー定義関数などのオブジェクトを選択すると、そのメタデータの詳細が表示されます。詳細には、基本情報、カラム情報、生成された DDL、およびデータプレビューが含まれます。

    オブジェクトの表示には、関連するデータベース権限が必要です。

    結果

    実行されたスクリプトの結果：

    • 実行リスト：現在のファイルで SQL 文を実行するたびに開始時刻が記録されます。レコードをクリックすると、その実行に関する情報が表示されます。

    • ログ：各実行のログ内容。

    • SQL：各実行の具体的な SQL コード。

    • 結果リスト：表示すべき結果がある場合、ここに表示されます。

    • 分析：結果がある場合、ここで簡単なチャート分析を実行できます。

    コスト分析

    [COST ANALYSIS] 実行中に実行された COST SQL 文の結果を表示します。結果には、実行ログと最終結果が含まれます。

    リソースマネージャー

    image

    [EXPLORER] の右側の空白部分を右クリックすると、表示モジュールを構成できます。たとえば、[TIMELINE] モジュールを非表示にできます。

    モジュール

    説明

    ファイルリスト

    • 初回アクセス時は、[フォルダが開かれていません] と表示されます。

    • [フォルダを開く] ボタンをクリックして、オンプレミスフォルダを開きます。フォルダを初めて開く際、フォルダの閲覧許可を確認するダイアログボックスが表示されます。

    重要

    システムがオンプレミスフォルダを読み取るたびに、データセキュリティを確保するため、フォルダ内のすべてのファイルへのアクセス許可を手動で付与する必要があります。

    サーバーはフォルダのコンテンツを一切保存しません。

    [COMMONDATASET DEMO]

    • MaxCompute SQL Analysis には、公開データセットに基づくデモクエリファイルが組み込まれています。これらを直接実行するか、一時的に編集して実行できます。ただし、オンラインデモファイル自体は変更できません。ページをリフレッシュすると、ファイル内容は初期状態に戻ります。編集したファイルはローカルマシンに保存してください。

    • 組み込みデモは主に、公開データセットに基づいて編集された SQL スクリプトです。公開データセットはスキーマストレージを使用しているため、スキーマ構文スイッチを有効にするためのスクリプト set odps.namespace.schema=true; がデフォルトで追加されています。

    • 組み込みデモファイルでは、各ファイルに複数の SQL スクリプトが含まれています。スクリプト名の -query の前の数字は、クエリの数を示しています。たとえば、TPC-DS データセットのデモには、異なるデータ量仕様のクエリが 99 個含まれており、実行には計算リソースを消費します。慎重に実行してください。

    タイムライン

    エディターで開いたファイルの操作ログを記録します。ログ情報はキャッシュに保存されます。キャッシュをクリアすると、ログも削除されます。

    検索

    image

    モジュール

    説明

    [検索]

    • リソースマネージャー内のすべてのファイルの内容をグローバルに検索します。たとえば、FROM table_test1 文を含むファイルを検索できます。

    • 検索結果をクリックすると、対応するファイルが右側のエディターで開き、キーワードの位置に直接移動します。

    [置き換え]

    • 検索したキーワードを別の文に置き換えます。

    • たとえば、すべてのファイルで FROM table_test1 文を FROM table_test2 に置き換えるには、[検索] ボックスに FROM table_test1 を入力し、[置換] ボックスに FROM table_test2 を入力して、image ボタンをクリックして置き換えを実行します。

    テーブルデータ

    image

    現在のテナントが属するリージョン内のすべてのプロジェクトのオブジェクト（スキーマ、テーブル、ビュー、リソース、関数など）の一覧を表示します。

    • スコープ：Alibaba Cloud アカウント はすべてのプロジェクトを表示できます。Resource Access Management (RAM) ユーザー は、プロジェクトに追加されている場合にのみ表示できます。

    • SYSTEM_CATALOG プロジェクト：リスト内の SYSTEM_CATALOG プロジェクトは、テナントレベルの Information Schema 用のシステムプロジェクトです。これはシステムによってデフォルトで作成されます。INFORMATION_SCHEMA は、このプロジェクトの "INFORMATION_SCHEMA" スキーマ配下にビューとして配置され、直接表示できます。

    • 表示権限：プロジェクト内のオブジェクト一覧を表示するには、対応するList 権限が必要です。

      テーブルオブジェクトの場合、現在ログイン中のアカウントが SELECT 権限を持っていると、一覧内のテーブルアイコンが緑色のテーブルアイコン image になります。これにより、権限を持つテーブルを素早く識別できます。

    • スキーマレベル：プロジェクトを展開後、プロジェクトにスキーマレベルが存在する場合は、まずスキーマ一覧が表示されます。存在しない場合は、データオブジェクトの分類が直接表示されます。分類をクリックすると、そのタイプのオブジェクト一覧が展開されます。

    • オブジェクトをクリックすると、右側の結果エリアの [メタデータ] タブにそのメタデータの詳細が表示されます。

    公開データセット

    image

    システムが提供する公開データセット のテーブルメタデータ情報を表示します。

    SQL Analysis の使用

    • SQL タスクはプロジェクト内で実行されます。MaxCompute サービスを有効化した後、SQL 分析を実行するにはプロジェクトを作成する必要があります。

    1. MaxCompute コンソール にログインし、左上隅でリージョンを選択します。

    2. MaxCompute プロジェクトの作成

      SQL タスクはプロジェクト内で開始する必要があるため、MaxCompute サービスを有効化した後、SQL 分析機能を使用するにはプロジェクトを作成する必要があります。

    3. 左側のナビゲーションウィンドウで、データ探索 > SQL分析 を選びます。

    4. 「データ探索 → SQL分析」ページで、SQL ファイルを作成します。

      1. SQL Analysis ページを初めて開くと、untitled_x という名前の SQL ファイルがデフォルトで作成・開かれます。このファイルを直接編集できます。

      2. エディターのファイルタブバーの空白部分をダブルクリックして、SQL ファイルを作成します。

      3. エディターのファイルタブバーを右クリックし、[新規ファイル] を選択します。

    5. SQL エディターに SQL を入力した後、右側の [実行構成] をクリックし、[プロジェクト] および [計算クォータ] を構成します。

      • [プロジェクト]: 必須. SQL ステートメントを実行するプロジェクトです。このプロジェクトに対して、CREATE instance 権限が必要です。

      • [計算クォータ]：任意。このパラメーターは、ジョブに使用する計算リソースクォータを指定します。クォータを指定する場合、アカウントがそのクォータに対する USAGE 権限を持っている必要があります。クォータを指定しない場合、SQL 文はプロジェクトに設定されたデフォルトの計算リソースクォータを使用して実行されます。

    6. [実行] をクリックし、クエリの完了を待ちます。実行結果では、image アイコンをクリックして簡単な視覚的分析を実行できます。

      SQL 分析インターフェイスでは、実行結果のダウンロードはサポートされていません。結果をローカルにダウンロードするには、以下の方法を使用してください。

      • MaxCompute クライアント（odpscmd）で SQL タスクを実行し、Tunnel コマンドを使用して結果をローカルにダウンロードします。詳細については、「インスタンスデータのダウンロード」をご参照ください。

      • DataWorks Data Studio の ODPS SQL ノードで SQL タスクを実行し、[エクスポート] ボタンをクリックして結果をローカルコンピューターにダウンロードします。詳細については、「ワークブックのエクスポート、共有、ダウンロード」をご参照ください。

    7. [保存] をクリックして、現在の SQL ファイルをローカルコンピューターに保存します。