管理Notebook單元 - Dataphin

Notebook單元是Notebook中用於構建內容的基本組件。通過向Notebook中添加單元，您可以建立和組織內容。不同類型的單元支援不同的操作和功能。本文將為您介紹各單元的使用情境和支援的管理操作。

背景資訊

當前Markdown單元中支援的Markdown文法，詳情請參見https://www.markdownguide.org/extended-syntax/、https://www.markdownguide.org/basic-syntax/。

以下文法暫不支援：

html
Definition Lists
emoji
highlight
SubScript
Superscript

Markdown單元

Markdown支援您使用標準的Markdown文法為Notebook添加常值內容。

地區

說明

①操作區

單擊選中添加的Markdown單元後，您可在操作區對Markdown單元進行管理。包括切換單元、在當前單元下添加單元、複製單元、向上移動單元、向下移動單元以及刪除單元操作。

切換單元：切換當前Markdown單元為其他單元。例如Markdown單元、SQL單元、資料庫SQL單元。
添加單元：在當前Markdown單元下添加其他單元。例如Markdown單元、SQL單元、資料庫SQL單元。
複製單元：在當前Markdown單元下複製一個相同內容的Markdown單元。
移動單元：移動當前Markdown單元位置。支援向上和向下移動。
刪除單元：刪除當前Markdown單元。

②編輯區

在編輯區您可使用Markdown文法開發Notebook內容。Markdown文法，請參考Markdown文法。

SQL單元

SQL單元支援您使用SQL文法在Notebook中添加計算引擎SQL並運行。

說明

Hadoop類型計算引擎下的Spark SQL單元，在建立暫存資料表時將使用管理中心 > 系統設定 > 研發平台 > 表管理設定中的預設儲存格式。

例如：表管理設定中預設儲存格式為hudi，則建立暫存資料表時增加using hudi語句；表管理設定中預設儲存格式為引擎預設，則建立暫存資料表時將不限定儲存格式。

地區

說明

①操作區

單擊選中SQL單元後，您可以在操作區對SQL單元進行管理。包括運行SQL代碼、查詢加速、收合單元、格式化SQL、切換單元、添加單元、複製單元、移動單元、刪除單元。

運行：運行當前SQL單元中的SQL代碼。
查詢加速：MAXCOMPUTE_SQL、HIVE_SQL、IMPALA_SQL、SPARK_SQL單元支援查詢加速。開啟查詢加速後，需選擇加速方式。
- 加速源：通過加速源進行查詢加速，加速方式選擇為加速源時，還需要選擇加速源和資源群組。
  - 加速源：可選擇當前專案計算源所綁定的加速源，若無可用加速源，可單擊建立加速源，跳轉至建立加速源頁面按需建立加速源。
  - 資源群組（非必選）：可選擇所選加速源下已配置的資源群組。
  說明
  - 加速方式選擇加速源，運行時將按照所選加速源類型的文法來運行，需確保SQL語句符合文法規範。例如，所選加速源類型為StarRocks，則運行此即席查詢任務時，將按照StarRocks文法來運行。
  - 使用加速源進行查詢加速時，將不會為每一個查詢建立暫存資料表。
- MCQA：即MaxCompute MCQA加速查詢。MCQA每一個租戶下，作業數量與並發數有限制，可能會導致加速失敗、執行報錯，詳情請參見查詢加速（MCQA）。您可在管理中心 > 系統設定 > 研發平台 > 查詢加速中禁用MCQA加速。
不同計算引擎的不同情況下，支援的加速方式不同。
當前租戶使用MaxCompute計算引擎時：
- 若未購買查詢加速，且已開啟研發平台-查詢加速時，此處加速方式為MCQA。
- 若已購買查詢加速、已開啟研發平台-查詢加速、且當前專案對應的計算源未綁定加速源時，此處加速方式為MCQA。
- 若已購買查詢加速，且專案對應的計算源已綁定加速源，此處加速方式可選擇加速源或MCQA。
當前租戶使用Hadoop計算引擎時：已購買查詢加速，且專案計算源對應的叢集已綁定加速源，此處加速方式為加速源。
收合單元：收合當前SQL單元的代碼地區。
格式化SQL：格式化當前SQL單元中的SQL代碼。
切換單元：切換當前SQL單元為其他單元。例如，Markdown單元、SQL單元、資料庫SQL單元。
說明
計算引擎綁定了開啟Impala的Hive時，支援Impala SQL和Hive SQL相互切換。
添加單元：在當前SQL單元下添加其他單元。如Markdown單元、SQL單元、據庫SQL單元。
複製單元：在當前SQL單元下複製一個相同內容的SQL單元。
移動單元：移動當前SQL單元位置。支援向上和向下移動。
刪除單元：刪除當前SQL單元。

②編輯區

您可以在編輯區內進行計算引擎SQL開發。

資料庫SQL單元

資料庫SQL單元支援您使用SQL文法在Notebook中添加資料庫SQL並運行。

地區

說明

①操作區

單擊選中資料庫SQL單元後，您可以在操作區對資料庫SQL單元進行管理。包括運行資料庫SQL代碼、收合單元、格式化SQL、切換單元、添加單元、複製單元、移動單元、刪除單元。

運行：運行當前資料庫SQL單元中的SQL代碼。
說明
資料庫SQL運行時預設使用所選資料來源中配置的預設資源群組，而非分析專案的預設資源群組。
收合單元：收合當前資料庫SQL單元的代碼地區。
格式化SQL：格式化當前資料庫SQL單元中的SQL代碼。
切換單元：切換當前資料庫SQL單元為其他單元。例如，Markdown單元、SQL單元、資料庫SQL單元。
添加單元：在當前資料庫SQL單元下添加其他單元。如Markdown單元、SQL單元、資料庫SQL單元。資料庫SQL單元支援選擇MySQL、AnalyticDB for PostgreSQL、AnalyticDB for MySQL2.0、AnalyticDB for MySQL3.0、Oracle、Presto、PostgreSQL、StarRocks、ClickHouse、GaussDB（DWS）、Doris、SelectDB、Microsoft SQL Server、Hologres、openGauss、DM、OceanBase、Trino、PolarDB-X2.0。
複製單元：在當前資料庫SQL單元下複製一個相同內容的資料庫SQL單元。
移動單元：移動當前資料庫SQL單元位置。支援向上和向下移動。
刪除單元：刪除當前資料庫SQL單元。
選擇資料來源：選擇用於執行SQL代碼的資料來源（包括外部資料源）。
Catalog：Presto、Trino資料來源需要選擇Catalog。
Database/Schema：AnalyticDB for PostgreSQL、Oracle、Presto、GaussDB（DWS）、Microsoft SQL Server、Hologres、openGauss、DM、OceanBase（Oracle租戶模式）、Trino、PolarDB-X2.0資料來源需要選擇Database/Schema。

②編輯區

您可以在編輯區內進行資料庫SQL開發。

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

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

對象名稱：無權限物件的對象名稱。
物件類型：表和全域變數。
權限類別型：本次運行指令碼中所需要的許可權，其中資料來源表只有查表資料許可權；資料來源只有執行許可權。
操作：若檢查對象失敗，您可以針對單個或多個對象進行許可權申請。
- 單個對象許可權申請：單擊目標對象操作列的表徵圖，申請該對象許可權點的個人許可權，預設有效期間為30天。
- 批量許可權申請：選中多個對象或選中全選表後單擊許可權申請。
申請許可權具體操作，請參見申請許可權。獲得許可權後可重新運行。
說明
僅MySQL、Oracle類型的資料來源，支援資料來源的表級許可權管控。