如何通過SQL分析快速編輯並執行SQL - MaxCompute

本文介紹如何通過MaxCompute控制台的SQL分析功能，進行SQL語句的線上編輯、執行與結果分析。

重要

為適應雲原生技術演化、滿足日益複雜的資料分析需求，阿里雲MaxCompute控制台SQL分析功能全新升級，現已實現全地區支援。更多功能介紹和啟用方法請參見使用SQL分析（新版）串連。

同時，SQL分析舊版功能入口將在北京時間2026年3月31日關閉。請注意及時清理舊版工作區中的本地檔案，推薦手動移動至SQL分析新版個人目錄以便後續編輯使用。

功能概述

支援線上編輯與執行SQL語句，並可對查詢結果進行圖表化展示與分析。
內建公用資料集Demo，可直接運行以快速體驗和測試MaxCompute功能。

使用情境

快速體驗：基於公開資料集快速體驗MaxCompute的核心功能。
臨時測試：臨時運行SQL命令，例如：查看錶資料。

SQL分析介面

編輯區

模組	說明
標籤欄	檔案標籤，可以同時開啟多個檔案。滑鼠左鍵雙擊標籤空白處可以快速建立`.sql`檔案。標籤欄空白處右鍵後選擇建立檔案。
工具列	運行：執行SQL指令碼，您可以選中當前檔案中的某段SQL指令碼運行，如果不選擇，預設執行當前檔案內所有SQL指令碼。停止：單擊運行後，出現停止按鈕。儲存：當前公測版本暫時無雲上檔案儲存體能力，僅支援儲存到本地。請儲存為`.sql`檔案。格式化：格式化當前檔案內的SQL代碼。運行結果：如果當前檔案執行過SQL指令碼，且結果區被隱藏，可以通過此按鈕顯示結果區。 SQL掃描預估：執行COST SQL語句進行計量預估，返回SQL語句的掃描量和複雜度。
編輯器	指令碼首行需要是正常參與啟動並執行指令碼。當一個`.sql`檔案包含多個SQL指令碼的情況下，如果有Flag（SET語句）需要統一放在頭部，且Flag會作用於該檔案中的所有SQL。支援全螢幕模式開啟輸入、執行並查看結果。

運行參數配置區

模組	說明
專案	選擇需要運行SQL代碼的專案，必選項。所選專案需要當前帳號對其有`create instance`許可權。首次運行需要選擇專案，之後緩衝會記錄上一次選擇的專案，可以隨時更換。選擇之後對所有檔案標籤頁生效。
計算配額	選擇需要使用的計算配額（Quota），非必選。如果選擇，需要選擇當前帳號有`usage`許可權的Quota；如果不選擇，則使用所選專案的預設計算Quota。選擇之後對所有檔案標籤頁生效。

結果區

模組	說明
問題	指令碼執行前自動校正編輯區所有開啟的檔案指令碼的文法和規範。
中繼資料	選中表資料或公開資料集中的對象（表、資源或自訂函數），展示相應的中繼資料詳情，包括但不限於對象的基礎資訊、列資訊、產生DDL、資料預覽等。注意需要對應對象的相關資料許可權。
結果	執行指令碼的結果：運行列表：當前檔案每個SQL執行一次就會有一個開始時間記錄。可以通過此處單擊選擇查看每次啟動並執行相關資訊。日誌：每次執行的日誌內容。 SQL：每次啟動並執行具體SQL代碼。結果清單：如果有展示的結果會在此展示。分析：如果有結果，可以在此進行簡單的圖表分析。
SQL掃描預估	展示SQL掃描預估時執行的COST SQL語句結果，包含執行日誌和結果。

資源管理員

資源管理員右側空白處右鍵，可以配置資源管理員的展示模組，比如隱藏時間軸模組。

模組	說明
檔案清單	首次訪問時顯示無開啟的檔案夾。單擊開啟檔案夾按鈕，開啟本地檔案夾，首次開啟會有彈框讓您確認查看檔案夾許可權。重要每次系統嘗試讀取本地檔案夾時，都需要手動授予檔案夾下全部檔案的存取權限以保障資料安全。同時不會在伺服器中儲存檔案夾下的任何內容。
公開資料集DEMO	MaxCompute SQL分析內建的公開資料集Demo Query檔案，可以直接運行或臨時編輯後運行，但不支援修改線上Demo檔案，在重新整理頁面後檔案內容會回到初始狀態，請自行儲存修改後的檔案至本地。內建的Demo主要基於公開資料集編輯的SQL，公用資料集都是採用Schema儲存，因此指令碼會預設加上`set odps.namespace.schema=true;` 開啟Schema文法開關。內建的Demo檔案中，每個檔案包含多個SQL指令碼，指令碼名中`-query`前的數字即為Query個數，特別是TPC-DS資料集的Demo，每個檔案包含99個Query，分為不同資料量規格，執行會消耗計算資源，請謹慎操作。
時間軸	記錄編輯區開啟檔案的動作記錄，日誌資訊儲存在緩衝中，清理緩衝後日誌會被清空。

搜尋

模組	說明
搜尋	資源管理員中所有檔案內容的全域搜尋，例如搜尋哪些檔案含有FROM table_test1語句。單擊搜尋結果即可將對應檔案在右側編輯區開啟並直接定位到此關鍵字的位置。
替換	將搜尋到的關鍵字替換成其他語句。例如將所有檔案中`FROM table_test1`語句替換為`FROM table_test2`，即在搜尋框裡輸入`FROM table_test1`搜尋，替換框裡輸入`FROM table_test2`，單擊按鈕進行替換。

表資料

展示當前租戶在Region下所有Project的對象列表，包括Schema、Tables、Views、Resources、Functions等。

展示範圍：阿里雲帳號可以查看所有專案列表，RAM使用者需要被添加至專案中才能查看對應專案。
SYSTEM_CATALOG專案：列表中的SYSTEM_CATALOG專案目前主要為租戶層級Information Schema所屬的系統專案，由系統預設建立，INFORMATION SCHEMA通過View形式置於該專案的“INFORMATION_SCHEMA”Schema下，可直接查看。
查看許可權：查看專案內的對象列表需要有對應的List許可權
對於Table對象，如果當前登入賬戶有SELECT許可權，則對應Table列表的表徵圖為綠色的表格表徵圖，以此快速分辨有許可權的表。
Schema層級：點擊專案展開後，如果專案有Schema層級，將會先展示Schema列表；若沒有，則直接展示資料對象分類，點擊各項分類展開對應類型下的對象列表。
點擊某個對象，會在右側結果區的中繼資料頁簽展示該對象的中繼資料詳情。

公開資料集

展示系統提供的公開資料集的表中繼資料資訊。

使用SQL分析

由於執行SQL作業需要在專案裡發起，因此，在開通MaxCompute服務後，需先建立專案才能進行SQL分析。

登入MaxCompute控制台，在左上方選擇地區。
建立MaxCompute專案
由於執行SQL作業需要在專案裡發起，因此，在開通MaxCompute服務後，需先建立專案才能使用SQL分析功能。
在左側導覽列，選擇数据探索 > SQL分析。
在数据探索SQL分析頁面，建立SQL檔案。
1. 首次訪問SQL分析時，預設會建立並開啟一個名為untitled_x的SQL檔案，可以直接編輯。
2. 在編輯區檔案標籤欄空白處雙擊建立SQL檔案。
3. 在編輯區檔案標籤欄右鍵建立檔案。
在SQL代碼編輯框輸入SQL後，單擊右側運行參數，配置專案和計算配額。
- 專案：必選，指定該SQL在哪個專案內執行。因此需要選擇當前帳號有CREATE instance許可權的專案。
- 計算配額：非必選，即實現作業層級指定Quota。如果指定Quota，則需要選擇當前帳號有USAGE許可權的Quota；如果不選擇，則SQL會在專案配置的預設計算Quota裡執行。
單擊運行，等待查詢結果。在運行結果處單擊表徵圖，可以實現運行結果的簡單可視化分析。
SQL分析介面不支援下載執行結果，若需要將結果下載至本地，可使用以下方法：
- 在MaxCompute用戶端（odpscmd）中執行該SQL任務，然後通過Tunnel命令將結果下載至本地。詳情請參見下載Instance資料。
- 在DataWorks資料開發介面的ODPS SQL節點中執行該SQL任務，然後通過介面的匯出按鈕將結果下載至本地。詳情請參見匯出、分享和下載試算表。
單擊儲存，將當前SQL檔案儲存到本地。