SQL Server 2005 SQLCMD 工具完整使用指南（互動、腳本、變數、輸出導向）

一、 SQLCMD 簡介

sqlcmd.exe 是 SQL Server 2005 引入的命令列工具，取代 osql/isql，支援：

• 互動式 T-SQL 執行
• 批次腳本檔執行（-i）
• 變數替換（-v / :setvar）
• 輸出導向（-o / :out）
• 伺服器清單列舉（:ServerList）

二、 常用啟動參數

三、 互動模式基本操作

C:\> sqlcmd -E
1> SELECT name FROM sys.databases;
2> GO
-- 執行批次
1> :ServerList
-- 列出網路上可見的 SQL Server
1> :Help
-- 顯示所有內建命令
1> QUIT
-- 離開

四、 執行腳本檔與輸出導向

-- 1. 直接執行腳本，結果輸出螢幕
sqlcmd -E -i deploy.sql

-- 2. 指定輸出檔
sqlcmd -E -i deploy.sql -o deploy.log

-- 3. 互動模式中導向
sqlcmd -E
1> :out results.txt
2> :r deploy.sql
3> GO

五、 腳本變數：外部傳入與內部設定

5.1 外部傳入（-v）

-- deploy.sql
SET NOCOUNT ON;
SELECT $(Cols) FROM $(TableName);

-- 命令列
sqlcmd -E -i deploy.sql -v Cols="name, object_id" TableName="sys.objects"

5.2 內部設定（:setvar）

-- backup_template.sql
USE master;
BACKUP DATABASE [$(db)] TO DISK = '$(file)';

-- backup_msdb.sql
:setvar db msdb
:setvar file C:\Backup\msdb.bak
:r backup_template.sql

5.3 列出目前變數

:Listvar

六、 核心內建命令速查

七、 實務應用場景

• 自動化部署：CI/CD Pipeline 呼叫 sqlcmd -b -i release.sql -o release_$(date).log，失敗即中止並記錄。
• 多環境參數化：同一腳本，透過 -v Env=Prod 切換資料庫名稱、檔案路徑。
• 大量資料匯入：sqlcmd -E -i bulk_insert.sql -h -1 -s "," -w 65535 產生 CSV 格式輸出。
• 健康檢查腳本：定期排程執行 health_check.sql，結果寄送郵件/寫入監控表。

八、 最佳實踐建議

1. 腳本檔儲存為 **UTF-8 with BOM** 或 **Unicode**，避免中文亂碼。
2. 啟用 -b 讓自動化流程能偵測失敗。
3. 變數命名慣例：大寫 + 底線（$(DB_NAME)），提升可讀性。
4. 敏感資訊（密碼）勿寫在腳本，改用 -P 參數或環境變數傳入。
5. 大量資料操作前先 SET NOCOUNT ON 減少網路封包。

1. 上一篇文章： SQL Server 2005 查詢效能優化 50 條黃金法則（索引、鎖定、統計資訊、硬體、T-SQL 寫法全方位）
2. 下一篇文章： T-SQL 分隔字串第 N 片段更新：單一陳述式實作字串分段修改

SQL Server 2005

SQL Server 錯誤 4064：無法開啟使用者預設資料庫，登入失敗解決方案

錯誤訊息 「無法開啟使用者預設資料庫。登入失敗。錯誤 406

SQL Server 索引完整指南：架構、建立、分析與維護

索引核心概念 資料庫索引如同書本目錄，對資料表一或多個欄位值

SQL Server 2005 開啟遠端連線完整圖文教學 (混合驗證、TCP/IP、防火牆)

SQL Server 2005 預設關閉遠端連線、僅允許 W

SQL Server 2005 異地備份三大經典方案深度解析

方案一：服務帳號模式 + 維護計劃（推薦） 利用 SQL S