SQLServer知识：sqlcmd用法笔记

今天给大家介绍sqlcmd用法笔记，希望对大家能有所帮助！

1、介绍

sqlcmd是一个 Microsoft Win32 命令提示实用工具，可以通过该命令工具实现SQL语句、脚本的执行，并且可以实现脚本任务的自动化。

2、使用场景

2.1 针对大文件脚本的执行

脚本文件如果超过80兆，是不能够直接在查询编辑器执行的，会直接溢出报错，当然如果你的脚本文件超过几十兆，很有可能会造成SQLServer查询编辑器卡死、无响应。这个问题可以使用sqlcmd命令来解决。

2.2 确保系统部署的稳定、准确

我们在进行系统部署的时候，由于业务逻辑的调整，经常会有好几十个脚本文件需要执行，为了保证脚本执行不出差错，可以通过sqlcmd命令。来进行脚本文件到线上环境的部署。这样可以提高系统部署的质量、准确。

3、sqlcmd参数详解

3.1 语法格式

[{ { -U login_id [ -P password ] } | –E trusted connection }]

[ -N encrypt connection ][ -C trust the server certificate ]

[ -z new password ] [ -Z new password and exit]

[ -S [protocol:]server[\instance_name][,port] ] [ -H wksta_name ] [ -d db_name ]

[ -l login time_out ] [ -A dedicated admin connection]

[ -i input_file ] [ -o output_file ]

[ -f < codepage > | i: < codepage > [ < , o: < codepage > ] ]

[ -u unicode output] [ -r [ 0 | 1 ] msgs to stderr ]

[ -R use client regional settings]

[ -q "cmdline query" ] [ -Q "cmdline query" and exit]

[ -e echo input ] [ -t query time_out ]

[ -I enable Quoted Identifiers ]

[ -v var = "value"...] [ -x disable variable substitution ]

[ -h headers ][ -s col_separator ] [ -w column_width ]

[ -W remove trailing spaces ]

[ -k [ 1 | 2 ] remove[replace] control characters ]

[ -y display_width ] [-Y display_width ]

[ -b on error batch abort] [ -V severitylevel ] [ -m error_level ]

[ -a packet_size ][ -c cmd_end ]

[ -L [ c ] list servers[clean output] ]

[ -p [ 1 ] print statistics[colon format]]

[ -X [ 1 ] ] disable commands, startup script, enviroment variables [and exit]

[ -? show syntax summary]

3.2 参数说明

登录相关选项

-A

使用专用管理员连接 (DAC) 登录 SQL Server。此类型连接用于排除服务器故障。此连接仅适用于支持 DAC 的服务器计算机。如果 DAC 不可用，sqlcmd 会生成错误消息并退出。-A 选项和-G 选项不支持同时使用。

-C

该开关供客户端用于将其配置为隐式表示信任服务器证书且无需验证。此选项等价于 ADO.NET 选项 trustservercertificate = true。

-d db_name

启动 sqlcmd 时会发出一个 USE db_name 语句用来指定要操作的数据库名称。此选项用来设置 sqlcmd 脚本变量 SQLCMDDBNAME。此参数指定初始数据库。默认为您的登录名的默认数据库属性。如果数据库不存在，则生成错误消息且 sqlcmd退出。

-l login_timeout

指定在你尝试连接到服务器时 sqlcmd 登录 ODBC 驱动程序的超时时间（以秒为单位）。此选项设置 sqlcmd 脚本变量 SQLCMDLOGINTIMEOUT。登录到 sqlcmd 的默认超时时间为 8 秒。当使用 -G 选项连接到 SQL 数据库或 SQL 数据仓库并使用 Azure Active Directory 进行身份验证时，建议超时值至少为 30 秒。登录超时必须是介于 0 和 65534 之间的数字。如果提供的值不是数值或不在此范围内， sqlcmd 将生成错误消息。当值设置为 0 时，则允许无限制等待。

-E

使用信任连接而不是用户名和密码登录 SQL Server服务。默认情况下，如果未指定 -E ， sqlcmd 将使用信任连接选项。

-E 选项会忽略可能的用户名和密码环境变量设置，例如 sqlcmdpassword。如果将 -E 选项与 -U 选项或 -P 选项一起使用，将生成错误消息。

-g

将列加密设置设为 Enabled。有关详细信息，请参阅 Always Encrypted。仅支持存储在 Windows 证书存储中的主密钥。-g 开关至少需要 sqlcmd 版本 13.1。若要确定你的版本，请执行 sqlcmd -?。

-G

当连接到 SQL 数据库或 SQL 数据仓库时，客户端将使用此开关指定该用户使用 Azure Active Directory 身份验证来进行身份验证。此选项设置 sqlcmd 脚本变量 SQLCMDUSEAAD = true。-G 开关至少需要 sqlcmd 版本 13.1。若要确定你的版本，请执行 sqlcmd -?。有关详细信息，请参阅 使用 Azure Active Directory 身份验证连接到 SQL 数据库或 SQL 数据仓库。-A 选项不支持使用-G 选项。

选项仅适用于 Azure SQL 数据库 和 Azure 数据仓库。

-H workstation_name

工作站的名称。此选项设置 sqlcmd 脚本变量 SQLCMDWORKSTATION。工作站名称列出在 sys.sysprocesses 目录视图的 hostname 列中，并且可使用存储过程 sp_who返回。如果不指定此选项，则默认为当前计算机名称。此名称可用来标识不同的 sqlcmd 会话。

-j 将原始错误消息输出到界面上。

-K application_intent

连接到服务器时声明应用程序工作负荷类型。目前唯一支持的值是 ReadOnly。如果未指定 -K ，sqlcmd 实用工具将不支持连接到 AlwaysOn 可用性组中的次要副本。有关详细信息，请参阅活动次要副本：可读次要副本（AlwaysOn 可用性组）

-M multisubnet_failover

在连接到 SQL Server 可用性组或 SQL Server 故障转移群集实例的可用性组侦听程序时，应始终指定 -M。-M 将为（当前）活动服务器提供更快的检测和连接。如果不指定 –M ，则 -M 处于关闭状态。有关详细信息 [！包括ssHADR，创建和配置的可用性组的(SQL Server)，故障转移群集和 Alwayson 可用性组 (SQL Server)，并活动次要副本：可读次要副本 (Alwayson 可用性组）。

-N

此开关供客户端用于请求加密连接。

-P password

用户指定的密码。密码是区分大小写的。如果使用了 -U 选项而未使用 -P 选项，并且未设置 SQLCMDPASSWORD 环境变量，则 sqlcmd 会提示用户输入密码。我们不建议使用 null 密码，但您可以通过连续双引号一对用于参数值指定 null 密码：

-P ""

建议使用强密码。

如果将 -P 选项与 -E 选项一起使用，将生成错误消息。

如果 -P 选项后有多个参数，将生成错误消息并退出程序。

-S [协议:]server[\instance_name] [，* *端口]

指定要连接的 SQL Server 实例。它设置 sqlcmd 脚本变量 SQLCMDSERVER。

指定 server_name 可连接到该服务器计算机上的 SQL Server 默认实例。指定要连接到该服务器计算机上 SQL Server 命名实例的 server_name [ \instance_name ]。如果不指定服务器，sqlcmd 将连接到本地计算机上 SQL Server 的默认实例。从网络上的远程计算机执行 sqlcmd 时，此选项是必需的。

-U login_id

登录名或包含的数据库用户名。对于包含的数据库用户，必须提供数据库名称选项 (-d)。

-z new_password

更改密码：

sqlcmd -U someuser -P s0mep@ssword -z a_new_p@a$$w0rd

-Z new_password

更改密码并退出：

sqlcmd -U someuser -P s0mep@ssword -Z a_new_p@a$$w0rd

4、sqlcmd 示例说明

4.1 登录服务器

格式：sqlcmd -S 服务器名称 -U 帐户 -P 密码

示例：sqlcmd -S "127.0.0.1" -U "sa" -P "sa"

4.2 直接执行SQL脚本

格式：sqlcmd -S 服务器名称 -U 帐户 -P 密码 -d 数据库 -i SQL脚本

示例：sqlcmd -S "127.0.0.1" -U "sa" -P "sa" -d "MyDB" -i "D:\test.sql" --执行脚本文件

sqlcmd -S "127.0.0.1" -U "sa" -P "sa" -d "MyDB" -q "select * from UserInfo" -- 直接执行sql语句