SQL 分析 - MaxCompute - Alibaba Cloud ドキュメントセンター

MaxComputeには、SQL文の迅速な実行に役立つSQL分析機能があります。このトピックでは、MaxComputeコンソールでSQL分析機能を使用する方法について説明します。

説明

MaxComputeを有効化すると、MaxComputeコンソールでプロジェクトを作成し、SQL解析機能を使用してSQL文をすばやく編集および実行できます。 MaxComputeのSQL Analysis機能を使用して、次の操作を効率的に実行できます。

SQL文を編集して実行し、実行結果をチャートで分析します。
組み込みのパブリックデータセットデモのSQLファイルを開き、コードを実行します。これにより、パブリックデータセットに基づいてMaxComputeを使用およびテストできます。

シナリオ

SQL分析機能は、次のシナリオで使用できます。

MaxComputeを初めて使用してテストする場合は、SQL Analysis機能を使用して、パブリックデータセットに基づいてMaxComputeのコア機能を体験できます。
SQL分析機能を使用して、特定のSQL文を一時的に実行できます。たとえば、この機能を使用して、特定のテーブルのデータを一時的に照会できます。

注意事項

MaxComputeを有効化した直後に、MaxComputeコンソールの [SQL分析] ページに移動できます。ただし、SQL分析機能を使用して、プロジェクトを作成した後にのみSQLジョブを実行できます。
SQL分析 (ベータ) 機能は、クラウドファイルシステムをサポートしていません。この機能により、MaxComputeはローカルファイルディレクトリにアクセスできます。これにより、ローカルSQLファイルを開いて編集できます。 SQLファイルを作成し、オンプレミスマシンに保存することもできます。各SQLファイルの名前の接尾辞は. sqlです。

UI

次の図は、SQL Analysis機能のユーザーインターフェイス (UI) を示しています。

1. 編集セクション

モジュール	説明
タブバー	ファイルタブ。複数のファイルを同時に開くことができます。タブバーの空白領域をダブルクリックすると、`SQL`ファイルをすばやく作成できます。タブバーの空白の領域を右クリックし、[新しいファイル] を選択すると、`SQL`形式以外のファイルを作成できます。たとえば、JSON形式のファイルを作成できます。説明 `SQL`形式でないファイルを作成する場合は、ツールバーを想定どおりに使用するために、ファイルを`SQL`ファイルとして保存する必要があります。
ツールバー	Run: SQLスクリプトを実行します。現在のSQLファイルで特定のコードセグメントを選択し、[実行] をクリックしてコードを実行します。特定のコードセグメントを選択しない場合、SQLファイル内のすべてのコードがデフォルトで実行されます。 Stop: ジョブを停止します。 [実行] をクリックすると、[停止] ボタンが表示されます。 SQL Analysis (ベータ) 機能を使用してジョブを停止することはできません。ジョブを停止する場合は、[ジョブ] ページに移動します。ジョブを停止する方法の詳細については、「ジョブの管理」をご参照ください。 Save: ファイルを保存します。 SQL分析 (ベータ) 機能は、クラウドファイルシステムをサポートしていません。この機能により、オンプレミスマシンにのみファイルを保存できます。ファイルは`SQL`ファイルとして保存する必要があります。 Format: SQLスクリプトをフォーマットします。実行結果: SQLファイル内のSQLスクリプトの実行後に非表示になる結果を表示します。コスト分析: Cost SQLステートメントを実行して、SQLジョブの実行コストを見積もります。 SQLジョブの複雑さと、スキャンするデータレコードの数が返されます。 COST SQL文の詳細については、「COST SQL」をご参照ください。
エディタ	SQLエディター。 SQLエディターで操作を実行する場合は、次の項目に注意してください。スクリプトの最初の行を実行する必要があります。 SQLファイルに複数のSQLスクリプトとSET文が含まれている場合は、SET文がファイルヘッダーに配置されていることを確認してください。 SETステートメントは、ファイル内のすべてのSQLスクリプトに適用されます。 SQLスクリプトの作成、SQLスクリプトの実行、および結果の表示は、全画面モードでSQLエディターで行うことができます。

2. [Paramsの実行] タブ

モジュール

説明

プロジェクト

SQLコードを実行するプロジェクト。 This parameter is required.

Alibaba CloudアカウントにCreateInstance権限があるプロジェクトを指定する必要があります。

SQLコードを初めて実行するときにプロジェクトを指定する必要があります。既定では、指定したプロジェクトは後続の操作に使用されます。このパラメーターの値を変更できます。このパラメーターの値は、すべてのファイルタブで有効になります。

クォータ

使用するコンピューティングクォータ。このパラメーターはオプションです。

このパラメーターを設定する場合、Alibaba CloudアカウントにUsage権限があるコンピューティングクォータを指定する必要があります。このパラメーターを設定しない場合、SQLコードはプロジェクトに設定された既定のコンピューティングクォータで実行されます。このパラメーターの値は、すべてのファイルタブで有効になります。

3. 結果セクション

モジュール	説明
問題	SQLスクリプトを実行する前に、MaxComputeは編集セクションでスクリプトの構文と仕様を自動的に確認します。これにより、スクリプトを実行する前にスクリプトの標準化の問題を特定できます。
メタデータ	[テーブルデータ] または [データセットの管理] ウィンドウで、テーブル、リソース、ユーザー定義関数 (UDF) などのオブジェクトを選択して、オブジェクトのメタデータを表示できます。メタデータには、基本情報、列情報、DDL文が含まれます。オブジェクトのデータをプレビューすることもできます。オブジェクトに対する関連する権限が必要です。詳細は、「MaxCompute権限」をご参照ください。
結果	SQLスクリプトの実行結果。次の結果を表示できます。 Running Records: 現在のファイル内のSQL文が実行されるたびの開始時間のレコード。開始時刻をクリックすると、実行中の各レコードに関する情報を表示できます。ログ: ログは、ファイルのSQLステートメントが実行されるたびに生成されます。 SQL: 実行される特定のSQLコード。結果: 実行結果。分析: 実行結果をチャートで分析できます。
コスト分析	[コスト分析] をクリックした後に返される実行結果。実行結果には実行ログが含まれます。

4. EXPLORERペイン

モジュール	説明
フォルダ	ファイルの一覧を表示します。 SQL Analysis (ベータ) 機能により、MaxComputeはローカルファイルにアクセスできます。 SQL分析ページに初めて移動すると、NO FOLDER OPENEDが表示されます。 [フォルダを開く] をクリックすると、ローカルフォルダを開きます。フォルダを初めて開くと、フォルダを表示する権限を確認するように促すメッセージが表示されます。重要データのセキュリティを確保するには、ページを開いてシステムがローカルフォルダを読み取ろうとするたびに、指定されたフォルダ内のすべてのファイルにアクセスすることをMaxComputeに手動で許可する必要があります。 MaxComputeは、フォルダーのファイルをサーバーに保存しません。
COMMONDATASETデモ	組み込みのパブリックデータセットデモのクエリファイルを表示します。ファイルを直接開いて実行することも、ファイルを一時的に編集してから実行することもできます。ただし、変更したコンテンツは保存できません。変更したコンテンツを保存してページを更新すると、システムはファイルの元のコンテンツを保持します。ファイルの変更された内容をオンプレミスマシンに保存できます。組み込みのデモファイルには、パブリックデータセットに基づいて記述されたSQL文が含まれています。パブリックデータセットはスキーマに格納されます。既定では、`set odps.name space.schema=true;` がSQLスクリプトに追加され、スキーマ構文が有効になります。各組み込みデモファイルには複数のSQLスクリプトが含まれています。スクリプト名の `-query`の前の数は、クエリの数を示します。 TPC-DSデータセットの各デモファイルには99個のクエリがあり、クエリされるデータの量はTPC-DSデータセットの仕様によって異なります。 SQLスクリプトの実行は、コンピューティングリソースを消費し、コンピューティング料金を発生させる。作業は慎重に行ってください。
タイムライン	編集セクションでファイルを開くたびに生成される操作ログを表示します。ログはキャッシュに保存されます。キャッシュをクリアすると、ログは削除されます。
右クリック操作	EXPLORERペインの空白領域を右クリックして操作を実行できます。たとえば、COMMONDATASET DEMOモジュールを非表示にする場合は、空白の領域を右クリックし、[CommonDataSet Demo] をクリックしてモジュールの選択を解除します。

5. 検索セクション

モジュール	説明
検索	EXPLORERペイン内のすべてのファイルのグローバル検索を提供します。たとえば、`from table1`ステートメントを含むファイルを検索できます。キーワードを入力してファイルを検索できます。次に、検索結果をクリックして編集セクションでファイルを開き、キーワードを直接見つけることができます。フォルダーペインでファイルを検索できます。
Replace	検索結果のキーワードを別のキーワードに置き換えることができます。たとえば、すべてのファイルの`from table1`を`from table2`に置き換える場合は、Searchフィールドに`from table1`と入力してファイルを検索し、replaceフィールドに`from table2`と入力し、ボタンをクリックしてファイルのキーワードを置き換えます。
テーブルデータ	リージョン内の現在のテナントのすべてのプロジェクトのオブジェクトを表示します。オブジェクトには、スキーマ、テーブル、ビュー、リソース、および関数が含まれます。すべてのプロジェクトのオブジェクトのリストを表示するには、オブジェクトに対するリスト権限が必要です。テーブルの [選択] 権限がある場合は、テーブル名の左側にアイコンが表示されます。このアイコンは、選択権限を持つテーブルをすばやく識別するのに役立ちます。リスト内のSYSTEM_CATALOGプロジェクトは、テナントレベルの情報スキーマサービスが有効になっているシステムプロジェクトです。システムはデフォルトでプロジェクトを作成します。 INFORMATION_SCHEMAスキーマによって提供されるビューに直接アクセスできます。 Alibaba Cloudアカウントは、すべてのプロジェクトのリストを表示できます。プロジェクトリストでプロジェクトを表示するには、RAMユーザーをプロジェクトに追加する必要があります。プロジェクトをクリックすると、プロジェクト内のオブジェクトを展開できます。プロジェクトにスキーマが含まれている場合、スキーマリストが表示されます。プロジェクトにスキーマが含まれていない場合、データオブジェクトカテゴリが表示されます。各カテゴリをクリックすると、関連するカテゴリの下にあるオブジェクトリストを展開できます。オブジェクトをクリックすると、オブジェクトのメタデータが結果セクションのmetadataタブに表示されます。
データセットの管理	パブリックデータセットのテーブルメタデータを表示します。パブリックデータセットの詳細については、「パブリックデータセットの概要」をご参照ください。

SQL分析機能の使用

MaxComputeコンソールにログインします。ホームページの左上でリージョンを選択します。
左側のナビゲーションウィンドウで、[ワークスペース] > [SQL分析] を選択します。
[SQL分析] ページで、SQLファイルを作成します。
SQL Analysisページに初めて移動すると、デフォルトでuntitled_xという名前のファイルが開きます。 SQLスクリプトをファイルに直接書き込むことができます。タブバーの空白領域をダブルクリックして、SQLファイルを作成することもできます。
SQLエディターでSQLスクリプトを記述し、[パラメーターの実行] タブをクリックします。表示されるパネルで、パラメータを設定します。
- Project: SQLコードが実行されるプロジェクト。 This parameter is required. Alibaba CloudアカウントにCreateInstance権限があるプロジェクトを指定する必要があります。
- クォータ: ジョブに対して指定するコンピューティングクォータ。このパラメーターはオプションです。このパラメーターを設定する場合、Alibaba CloudアカウントにUsage権限があるコンピューティングクォータを指定する必要があります。このパラメーターを設定しない場合、SQLコードはプロジェクトに設定された既定のコンピューティングクォータで実行されます。
[実行] をクリックします。 [結果] タブで、実行結果を表示します。
アイコンをクリックして、視覚化分析を実行できます。
[保存] をクリックして、SQLファイルをオンプレミスマシンに保存します。