快速入門:使用 Visual Studio Code 連線和查詢 Azure SQL 資料庫或 Azure SQL 受控執行個體

適用於:Azure SQL 資料庫Azure SQL 受控執行個體

Visual Studio Code 是 Linux、macOS 及 Windows 適用的圖形化程式碼編輯器。 它支援多種擴充功能,包括用於查詢 SQL Server、Azure SQL Database、Azure SQL 受控執行個體、Microsoft Fabric 中的 SQL 資料庫及其他平台的 MSSQL 擴充功能。 在本快速入門中,您將使用 Visual Studio Code 連線至 Azure SQL 資料庫或 Azure SQL 受控執行個體,然後執行 Transact-SQL 陳述式以查詢、插入、更新及刪除資料。

必要條件

安裝 Visual Studio Code

請確定您已經安裝最新版本的 Visual Studio Code。 如需安裝指導,請參閱安裝 Visual Studio Code。

設定 Visual Studio Code

若要設定 Visual Studio Code 以連線到 Azure SQL 資料庫 或 Azure SQL 受控執行個體,您必須根據您的作業系統安裝必要的擴充功能和相依性。 請遵循以下步驟以開始使用您的特定 OS。

Windows

請依照以下步驟載入 MSSQL 擴充功能 :

  1. 開啟 Visual Studio Code。
  2. 開啟 [延伸項目] 窗格(或 Ctrl + Shift + X)。
  3. 搜尋 sql 並安裝 SQL Server (mssql) 延伸項目。

如需更多安裝指引,請參閱 Visual Studio Code 的 MSSQL 擴充功能。

macOS

macOS 需要安裝 OpenSSL,這是 MSSQL 擴充套件所使用的 .NET Core 的前提。 開啟您的終端機,並輸入下列命令以安裝 brew 和 OpenSSL。

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew update
brew install openssl
mkdir -p /usr/local/lib
ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/

Linux(烏班圖)

請依照以下步驟載入 MSSQL 擴充功能 :

  1. 開啟 Visual Studio Code。
  2. 開啟 [延伸項目] 窗格(或 Ctrl + Shift + X)。
  3. 搜尋 sql 並安裝 SQL Server (mssql) 延伸項目。

如需更多安裝指引,請參閱 Visual Studio Code 的 MSSQL 擴充功能。

取得伺服器連線資訊

取得連線到 Azure SQL 資料庫所需的連線資訊。 在後續程序中,您將需要完整的伺服器名稱或主機名稱、資料庫名稱和登入資訊。

  1. 登入 Azure 入口網站。

  2. 巡覽至 [SQL 資料庫] 或 [SQL 受控執行個體] 頁面。

  3. 在 [概觀] 頁面上,針對 SQL Database 檢閱 [伺服器名稱] 旁的完整伺服器名稱,若為 SQL 受控執行個體,則檢閱 [主機] 旁的完整伺服器名稱。 若要複製伺服器名稱或主機名稱,請將滑鼠暫留在其上方,然後選取 [複製] 圖示。

將語言模式設定為 SQL

在 Visual Studio Code 中將語言模式設定為 SQL,以啟用 mssql 命令和 T-SQL IntelliSense。

  1. 開啟新的 Visual Studio Code 視窗。

  2. 按 Ctrl + N。一個新的純文字檔案將隨即開啟。

  3. 選取狀態列右下角的 [純文字]。

  4. 在開啟的 [選取語言模式] 下拉式清單中,選取 [SQL]。

連接到您的資料庫

使用 Visual Studio Code,以建立與伺服器的連線。

重要

在繼續之前,確定您已備妥伺服器和登入資訊。 開始輸入連線設定檔資訊後,如果您將焦點從 Visual Studio Code 移開,就必須重新開始建立設定檔。

  1. 在 Visual Studio Code 中,按 Ctrl+Shift+P (或 F1) 以開啟命令選擇區。

  2. 輸入 connect,然後選擇 [MS SQL:Connect]。

  3. 選取 + 建立連線設定檔。

  4. 請依照提示指定新設定檔的連線屬性。 指定每個值之後,按 Enter 鍵繼續。

    財產 建議的值 說明
    伺服器名稱 完整限定伺服器名稱 類似: <Contoso-server-name>.database.windows.net。
    資料庫名稱 您的資料庫名稱 對於免費層級路徑,請輸入你已經配置好的免費資料庫名稱。 在 Adventure Works 路徑中,輸入包含範例資料表的資料庫,例如 mySampleDatabase。
    驗證 SQL 登入 本教學課程使用 SQL 驗證。
    使用者名稱 [使用者名稱] 建立伺服器時所使用伺服器管理帳戶的使用者名稱。
    密碼 (SQL 登入) 密碼 建立伺服器時所使用伺服器管理帳戶的密碼。
    儲存密碼嗎? [是] 或 [否] 如果您不想要每次都輸入密碼,請選取 [是]。
    輸入此設定檔的名稱 設定檔名稱,例如 mySampleProfile 儲存設定檔可讓您在後續登入時加快連線速度。

    如果成功,系統會顯示通知,表示您的設定檔已建立並已連線。

查詢現有的免費方案資料庫

如果你連接到新的空 Azure SQL Database 免費方案資料庫,請使用這條路徑。

  1. 在編輯器中執行這個查詢:

    SELECT DB_NAME() AS current_database;
    
  2. 確認結果是你設定的免費資料庫名稱,而不是 master 或其他資料庫。 如果不匹配,請先重新連接到預期的資料庫再繼續。

  3. 請依照 MSSQL 首次查詢快速入門中的 建立資料表、插入資料列 和 檢視資料。 這些步驟會在你現有的資料庫中建立 dbo.Authors 並查詢其五個樣本列。 你需要權限才能建立資料表並修改其資料。 跳過那個快速入門的通用步驟「建立資料庫」;CREATE DATABASE Library 不會佈建免費層級資料庫。

  4. 按照快速入門的 「清理資源 」指示,在檢查資料庫和資料表擁有權後,只移除你建立的範例資料表。 別刪除你的免費資料庫。

  5. 追蹤剩餘額度,並檢視 暫停和超額行為。 完成後請中斷查詢編輯器和 物件總管 的連線。 現有連線可以防止閒置時自動暫停;斷線不會恢復已用的使用量。

你可以繼續在同一個資料庫裡建立。 查詢完成並不能確定工作負載相容性,也無法保證未來的使用會維持在免費的使用範圍內。 除非你另行選擇範例資料庫路徑並擁有所需的資料表,否則不要執行以下 Adventure Works 範例。

查詢資料

剩下的查詢、插入、更新和刪除範例使用 Adventure Works,而非空白免費層資料庫的路徑。

執行以下 SELECT Transact-SQL 陳述式來依照類別查詢前 20 項產品。

  1. 在 [編輯器] 視窗中,貼上下列 SQL 查詢。

    SELECT pc.Name AS CategoryName,
        p.name AS ProductName
    FROM [SalesLT].[ProductCategory] pc
    INNER JOIN [SalesLT].[Product] p
        ON pc.ProductCategoryId = p.ProductCategoryId;
    
  2. 按 Ctrl + Shift + E 執行查詢並顯示來自 Product 和 ProductCategory 資料表的結果。

    從 2 個資料表擷取資料的螢幕擷取畫面。

插入資料

執行以下 INSERT Transact-SQL 陳述式在 SalesLT.Product 資料表中加入新產品。

  1. 使用此查詢取代先前的查詢。

    INSERT INTO [SalesLT].[Product] (
        [Name],
        [ProductNumber],
        [Color],
        [ProductCategoryID],
        [StandardCost],
        [ListPrice],
        [SellStartDate]
     )
     VALUES (
        'myNewProduct',
        123456789,
        'NewColor',
        1,
        100,
        100,
        GETDATE()
     );
    
  2. 按 Ctrl + Shift + E 在 Product 資料表中插入新資料列。

更新資料

執行以下 UPDATE Transact-SQL 陳述式更新加入的產品。

  1. 使用此查詢取代先前的查詢:

    UPDATE [SalesLT].[Product]
    SET [ListPrice] = 125
    WHERE Name = 'myNewProduct';
    
  2. 按 Ctrl + Shift + E 在 Product 資料表中更新指定的資料列。

刪除資料

執行以下 DELETE Transact-SQL 陳述式移除新產品。

  1. 使用此查詢取代先前的查詢:

    DELETE FROM [SalesLT].[Product]
    WHERE Name = 'myNewProduct';
    
  2. 按 Ctrl + Shift + E 在 Product 資料表中刪除指定的資料列。