すべてのプロダクト
Search

このプロダクト

    MaxCompute:SQL 分析の使用

    ドキュメントセンター

    MaxCompute:SQL 分析の使用

    最終更新日:Nov 26, 2025

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

    機能概要

    • オンラインで SQL 文を編集・実行できます。また、クエリ結果をチャートで表示・分析することもできます。

    • 組み込みのパブリックデータセットのデモを実行して、MaxCompute の機能を素早く試用・テストできます。

    シナリオ

    • クイックスタート：パブリックデータセットを使用して、MaxCompute のコア機能を素早く試用できます。

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

    SQL 分析インターフェイス

    編集エリア

    image

    モジュール

    説明

    タブバー

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

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

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

    ツールバー

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

    • [停止]：[実行] をクリックすると、[停止] ボタンが表示されます。

    • [保存]：この機能はパブリックプレビュー中であり、ファイルをクラウドに保存することはサポートされていません。ファイルはオンプレミスフォルダにのみ保存できます。ファイルを .sql ファイルとして保存してください。

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

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

    • [SQL スキャン見積もり]：COST SQL 文を実行してコストを見積もります。この文は、SQL 文のデータスキャン量と複雑さを返します。

    エディター

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

    • .sql ファイルに複数の SQL スクリプトが含まれている場合は、すべてのフラグ (SET 文) をファイルの先頭に配置します。フラグはファイル内のすべての SQL スクリプトに適用されます。

    • エディターを全画面モードで開いて、スクリプトの入力と実行、結果の表示ができます。

    実行パラメーター設定エリア

    image

    モジュール

    説明

    プロジェクト

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

    • 現在のアカウントには、選択したプロジェクトに対する create instance 権限が必要です。

    • 最初の実行でプロジェクトを選択します。キャッシュが選択内容を保存します。プロジェクトはいつでも変更できます。

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

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

    • 使用する計算クォータを選択します。このパラメーターはオプションです。

    • クォータを選択する場合、現在のアカウントにはそのクォータに対する usage 権限が必要です。

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

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

    結果エリア

    image

    モジュール

    説明

    問題

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

    メタデータ

    [テーブルデータ] または [パブリックデータセット] でテーブル、リソース、ユーザー定義関数などのオブジェクトを選択すると、そのメタデータの詳細を表示できます。詳細には、基本情報、列情報、DDL 生成、データプレビューが含まれます。

    注意：オブジェクトに対する必要なデータベース権限が必要です。

    [結果]

    スクリプト実行の結果：

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

    • ログ: 各実行のログコンテンツ。

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

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

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

    [SQL スキャン見積もり]

    [SQL スキャン見積もり] のために実行された COST SQL 文の結果を表示します。結果には、実行ログと結果データが含まれます。

    リソースマネージャー

    image

    [リソースマネージャー] の右側の空白領域を右クリックして、表示されるモジュールを設定できます。たとえば、[タイムライン] モジュールを非表示にできます。

    モジュール

    説明

    ファイルリスト

    • ファイルリストに初めてアクセスすると、[フォルダが開かれていません] と表示されます。

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

    重要

    システムがオンプレミスフォルダを読み取ろうとするたびに、データセキュリティを確保するために、フォルダ内のすべてのファイルへのアクセス権限を手動で付与してください。

    フォルダの内容はサーバーに保存されません。

    公開データセット デモ

    • MaxCompute の SQL 分析は、組み込みのパブリックデータセットのデモクエリファイルを提供します。これらを直接実行することも、実行前に編集することもできます。オンラインのデモファイルは変更できません。ページを更新すると、ファイルの内容はリセットされます。変更したファイルはオンプレミスのコンピューターに保存してください。

    • 組み込みのデモには、パブリックデータセットに基づいて編集された 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 プロジェクトは、テナントレベルの Information Schema のためのシステムプロジェクトです。このプロジェクトはシステムによってデフォルトで作成されます。INFORMATION_SCHEMA は、このプロジェクトの "INFORMATION_SCHEMA" スキーマの下にビューとして配置され、直接表示できます。

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

      テーブルオブジェクトの場合、現在のログインアカウントに SELECT 権限があれば、リスト内のテーブルアイコンは緑色のテーブルアイコン image になります。これにより、アクセス権のあるテーブルを素早く識別できます。

    • スキーマレベル：プロジェクトを展開した後、プロジェクトにスキーマレベルがある場合は、まずスキーマリストが表示されます。そうでない場合は、データオブジェクトのカテゴリが直接表示されます。カテゴリをクリックすると、そのタイプのオブジェクトのリストが展開されます。

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

    パブリックデータセット

    image

    このセクションには、システムが提供するパブリックデータセットのテーブルメタデータが表示されます。

    SQL 分析の使用

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

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

    2. MaxCompute プロジェクトを作成します。

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

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

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

      1. SQL 分析ページに初めてアクセスすると、デフォルトで untitled_x という名前の SQL ファイルが作成されて開かれます。このファイルを直接編集できます。

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

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

    5. SQL エディターに SQL 文を入力した後、右側の [実行パラメーター] をクリックします。[プロジェクト] と [計算クォータ] を設定します。

      • [プロジェクト]：必須。SQL 文を実行するプロジェクトです。アカウントに CREATE instance 権限があるプロジェクトを選択する必要があります。

      • [計算クォータ]：オプション。ジョブのクォータです。クォータを指定する場合、アカウントに USAGE 権限があるクォータを選択する必要があります。クォータを指定しない場合、SQL 文はプロジェクトに設定されているデフォルトの計算クォータを使用して実行されます。

    6. [実行] をクリックします。実行結果で、image アイコンをクリックして結果を視覚的に分析します。

      SQL 分析インターフェイスは実行結果のダウンロードをサポートしていません。結果をオンプレミスのコンピューターにダウンロードするには、次のいずれかの方法を使用します。

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

      • DataWorks コンソールのデータ開発ページにある ODPS SQL ノードで SQL タスクを実行します。その後、ページのエクスポートボタンをクリックして、結果をオンプレミスのコンピューターにダウンロードします。詳細については、「ワークブックのエクスポート、共有、ダウンロード」をご参照ください。

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