相关文章推荐
高大的春卷  ·  Android中的WebView之loadD ...·  2 年前    · 
威武的登山鞋  ·  python - Solving ...·  3 年前    · 
温柔的玉米  ·  android - null shared ...·  3 年前    · 

适用于: SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)

sqlcmd 实用工具是一个命令行实用工具,用于 Transact-SQL 语句和脚本的临时、交互执行以及自动执行 Transact-SQL 脚本撰写任务。 若要以交互方式使用 sqlcmd,或要生成可使用 sqlcmd 运行的脚本文件,用户需要了解 Transact-SQL。 通常以下列方式使用 sqlcmd 实用工具:

  • 用户输入 Transact-SQL 语句,输入方式与在命令提示符下输入的方式类似。 结果将显示在命令提示符处。 若要打开命令提示符窗口,请在 Windows 搜索框中输入“cmd”,然后选择“命令提示符”将其打开。 在命令提示符处,键入 sqlcmd ,后面跟随所需的选项列表。 有关 sqlcmd支持的选项的完整列表,请参阅 sqlcmd 实用工具

  • 用户通过下列方式提交 sqlcmd 作业:指定要执行的单个 Transact-SQL 语句,或将实用工具指向要执行的 Transact-SQL 语句所在的文本文件。 输出定向到一个文本文件,但也可能在命令提示符处显示。

  • SQL Server Management Studio 查询编辑器中的 SQLCMD 模式

  • SQL Server 管理对象 (SMO)

  • SQL Server 代理 CmdExec 作业。

    常用 sqlcmd 选项

  • 服务器选项 (-S),用于标识 sqlcmd 连接到的 Microsoft SQL Server 实例。

  • 身份验证选项(-E、-U 和 -P),用于指定 sqlcmd 连接到 SQL Server 实例所使用的凭据。

    -E 选项为默认选项,无需指定。

  • 输入选项(-Q、-q 和 -i),用于标识 sqlcmd 输入的位置 。

  • 输出选项 (-o),用于指定 sqlcmd 输出所在的文件 。

    连接到 sqlcmd 实用工具

  • 使用 Windows 身份验证连接到默认实例,以交互方式运行 Transact-SQL 语句:

    sqlcmd -S <ComputerName>
    

    上述示例中,未指定 -E 选项,因为它是默认选项,而且 sqlcmd 使用 Windows 身份验证连接到默认实例。

  • 使用 Windows 身份验证连接到命名实例,以交互方式运行 Transact-SQL 语句:

    sqlcmd -S <ComputerName>\<InstanceName>
    
    sqlcmd -S .\<InstanceName>
    
  • 使用 Windows 身份验证连接到命名实例,并指定输入和输出文件:

    sqlcmd -S <ComputerName>\<InstanceName> -i <MyScript.sql> -o <MyOutput.rpt>
    
  • 使用 Windows 身份验证连接到本地计算机上的默认实例,执行查询,并在查询运行完毕后使 sqlcmd 保持运行状态:

    sqlcmd -q "SELECT * FROM AdventureWorks2012.Person.Person"
    
  • 使用 Windows 身份验证连接到本地计算机上的默认实例,执行查询,将输出定向到某个文件,并在查询运行完毕后使 sqlcmd 退出:

    sqlcmd -Q "SELECT * FROM AdventureWorks2012.Person.Person" -o MyOutput.txt
    
  • 使用 SQL Server 身份验证连接到命名实例,以交互方式运行 Transact-SQL 语句,并由 sqlcmd 提示输入密码:

    sqlcmd -U MyLogin -S <ComputerName>\<InstanceName>
    

    若要查看 sqlcmd 实用工具所支持选项的列表,请运行: sqlcmd -?

    使用 sqlcmd 以交互方式运行 Transact-SQL 语句

    你可以使用 sqlcmd 实用工具以交互方式在命令提示符窗口中执行 Transact-SQL 语句。 若要使用 sqlcmd 以交互方式执行 Transact-SQL 语句,请在未使用 -Q、-q、-Z 或 -i 选项指定任何输入文件或查询的情况下运行该实用工具。 例如:

    sqlcmd -S <ComputerName>\<InstanceName>

    在未指定输入文件或查询的情况下执行命令时,sqlcmd 连接到 SQL Server 的指定实例,然后显示一个新行,其中包含 1> 并且后跟一个闪烁的下划线(称为 sqlcmd 提示符)。 1 表示这是 Transact-SQL 语句的第一行,而 sqlcmd 提示符则是你键入 Transact-SQL 语句的起点。

    在 sqlcmd 提示符中,可以键入 Transact-SQL 语句和 sqlcmd 命令,如 GO 和 EXIT。 每个 Transact-SQL 语句放置在称为“语句缓存”的缓冲区中。 键入 GO 命令并按 Enter 键后,这些语句将发送到 SQL Server。 若要退出 sqlcmd,请在新行的开头键入 EXITQUIT

    若要清除语句缓存,请键入 :RESET。 键入 ^C 可使 sqlcmd 退出。 在发出 ^C 命令后,还可以用 ^C 停止语句缓存的执行。

    通过输入 :ED 命令和 sqlcmd 提示符,可以编辑交互式会话中输入的 Transact-SQL 语句。 编辑器将打开,编辑 Transact-SQL 语句并关闭编辑器后,修改后的 Transact-SQL 语句将显示在命令窗口中。 输入 GO 以运行修改后的 Transact-SQL 语句。

    带引号的字符串

    用引号引起来的字符无需任何额外的预处理即可使用。例外,输入两个连续的引号可以将引号插入字符串中。 SQL Server 将这种字符序列视作一个引号。 (但在服务器上会进行转换。)当脚本变量出现在字符串中时,不会展开它们。

    sqlcmd

    PRINT "Length: 5"" 7'";

    下面是结果集。

    Length: 5" 7'

    跨多行的字符串

    sqlcmd 支持包含跨多行的字符串的脚本。 例如,下面的 SELECT 语句跨多行,但键入 GO并按 Enter 键后,将执行单个字符串。

    SELECT First line

    FROM Second line

    WHERE Third line;

    交互式 sqlcmd 示例

    本示例说明了以交互方式运行 sqlcmd 的过程。

    打开命令提示符窗口时,出现如下一行内容:

    C:\> _

    这表示文件夹 C:\ 为当前文件夹,如果您指定文件名,则 Windows 将在此文件夹中查找这个文件。

    键入 sqlcmd 以连接到本地计算机上的 SQL Server 默认实例,命令提示符窗口内容将显示为:

    C:\>sqlcmd

    这表示你已连接到 SQL Server 实例,并且 sqlcmd 现在已可以接受 Transact-SQL 语句和 sqlcmd 命令。 1> 后闪烁的下划线是 sqlcmd 提示符,它标明了所键入语句和命令的显示位置。 现在,键入 USE AdventureWorks2012 并按 Enter 键,然后键入 GO 并按 Enter 键。 命令提示符窗口的内容如下:

    sqlcmd

    USE AdventureWorks2012;

    下面是结果集。

    Changed database context to 'AdventureWorks2012'.

    选择 USE AdventureWorks2012 后按 Enter 键,即向 sqlcmd 发出换行信号。 选择类型 GO, 后按 Enter 键,即向 sqlcmd 发出将 USE AdventureWorks2012 语句发送到 SQL Server 的实例的信号。 sqlcmd 随后返回一条消息,指示 USE 语句已成功完成并显示新的 1> 提示符作为输入新语句或命令的信号。

    下面的示例说明了键入 SELECT 语句和 GO 执行 SELECT以及键入 EXIT 退出 sqlcmd时命令提示符窗口包含的内容:

    sqlcmd

    USE AdventureWorks2012;

    SELECT TOP (3) BusinessEntityID, FirstName, LastName

    FROM Person.Person;

    下面是结果集。

    BusinessEntityID FirstName LastName

    ----------- -------------------------------- -----------

    1 Syed Abbas

    2 Catherine Abel

    3 Kim Abercrombie

    (3 rows affected)

    1> EXIT

    3> GO 后的几行内容为 SELECT 语句的输出。 生成输出后, sqlcmd 重置 sqlcmd 提示符并显示 1>。 在 EXIT 行输入 1>后,命令提示符窗口显示第一次打开时显示的行。 它指示 sqlcmd 已退出会话。 现在可以再键入一个 EXIT 命令关闭命令提示符窗口。

    使用 sqlcmd 运行 Transact-SQL 脚本文件

    可以使用 sqlcmd 执行数据库脚本文件。 脚本文件是一些文本文件,它们同时包含 Transact-SQL 语句、sqlcmd 命令和脚本变量。 有关如何使用脚本变量的详细信息,请参阅 将 sqlcmd 与脚本变量结合使用sqlcmd 与脚本文件中语句、命令和脚本变量的配合方式类似于它与交互输入的语句和命令的配合方式。 主要区别在于 sqlcmd 从输入文件连续读取内容,而不是等待用户输入语句、命令和脚本变量。

    可以通过几种不同的方式创建数据库脚本文件:

  • 可以在 SQL Server Management Studio 中以交互方式生成和调试一组 Transact-SQL 语句,然后将“查询”窗口中的内容另存为脚本文件。

  • 可以使用记事本等文本编辑器创建包含 Transact-SQL 语句的文本文件。

    A. 使用 sqlcmd 运行脚本

    启动记事本并键入以下 Transact-SQL 语句:

    USE AdventureWorks2012;

    SELECT TOP (3) BusinessEntityID, FirstName, LastName

    FROM Person.Person;

    创建一个名为 MyFolder 的文件夹,然后将脚本另存为文件夹 MyScript.sql 中的文件 C:\MyFolder。 在命令提示符处输入以下命令运行脚本,并将输出放入 MyOutput.txtMyFolder中:

    sqlcmd -i C:\MyFolder\MyScript.sql -o C:\MyFolder\MyOutput.txt

    在记事本中查看 MyOutput.txt 的内容时,将看到以下内容:

    Changed database context to 'AdventureWorks2012'.

    BusinessEntityID FirstName LastName

    ---------------- ----------- -----------

    1 Syed Abbas

    2 Catherine Abel

    3 Kim Abercrombie

    (3 rows affected)

    B. 通过专用管理连接使用 sqlcmd

    在下面的示例中, sqlcmd 通过专用管理员连接 (DAC) 连接到一台具有阻塞问题的服务器。

    C:\>sqlcmd -S ServerName -A

    1> SELECT session_id, blocking_session_id FROM sys.dm_exec_requests WHERE blocking_session_id <> 0;

    下面是结果集。

    session_id blocking_session_id

    ------ -------

    62 64

    (1 rows affected)

    使用 sqlcmd 结束阻塞进程。

    1> KILL 64;

    C. 使用 sqlcmd 执行存储过程

    下面的示例说明如何使用 sqlcmd执行存储过程。 创建以下存储过程。

    USE AdventureWorks2012;

    IF OBJECT_ID ( ' dbo.ContactEmailAddress, 'P' ) IS NOT NULL

    DROP PROCEDURE dbo.ContactEmailAddress;

    CREATE PROCEDURE dbo.ContactEmailAddress

    @FirstName nvarchar(50)

    ,@LastName nvarchar(50)

    SET NOCOUNT ON

    SELECT EmailAddress

    FROM Person.Person

    WHERE FirstName = @FirstName

    AND LastName = @LastName;

    SET NOCOUNT OFF

    sqlcmd 提示符下,输入以下内容:

    C:\sqlcmd

    1> :Setvar FirstName Gustavo

    1> :Setvar LastName Achong

    1> EXEC dbo.ContactEmailAddress $(FirstName),$(LastName)

    EmailAddress

    -----------------------------

    gustavo0@adventure-works.com

    D. 使用 sqlcmd 进行数据库维护

    下面的示例说明了如何将 sqlcmd 用于数据库维护任务。 使用以下代码创建 C:\BackupTemplate.sql

    USE master;

    BACKUP DATABASE [$(db)] TO DISK='$(bakfile)';

    sqlcmd 提示符下,输入以下内容:

    C:\ >sqlcmd

    1> :connect <server>

    Sqlcmd: Successfully connected to server <server>.

    1> :setvar db msdb``

    1> :setvar bakfile c:\msdb.bak

    1> :r c:\BackupTemplate.sql

    Changed database context to 'master'.

    Processed 688 pages for database 'msdb', file 'MSDBData' on file 2.

    Processed 5 pages for database 'msdb', file 'MSDBLog' on file 2.

    BACKUP DATABASE successfully processed 693 pages in 0.725 seconds (7.830 MB/sec)

    E. 使用 sqlcmd 对多个实例执行代码

    某文件中的以下代码表示一个连接到两个实例的脚本。 请注意连接到第二个实例之前的 GO

    :CONNECT <server>\,<instance1>

    EXEC dbo.SomeProcedure

    :CONNECT <server>\,<instance2>

    EXEC dbo.SomeProcedure

    E. 返回 XML 输出

    下面的示例说明了如何以连续流返回未格式化的 XML 输出。

    C:\>sqlcmd -d AdventureWorks2012

    1> :XML ON

    1> SELECT TOP 3 FirstName + ' ' + LastName + ', '

    2> FROM Person.Person

    Syed Abbas, Catherine Abel, Kim Abercrombie,

    F. 在 Windows 脚本文件中使用 sqlcmd

    在 .bat 文件中, sqlcmd命令(如 sqlcmd -i C:\InputFile.txt -o C:\OutputFile.txt, )可以与 VBScript 一起执行。 此时,不要使用交互选项。 执行 .bat 文件的计算机上必须安装sqlcmd

    首先,创建以下四个文件:

  • C:\badscript.sql

    SELECT batch_1_this_is_an_error
    SELECT 'batch #2'
    
  • C:\goodscript.sql

    SELECT 'batch #1'
    SELECT 'batch #2'
    
  • C:\returnvalue.sql

    :exit(select 100)
    
  • C:\windowsscript.bat

    @echo off
    echo Running badscript.sql
    sqlcmd -i badscript.sql -b -o out.log
    if not errorlevel 1 goto next1
    echo == An error occurred
    :next1
    echo Running goodscript.sql
    sqlcmd -i goodscript.sql -b -o out.log
    if not errorlevel 1 goto next2
    echo == An error occurred
    :next2
    echo Running returnvalue.sql
    sqlcmd -i returnvalue.sql -o out.log
    echo SQLCMD returned %errorlevel% to the command shell
    :exit
    

    然后,在命令提示符处运行 C:\windowsscript.bat

    C:\>windowsscript.bat

    Running badscript.sql

    == An error occurred

    Running goodscript.sql

    Running returnvalue.sql

    SQLCMD returned 100 to the command shell

    G. 使用 sqlcmd 在 Azure SQL 数据库上设置加密

    可对与 SQL 数据库数据的连接执行 sqlcmd 以指定加密和证书信任。 有两个 sqlcmd 选项可供选择**``:

  • -N 开关,客户端使用它来请求加密连接。 此选项等同于 ADO.net 选项 ENCRYPT = true

  • -C 开关,客户端用来将其配置为隐式信任服务器证书且不对其进行验证。 此选项等同于 ADO.net 选项 TRUSTSERVERCERTIFICATE = true

    SQL 数据库服务并不支持 SQL Server 实例上所有可用的 SET 选项。 当将相应的 SET 选项设置为 ONOFF时,下面的选项将引发错误:

  • SET ANSI_DEFAULTS

  • SET ANSI_NULLS

  • SET REMOTE_PROC_TRANSACTIONS

  • SET ANSI_NULL_DEFAULT

    下面的 SET 选项虽然不会引发异常,但无法使用。 已将它们弃用:

  • SET CONCAT_NULL_YIELDS_NULL

  • SET ANSI_PADDING

  • SET QUERY_GOVERNOR_COST_LIMIT

    以下示例介绍了 SQL Server Native Client 访问接口设置包括的情况:ForceProtocolEncryption = FalseTrust Server Certificate = No

    使用 Windows 凭据进行连接并对通信加密:

    SQLCMD -E -N
    

    使用 Windows 凭据进行连接并信任服务器证书:

    SQLCMD -E -C
    

    使用 Windows 凭据进行连接、对通信加密并信任服务器证书:

    SQLCMD -E -N -C
    

    以下示例介绍了 SQL Server Native Client 访问接口设置包括的情况:ForceProtocolEncryption = TrueTrustServerCertificate = Yes

    使用 Windows 凭据进行连接、对通信加密并信任服务器证书:

    SQLCMD -E
    

    使用 Windows 凭据进行连接、对通信加密并信任服务器证书:

    SQLCMD -E -N
    

    使用 Windows 凭据进行连接、对通信加密并信任服务器证书:

    SQLCMD -E -C
    

    使用 Windows 凭据进行连接、对通信加密并信任服务器证书:

    SQLCMD -E -N -C
    

    如果访问接口指定了 ForceProtocolEncryption = True ,则启用加密,即使连接字符串中具有 Encrypt=No

  • Sqlcmd 实用工具
  • 将 sqlcmd 与脚本变量结合使用
  • 使用查询编辑器编辑 SQLCMD 脚本
  • 管理作业步骤
  • 创建 CmdExec 作业步骤
  •