使用 Visual Studio Code 建立並執行 Transact SQL 指令碼
適用於:
本文介紹如何為 Visual Studio Code 使用“mssql”擴充套件來開發 SQL Server 資料庫。 由於 Visual Studio Code 是跨平臺的,因此可以在 Linux、macOS 和 Windows 上使用“mssql”擴充套件。
一、安裝並啟動 Visual Studio Code
Visual Studio Code 是支援擴充套件的跨平臺圖形程式碼編輯器。
-
在計算機上下載並安裝 Visual Studio Code。
-
啟動 Visual Studio Code。
備註
如果通過 xrdp 遠端桌面會話連線時 Visual Studio Code 無法啟動,請參閱使用 XRDP 連線時 VS Code 無法在 Ubuntu 上執行。
二、安裝 mssql 擴充套件
適用於 Visual Studio Code 的 mssql 擴充套件
-
在 Visual Studio Code 中,選擇“檢視” > “命令面板”,或按“Ctrl”+“Shift”+“P”,或按“F1”開啟“命令面板”。
-
在命令面板中,從下拉列表中選擇“擴充套件:安裝擴充套件”。
-
在“擴充套件”窗格中,鍵入“mssql”。
-
選擇“SQL Server (mssql)”擴充套件,然後選擇“安裝”。
-
安裝完成後,選擇“重新載入”以啟用擴充套件。
三、建立或開啟 SQL 檔案
當語言模式設定為“SQL”時,mssql 擴充套件將在程式碼編輯器中啟用 mssql 命令和 T-SQL IntelliSense。
-
選擇“檔案” > “新建檔案”或按“Ctrl”+“N”。 預設情況下,Visual Studio Code 將開啟一個新的“純文字”檔案。
-
在下方狀態列上選擇“純文字”,或按“Ctrl”+“K” > “M”,然後從“語言”下拉列表中選擇“SQL”。
備註
如果這是你第一次使用該擴充套件,則該擴充套件會安裝支援性的 SQL Server 工具。
如果開啟一個副檔名為 .sql 的現有檔案,語言模式會自動設定為 SQL。
四、連線到 SQL Server
請按照以下步驟建立連線配置檔案並連線到 SQL Server。
-
按“Ctrl”+“Shift”+“P”或“F1”開啟“命令面板”。
-
鍵入 sql 以顯示 mssql 命令,或鍵入 sqlcon,然後從下拉列表中選擇“MS SQL:連線”。
備註
程式碼編輯器中的焦點須位於 SQL 檔案(例如建立的空 SQL 檔案),才能執行 mssql 命令。
-
選擇“MS SQL:管理連線配置檔案”命令。
-
然後選擇“建立”為 SQL Server 建立新的連線配置檔案。
-
按照提示為新連線配置檔案指定屬性。 指定每個值後,按“Enter”繼續。
連線屬性 說明 伺服器名稱或 ADO 連線字串 指定 SQL Server 例項名稱。 使用 localhost 連線到本地計算機上的 SQL Server 例項。 如果要連線到遠端 SQL Server,請輸入目標 SQL Server 的名稱,或它的 IP 地址。 若要連線到 SQL Server 容器,請指定容器主機的 IP 地址。 如果需要指定埠,請使用逗號將其與名稱分開。 例如,對於偵聽埠 1401 的伺服器,請輸入 <servername or IP>,1401
。
或者,可以在此處輸入資料庫的 ADO 連線字串。“資料庫名稱”(可選) 要使用的資料庫。 若要連線到預設資料庫,請不要在此處指定資料庫名稱。 身份驗證型別 選擇“整合”或“SQL 登入”。 使用者名稱 如果選擇了“SQL 登入”,則輸入擁有訪問伺服器上資料庫許可權的使用者名稱。 密碼 輸入指定使用者的密碼。 儲存密碼 按“Enter”選擇“是”並儲存密碼。 選擇“否”,系統將在每次使用連線配置檔案時提示輸入密碼。 “配置檔名稱”(可選) 鍵入連線配置檔案的名稱,例如 localhost 配置檔案。 輸入所有值並選擇“Enter”後,Visual Studio Code 將建立連線配置檔案並連線到 SQL Server。
提示
如果連線失敗,請嘗試通過 Visual Studio Code “輸出”面板中的錯誤訊息來診斷問題。 要開啟“輸出”面板,請選擇“檢視” > “輸出”。 另外,請檢視連線故障排除建議。
-
在下方的狀態列中驗證連線。
作為前面步驟的替代方法,還可以在“使用者設定”檔案 (settings.json) 中建立和編輯連線配置檔案。 若要開啟設定檔案,請選擇“檔案” > “首選項” > “設定”。 有關詳細資訊,請參閱管理連線配置檔案。
五、建立 SQL 資料庫
-
在先前啟動的新 SQL 檔案中,鍵入 sql 以顯示可編輯的程式碼段的列表。
-
選擇“sqlCreateDatabase”。
-
在程式碼段中,鍵入
TutorialDB
以替換“DatabaseName”:-- Create a new database called 'TutorialDB' -- Connect to the 'master' database to run this snippet USE master GO IF NOT EXISTS ( SELECT name FROM sys.databases WHERE name = N'TutorialDB' ) CREATE DATABASE [TutorialDB] GO
-
按“Ctrl”+“Shift”+“E”執行 Transact - SQL 命令。 在查詢視窗中檢視結果。
提示
可以自定義 mssql 命令的快捷鍵。 請參閱自定義快捷鍵。
六、建立表
-
刪除程式碼編輯器視窗中的內容。
-
按“Ctrl”+“Shift”+“P”或“F1”開啟“命令面板”。
-
鍵入 sql 以顯示 mssql 命令,或鍵入 sqluse,然後選擇“MS SQL:使用資料庫”命令。
-
選擇新的“TutorialDB”資料庫。
-
在程式碼編輯器中,鍵入 sql 以顯示片段,選擇“sqlCreate Table”後按“Enter”。
-
在片段中,鍵入表名
Employees
。 -
按“Tab”鍵轉到下一個欄位,然後鍵入
dbo
作為架構名稱。 -
使用以下列替換列定義:
EmployeesId INT NOT NULL PRIMARY KEY, Name [NVARCHAR](50) NOT NULL, Location [NVARCHAR](50) NOT NULL
-
按“Ctrl”+“Shift”+“E”可建立表。
七、插入和查詢
-
新增下列語句,將四行插入“Employees”表。
-- Insert rows into table 'Employees' INSERT INTO Employees ([EmployeesId],[Name],[Location]) VALUES ( 1, N'Jared', N'Australia'), ( 2, N'Nikita', N'India'), ( 3, N'Tom', N'Germany'), ( 4, N'Jake', N'United States') GO -- Query the total count of employees SELECT COUNT(*) as EmployeeCount FROM dbo.Employees; -- Query all employee information SELECT e.EmployeesId, e.Name, e.Location FROM dbo.Employees as e GO
鍵入時,T-SQL IntelliSense 可幫助你完成語句:
提示
mssql 擴充套件還包含可幫助建立 INSERT 和 SELECT 語句的命令。 前面的示例中未使用這些命令。
-
按“Ctrl”+“Shift”+“E”執行命令。 將在“結果”視窗中顯示兩個結果集。
八、檢視並儲存結果
-
選擇“檢視” > “編輯器佈局” > “翻轉佈局”以切換為垂直拆分或水平拆分的佈局。
-
選擇“結果”和“訊息”面板標頭來摺疊和展開面板。
提示
可以自定義 mssql 擴充套件的預設行為。 請參閱自定義擴充套件選項。
-
選擇第二個結果網格上的最大化網格圖示以放大這些結果。
備註
T-SQL 指令碼產生兩個或多個結果網格時,會出現最大化圖示。
-
右鍵單擊網格,開啟網格上下文選單。
-
選擇“全選”。
-
再次開啟網格上下文選單,選擇“另存為 JSON”將結果儲存到“.json”檔案。
-
為 JSON 檔案指定檔名。
-
驗證 JSON 檔案是否在 Visual Studio Code 中儲存和開啟。
如果以後需要儲存和執行 SQL 指令碼,用於管理用途或更大的開發專案,請使用 .sql 副檔名儲存指令碼。
九、後續步驟
如果不熟悉 T-SQL,請參閱教程:編寫 Transact-SQL 語句和 Transact-SQL 參考(資料庫引擎)。
有關使用 mssql 擴充套件或貢獻相關內容的詳細資訊,請參閱 mssql 擴充套件專案 Wiki。
有關使用 Visual Studio Code 的詳細資訊,請參閱 Visual Studio Code 文件。