共用方式為


在 Microsoft Fabric 中聯機到 SQL 資料庫

適用於:✅Microsoft Fabric 中的 SQL 資料庫

您可以使用與 Azure SQL Database 相同的方式,在 Fabric 中聯機及查詢 SQL 資料庫。

Prerequisites

網狀架構入口網站中的查詢編輯器

您可以使用網狀架構入口網站 中的 Web 編輯器連線到 SQL 資料庫。

Fabric 中 SQL 資料庫的 Web 型編輯器提供基本的物件總管和查詢執行介面。 整合式 瀏覽器 功能表會列出所有資料庫物件。

Fabric 中的新 SQL 資料庫會自動開啟至 Web 編輯器,而現有的資料庫可以在 Web 編輯器中選取它,在 Web 編輯器中加以開啟。

尋找 SQL 連接字串

在 Microsoft Fabric 中,SQL 分析端點和 SQL 資料庫可透過表格式數據流或 TDS 端點存取,而所有與 SQL Server TDS 端點互動的新式 Web 應用程式都熟悉。 這稱為 Microsoft Fabric 使用者介面內的 SQL 連接字串。

SQL 資料庫的連接字串類似於 Azure SQL Database 的連接字串。 <server-unique-identifer>.database.windows.net SQL 分析端點連線字串看起來像 <server-unique-identifier>.<tenant>.fabric.microsoft.com

若要尋找 Fabric SQL 資料庫的 SQL 連接字串:

  • 移至 SQL 資料庫項目的設定。
  • 或者,在項目清單中,選取 ... 功能表。 選取 [設定 ],然後選取 [連接字串]。 網狀架構提供提供者的完整 連接字串,包括 ADO.NET、JDBC、ODBC、PHP 和 Go。
  • 或者,選取 [ 開啟方式 ] 按鈕,然後選取 [SQL Server Management Studio ] 或 [Visual Studio Code]。 隨即顯示伺服器名稱和資料庫名稱。

若要尋找您的 Fabric SQL 資料庫的 SQL 分析端點的連接字串:

  • 移至 SQL 資料庫項目的設定,然後選取 [連接字串]。
  • 或者,選取 ... 功能表,然後選取 [SQL 端點],然後複製 SQL 連接字串

在按鈕中開啟以連線

您可以使用網狀架構入口網站查詢編輯器中的 [開啟 in] 按鈕,輕鬆地連線到 SQL 資料庫。 選擇 SQL Server Management Studio 或使用 Visual Studio Code 的 mssql 擴充功能

Fabric 入口網站查詢編輯器的螢幕擷取畫面,顯示「開啟於」按鈕,以便輕鬆連線至 SSMS 或 VS Code 中的 mssql 擴充功能。

手動與 SQL Server Management Studio 連線

如果您的 SSMS 版本早於 21,按一下 開啟之後,將不支援自動填入連線詳細資訊。您仍然可以透過提供伺服器、資料庫和驗證資訊來手動連線。

SSMS 設定的螢幕快照。

SQL Server Management Studio (SSMS)中:

  1. 從 Fabric 資料庫 工作負載中的工作區,選取您的 SQL 資料庫旁的 ...
  2. 選擇 [設定]
  3. 選取 [連接字串]。 尋找 SQL 資料庫的連接字串,包括 Data Source=。 例如: tcp:<servername>.database.fabric.microsoft.com,1433Initial Catalog=是資料庫名稱。
  4. 在 SSMS 中,開啟 [新增連線]。
  5. 從 [網狀架構] 對話框,將 值 Server Name 從 複製並貼到 [伺服器名稱]。
  6. 選擇 驗證 類型: Microsoft Entra ID - Universal with MFA support
  7. 選取 選項<<
  8. 將 值 Database Name 從 複製並貼到 [ 連接到資料庫 ] 文字框中。
  9. 選擇 連線
  10. 使用 Microsoft Entra ID - Universal 搭配 MFA 支援登入。

手動使用 Visual Studio Code 的 MSSQL 擴充功能進行連線

您也可以在 VS Code 的 MSSQL 延伸模組中使用 Fabric 瀏覽體驗。 這項功能讓開發人員可以無縫連接到他們在 Fabric 或 SQL 分析端點中的 SQL 資料庫,而不必手動從 Fabric 入口網站複製連接字串,或依賴 [開啟於] 按鈕直接在 VS Code 中連接到資料庫。

VS Code 連線設定的螢幕擷取畫面。

使用 sqlcmd 連線

您可以使用 sqlcmd 連線到 Fabric 中的 SQL 資料庫,就像任何其他 SQL Database 引擎產品一樣。 搭配使用 Microsoft Entra ID 驗證。 Microsoft Entra 驗證 (-G) 至少需要 13.1 版。

在下列範例中,將 取代 <server name> 為在 Fabric 中代表 SQL 資料庫的唯一文字長字串。

sqlcmd -S <your_server>.database.fabric.microsoft.com;1433 -G -d <your_database> -i ./script.sql

使用 bcp 公用程式連線

您可以使用 bcp 公用程式連線到 Fabric 中的 SQL 資料庫,就像任何其他 SQL Database Engine 產品一樣。 搭配 選項使用 Microsoft Entra ID 驗證 -G

在下列範例中,將 取代 <server name> 為在 Fabric 中代表 SQL 資料庫的唯一文字長字串。

bcp bcptest in "c:\temp\sample.dat" -S <your_server>.database.fabric.microsoft.com;1433 -d testdb -G -c

使用 Python Notebook 連線

Fabric Python Notebooks (預覽版) 提供使用 T-SQL magic 命令執行 T-SQL 程式代碼的功能

在下列步驟中,使用 %%tsql magic 命令連線到 Fabric 中的 SQL 資料庫:

  1. 在工作區中建立筆記本,並將語言設定為 Python。

  2. 在儲存格中使用 %%tsql magic 指令。 儲存格型態會自動變更為 T-SQL

    在下列範例中,將 <databasename> 替換為 Fabric 中的 SQL 資料庫名稱。 參數 -type 應該是 SQLDatabase

    %%tsql -artifact <databasename> -type SQLDatabase
    

    然後包含您的 T-SQL 命令。 例如,若要從名為 Contoso的資料庫執行查詢:

    %%tsql -artifact Contoso -type SQLDatabase
    SELECT * FROM SalesLT.Customer;
    
  3. 您也可以使用 -bind 自變數將結果系結至資料框架:

    %%tsql -artifact Contoso -type SQLDatabase -bind df2
    

如需在 Python Notebook 中使用 T-SQL 查詢數據的可能性,請參閱 在 Fabric Python 筆記本中執行 T-SQL 程式代碼。 若要查看完整的語法,請使用 %tsql? 命令。 此命令會顯示 T-SQL magic 命令的說明資訊,包括可用的參數及其描述。