共用方式為

Microsoft Fabric 筆記本中的 T-SQL 支援

  • 發行項

Microsoft Fabric 中的 T-SQL 筆記本功能可讓您在筆記本中撰寫和執行 T-SQL 程式代碼。 您可以使用 T-SQL 筆記本來管理複雜的查詢，並撰寫更好的 Markdown 檔。 它也允許直接在連線的倉儲或 SQL 分析端點上執行 T-SQL。 藉由將數據倉儲或 SQL 分析端點新增至筆記本，T-SQL 開發人員可以直接在連線的端點上執行查詢。 BI 分析師也可以執行跨資料庫查詢，從多個倉儲和 SQL 分析端點收集見解。

大部分現有的筆記本功能都適用於 T-SQL 筆記本。 其中包括圖表查詢結果、共同撰寫筆記本、排程定期執行，以及觸發 資料整合 管線內的執行。

重要

此功能處於預覽。

在本文中，您將學會如何：

  • 建立 T-SQL 筆記本
  • 將數據倉儲或 SQL 分析端點新增至筆記本
  • 在筆記本中建立和執行 T-SQL 程式代碼
  • 使用圖表功能以圖形方式表示查詢結果
  • 將查詢儲存為檢視或數據表
  • 執行跨倉儲查詢
  • 略過非 T-SQL 程式代碼的執行

建立 T-SQL 筆記本

若要開始使用此體驗，您可以透過下列兩種方式建立 T-SQL 筆記本：

  1. 從數據倉儲首頁建立 T-SQL 筆記本：流覽至數據倉儲體驗，然後選擇 [Notebook]。

    在 DW 首頁中建立 t-sql 筆記本項目的螢幕快照。

  2. 從現有的倉儲編輯器建立 T-SQL 筆記本：流覽至現有的倉儲，從上方導覽功能區選取 [新增 SQL 查詢]，然後選取 [新增 T-SQL 查詢筆記本]

從 DW SQL 編輯器開啟筆記本的螢幕快照。

建立筆記本之後，T-SQL 會設定為默認語言。 您可以將數據倉儲或 SQL 分析端點從目前的工作區新增至筆記本。

將數據倉儲或 SQL 分析端點新增至筆記本

若要將數據倉儲或 SQL 分析端點新增至筆記本，請從筆記本編輯器中選取 [+ 數據源 ] 按鈕，然後選取 [ 倉儲]。 從數據中 樞 面板，選取您要連線的數據倉儲或 SQL 分析端點。

將數據倉儲或 sql 端點新增至筆記本的螢幕快照。

設定主要倉儲

您可以將多個倉儲或 SQL 分析端點新增至筆記本，其中一個會設定為主要。 主要倉儲會執行 T-SQL 程式代碼。 若要設定它，請移至物件總管，選取 倉儲旁邊的 [...] ，然後選擇 [ 設定為主要]。

設定主要倉儲的螢幕快照。

對於任何支援三部分命名的 T-SQL 命令，如果沒有指定任何倉儲，主要倉儲會當做預設倉儲使用。

在筆記本中建立和執行 T-SQL 程式代碼

若要在筆記本中建立和執行 T-SQL 程式代碼，請新增數據格，並將 T-SQL 設定為數據格語言。

顯示如何建立 t-sql 程式代碼儲存格的螢幕快照。

您可以從物件總管的操作選單使用程式碼範本自動產生 T-SQL 程式代碼。 下列範本適用於 T-SQL 筆記本：

  • 選取前100名
  • 建立資料表
  • 建立為選取
  • 卸除
  • 卸除並建立

顯示 t-sql 程式代碼範本的螢幕快照。

您可以選取 資料格工具列中的 [執行 ] 按鈕，或選取 工具列中的 [全部執行 ] 按鈕，以執行一個 T-SQL 程式代碼數據格。

注意

每個程式代碼數據格都會在不同的會話中執行，因此在一個數據格中定義的變數無法在另一個數據格中使用。

在同一個程式代碼數據格內，它可能包含多行程序代碼。 用戶可以選取這些程式代碼的一部分，並只執行選取的程序代碼。 每個執行也會產生新的工作階段。

顯示如何執行選取程式代碼儲存格的螢幕快照。

執行程式代碼之後，展開訊息面板以檢查執行摘要。

顯示執行摘要的螢幕快照。

[數據表] 索引標籤會列出傳回結果集中的記錄。 如果執行包含多個結果集，您可以透過下拉功能表從一個切換到另一個結果集。

顯示如何在結果索引標籤中切換的螢幕快照。

使用圖表功能以圖形方式表示查詢結果

按兩下 [ 檢查] 即可查看圖表，這些圖表代表每個數據行的數據質量與分佈

顯示以圖表表表體檢查結果的螢幕快照。

將查詢儲存為檢視或數據表

您可以使用 [另存新檔] 資料表 功能表，使用 CTAS 命令將查詢的結果儲存到資料表中。 若要使用此功能表，請從程式代碼資料格選取查詢文字，然後選取 [ 另存新檔] 資料表 選單。

顯示如何將查詢儲存為數據表的螢幕快照。

如何將數據表儲存為對話框的螢幕快照。

同樣地，您可以使用資料格命令行中的 [另存新檔] 檢視功能表，從選取的查詢文字 建立檢視 。

顯示如何建立檢視的螢幕快照。

顯示 [另存新檔] 對話框的螢幕快照。

注意

  • 因為 [ 另存新檔] 數據表 和 [另存新檔] 檢視 功能表僅適用於選取的查詢文字，因此您必須先選取查詢文字，才能使用這些功能表。

  • 建立檢視不支援三部分命名，因此檢視一律會在主要倉儲中建立，方法是將倉儲設定為主要倉儲。

跨倉儲查詢

您可以使用三部分命名來執行跨倉儲查詢。 三部分命名是由資料庫名稱、架構名稱和數據表名稱所組成。 資料庫名稱是倉儲或 SQL 分析端點的名稱、架構名稱是架構的名稱，而數據表名稱則是數據表的名稱。

顯示如何執行跨倉儲查詢的螢幕快照。

略過非 T-SQL 程式代碼的執行

在同一個筆記本中，可以建立使用不同語言的程式代碼數據格。 例如，PySpark 程式代碼數據格可以位於 T-SQL 程式代碼數據格之前。 在這種情況下，用戶可以選擇略過 T-SQL 筆記本的任何 PySpark 程式代碼執行。 當您按下 工具列中的 [全部執行 ] 按鈕，即可執行所有程式代碼儲存格時，就會顯示此對話框。

顯示如何略過非 TSQL 程式代碼的螢幕快照。

公開預覽限制

  • T-SQL 筆記本中尚不支持參數數據格。 從管線或排程器傳遞的參數將無法用於 T-SQL 筆記本。
  • T-SQL 筆記本中尚不支援最近的執行功能。 您必須使用目前的數據倉儲監視功能來檢查 T-SQL 筆記本的執行歷程記錄。 如需詳細資訊，請參閱 監視數據倉儲 一文。
  • T-SQL 筆記本中尚未支援管線執行內的監視URL。
  • T-SQL 筆記本中尚不支援快照集功能。
  • T-SQL 筆記本中尚未支援 Git 和部署管線支援。

相關內容

若要了解有關 Fabric 筆記本的詳細資訊，請參閱下列文章。