共用方式為


快速入門:使用 SQL Server Management Studio (SSMS) 在 Fabric 中連線和查詢 SQL 資料庫

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

開始使用 SQL Server Management Studio (SSMS) 連線到 Microsoft Fabric 中的 SQL 資料庫,並執行一些 Transact-SQL (T-SQL) 命令。

備註

雖然 Microsoft Entra ID 是 Azure Active Directory(Azure AD)的新名稱,但為了防止破壞現有的環境,Azure AD 仍會保留在某些硬式編碼元素中,例如 UI 字段、連線提供者、錯誤碼和 Cmdlet。 在本文中,這兩個名稱是可互換的。

本文示範下列步驟:

  • 連線到 Fabric 中的 SQL 資料庫
  • 在新資料庫中建立資料表
  • 將資料列插入新表格
  • 查詢新表並檢視結果
  • 使用查詢視窗表格來驗證您的連線屬性
  • 移除資料庫

先決條件

連線到 Fabric 中的 SQL 資料庫

備註

18.6 之前的 SSMS 版本不會透過 Microsoft Entra 多重要素驗證 (MFA) 向資料庫引擎進行驗證。 若要繼續使用 MFA,您需要 SSMS 18.6 或更新版本。

  1. 啟動 SQL Server Management Studio (SSMS)。 第一次執行 SSMS 時,會開啟 [ 連線到伺服器 ] 視窗。 如果未開啟,您可以透過手動開啟來選取 物件總管>連線>資料庫引擎

    物件總管中 [連線] 連結的螢幕擷取畫面。

  2. 在 Fabric 入口網站中尋找 SQL 資料庫的 伺服器名稱資料庫名稱

    SQL 資料庫的連接字串類似於 Azure SQL 資料庫的連接字串。 伺服器名稱看起來像是 <server-unique-identifer>.database.windows.net,而資料庫名稱則是 <database name>-<unique identifier>

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

    • 移至 SQL 資料庫專案的設定。 選取 [連接字串]。 伺服器名稱是 ,Data source資料庫名稱是 Initial Catalog

    • 或者,在工作區的項目清單中,選取 ... 功能表。 選取 [設定],然後選取 [連接字串]。

    • 或者,選取 [ 在⋯⋯開啟 ] 按鈕,使用 SQL Server Management Studio。 隨即顯示伺服器連線資訊。

      來自 [開啟方式] 按鈕的 Fabric 入口網站的螢幕擷取畫面。

      SQL Server Management Studio 連線對話方塊 Fabric 入口網站的螢幕擷取畫面,顯示伺服器名稱和資料庫名稱。

  3. 連線 至伺服器 對話方塊隨即出現。 輸入以下信息,所有其他設置都可以保留默認值:

    Setting 建議的值 詳細資訊
    伺服器類型 資料庫引擎 選取 [資料庫引擎] (通常是預設選項)。
    伺服器名稱 完整伺服器名稱 輸入 伺服器名稱,包括 .database.fabric.microsoft.com,1433
    驗證 選擇 Microsoft Entra MFA 如需詳細資訊,請參閱 Microsoft Fabric 中的 SQL 資料庫中的驗證。
    資料庫名稱 提供 SQL 資料庫的資料庫名稱。

    您也可以選取 [選項] 來修改其他連線選項。 連線選項的範例包括您要連線的資料庫、連線逾時值和網路通訊協定。 本文使用所有選項的預設值。

  4. 選擇 連線

  5. 若要確認 Fabric 中的 SQL 資料庫連線成功,請展開並探索物件 總管 內顯示伺服器名稱、SQL Server 版本和使用者名稱的物件。 這些物件會因伺服器類型而異。

解決連接問題

  • 如果您的瀏覽器在搭配 MFA 使用 Microsoft Entra 時無法連線到 SQL Database,您可以流覽至 [工具選項]> [Azure 服務>] [>],然後變更 [使用系統預設網頁瀏覽器] 或 [使用 Web 帳戶管理員] 的值。 如需詳細資訊,請參閱選項 (Azure 服務)。

  • 如果您在 Fabric 中遇到 SQL 資料庫的連線問題,請參閱 瞭解 Microsoft Fabric 中的網路安全性

清除 Microsoft Entra ID 權杖快取

SQL Server Management Studio (SSMS)會短暫快取 Microsoft Entra ID 存取權杖。 將使用者新增至 Microsoft Entra ID 群組並立即嘗試從 SSMS 進行驗證時,會擲回下列錯誤訊息:

Login failed for user '<token-identified principal>'.
(Microsoft SQL Server, Error: 18456)

如果您最近取得伺服器的存取權,您可以從 說明>清除 Entra ID 權杖快取中清除 Microsoft Entra ID 權杖快取。

「說明」功能表的螢幕擷取畫面,其中「清除 Entra ID 權杖快取」選項以紅色反白顯示。

下列對話方塊說明為什麼如果您最近收到伺服器的存取權,並且需要重新驗證,此選項很有用。

要求確認清除 Microsoft Entra ID 使用者權杖快取的對話方塊螢幕擷取畫面。

在新資料庫中建立資料表

在本節中,您會在資料庫中建立資料表。

  1. [物件總管] 的 [資料庫] 清單中,以滑鼠右鍵按一下您的資料庫,然後選取 [新增查詢]:

    螢幕擷取畫面顯示如何建立新查詢。

  2. 將下列 T-SQL 程式碼片段貼到查詢視窗中:

    -- Create a new table called 'Customers' in schema 'dbo'
    -- Drop the table if it already exists
    IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL
        DROP TABLE dbo.Customers;
    GO
    
    -- Create the table in the specified schema
    CREATE TABLE dbo.Customers
    (
        CustomerId INT NOT NULL PRIMARY KEY, -- primary key column
        Name NVARCHAR (50) NOT NULL,
        Location NVARCHAR (50) NOT NULL,
        Email NVARCHAR (50) NOT NULL
    );
    GO
    
  3. 選取 [執行] 或選取鍵盤上的 F5 來執行查詢。

查詢完成之後,新 Customers 表格會顯示在 「物件總管」的表格清單中。 如果未顯示資料表,請以滑鼠右鍵按一下 [物件總管] 中的 >資料表] 節點,然後選取 [重新整理]。

顯示新表格的螢幕擷取畫面。

將列插入新表格

現在讓我們將一些列插入到您建立的表格中 Customers 。 將下列 T-SQL 程式碼片段貼到查詢視窗中,然後選取 [執行]

-- Insert rows into table 'Customers'
INSERT INTO dbo.Customers (
    [CustomerId],
    [Name],
    [Location],
    [Email]
)
VALUES
    (1, N'Orlando', N'Australia', N''),
    (2, N'Keith', N'India', N'keith0@adventure-works.com'),
    (3, N'Donna', N'Germany', N'donna0@adventure-works.com'),
    (4, N'Janet', N'United States', N'janet1@adventure-works.com');
GO

查詢表格並檢視結果

查詢的結果會顯示在查詢文字視窗下方。 若要查詢 Customers 資料表並檢視已插入的資料列,請將下列 T-SQL 程式碼片段貼到查詢視窗中,然後選取 [執行]

-- Select rows from table 'Customers'
SELECT * FROM dbo.Customers;

查詢結果會顯示在輸入文字的區域下方。

顯示結果清單的螢幕擷取畫面。

您也可以選取下列其中一個選項來修改結果的呈現方式:

顯示查詢結果的三個選項的螢幕擷取畫面。

  • 第一個按鈕會在 文字檢視中顯示結果,如下一節的影像所示。
  • 中間按鈕會在 「格線檢視」中顯示結果,這是預設選項。
  • 第三個按鈕可讓您將結果儲存到預設副檔名為 .rpt 的檔案。

使用查詢視窗資料表來驗證您的連線屬性

您可以在查詢結果下找到連線屬性的相關資訊。 在上一個步驟中執行先前提及的查詢之後,請檢閱查詢視窗底部的連線屬性。

  • 您可以確定您連接到哪個伺服器和資料庫,以及您的使用者名稱。

  • 您也可以檢視查詢持續時間,以及先前執行的查詢所傳回的資料列數。

    連線屬性的螢幕擷取畫面。

清理資源

移除我們在本快速入門中建立的範例資料表。 貼上下列 T-SQL 程式碼並 執行

DROP TABLE dbo.Customers;