Dataphin：建立SQL查詢

操作步驟

1. 在Dataphin首頁，在頂部功能表列選擇分析 > SQL查詢。

2. 在SQL查詢列表中，單擊建立表徵圖。

3. 在建立SQL查詢對話方塊，配置以下參數。

   參數	說明
   SQL查詢名稱	允許最長字元256個，不支援豎線（｜）、正斜線（/）、反斜線（\）、半形冒號（:）、半形問號（?）、角括弧（<>）、星號（*）和半形引號（"）。
   目錄位置	選擇任務所存放的目錄。 若未建立目錄，可單擊SQL查詢列表上的表徵圖來建立檔案夾。建立檔案夾對話方塊中，輸入檔案夾名稱並選擇目錄所在位置後，單擊確定。
   查詢資料	支援專案資料和資料來源。 專案資料：即查詢當前專案計算源的資料。 資料來源：即查詢資料來源的資料，支援的資料來源類型請參見分析平台支援的資料來源。查詢資料來源資料還需要進行以下配置： 資料來源：選擇對應資料來源（包括外部資料源）。若無可選資料來源，可以單擊+建立資料來源進行建立。更多資訊，請參見資料來源管理。 Catalog：Presto、Trino資料來源需要選擇對應的Catalog。 Database/Schema：MySQL、PostgreSQL、Hologres、AnalyticDB for PostgreSQL、OceanBase（Oracle租戶模式）、Lindorm、Oracle、ClickHouse、DM、openGauss、StarRocks、Doris、SelectDB、Presto、GaussDB（DWS）、Trino、PolarDB-X2.0、OushuDB、TDSQL for MySQL、TDSQL for PostgreSQL資料來源需要選擇對應的Database/Schema。

4. 單擊確定，完成SQL查詢建立。預設開啟該SQL查詢的代碼編輯頁簽。

   在代碼編輯頁簽下，可以進行資料庫SQL開發。

5. （可選）您可配置並開啟查詢加速，開啟後需選擇加速方式。

   加速源：通過加速源進行查詢加速，加速方式選擇為加速源時，還需要選擇加速源和資源群組。

   • 加速源：可選擇當前專案計算源所綁定的加速源，若無可用加速源，可單擊建立加速源，跳轉至建立加速源頁面按需建立加速源。

   • 資源群組（非必選）：可選擇所選加速源下已配置的資源群組。

   說明

   加速方式選擇加速源，運行時將按照所選加速源類型的文法來運行，需確保SQL語句符合文法規範。例如，所選加速源類型為StarRocks，則運行此SQL查詢任務時，將按照StarRocks文法來運行。

   MCQA：即MaxCompute MCQA加速查詢。MCQA每一個租戶下，作業數量與並發數有限制，可能會導致加速失敗、執行報錯，詳情請參見查詢加速（MCQA）。您可在管理中心 > 系統設定 > 研發平台 > 查詢加速中禁用MCQA加速。

   不同計算引擎的不同情況下，支援的加速方式不同。

   當前租戶使用MaxCompute計算引擎時：

   • 若未購買資料查詢加速，且已開啟研發平台-查詢加速時，此處加速方式為MCQA。

   • 若已購買資料查詢加速、已開啟研發平台-查詢加速、且當前專案對應的計算源未綁定加速源時，此處加速方式為MCQA。

   • 若已購買資料查詢加速，且專案對應的計算源已綁定加速源，此處加速方式可選擇加速源或MCQA。

   當前租戶使用Hadoop計算引擎時：已購買查詢加速，且專案計算源對應的叢集已綁定加速源，此處加速方式為加速源。

6. 資料庫SQL代碼編輯完成後，可單擊運行，系統將解析代碼中所有對象確認目前使用者是否具備對象的操作許可權。若許可權校正成功，說明當前操作使用者具備檢查對象的相應許可權；若許可權校正失敗，則表明當前操作使用者不具備對應對象的許可權，並在許可權校正失敗對話方塊中展示相應的無權限物件列表。

   說明

   資料庫SQL查詢任務運行時預設使用所選資料來源中配置的預設資源群組，而非分析專案的預設資源群組。

   許可權校正失敗對話方塊中將展示對象名稱、物件類型、權限類別型和操作資訊。

   • 對象名稱：無權限物件的對象名稱。

   • 物件類型：表和全域變數。

   • 權限類別型：本次運行指令碼中所需要的許可權，其中資料來源表只有查表資料許可權；資料來源只有執行許可權。

   • 操作：若檢查對象失敗，您可以針對單個或多個對象進行許可權申請。

     • 單個對象許可權申請：單擊目標對象操作列的表徵圖，申請該對象許可權點的個人許可權，預設有效期間為30天。

     • 批量許可權申請：選中多個對象或選中全選表後單擊許可權申請。

     申請許可權具體操作，請參見申請許可權。獲得許可權後可重新運行。

     說明

     僅MySQL、Oracle類型的資料來源，支援資料來源的表級許可權管控。

單租戶多引擎

在多引擎模式下建立SQL查詢時，查詢資料若選擇為專案資料，則還需選擇執行專案，執行專案中需選擇叢集和專案。其他參數同單引擎模式，詳情請參見上文。

• 叢集：可選項中包含當前租戶下所有叢集以及無叢集專案。SQL查詢建立完成後，不支援切換叢集。

• 專案：可選項中包含所選叢集下的專案和叢集的分析專用專案。叢集分析專用項名稱固定為{叢集名稱}分析專案；無叢集專案分析專用專案名稱為無叢集獨立分析專案。

執行專案選擇完成後，系統將根據所選叢集建立對應的引擎類型SQL，二者對應關係如下。