쿼리 편집기로 SQLCMD 스크립트 편집Edit SQLCMD Scripts with Query Editor

데이터베이스 엔진Database EngineSQL Server Management StudioSQL Server Management Studio 쿼리 편집기를 사용하여 쿼리를 SQLCMD 스크립트로 작성 및 편집할 수 있습니다.By using the 데이터베이스 엔진Database Engine Query Editor in SQL Server Management StudioSQL Server Management Studio you can write and edit queries as SQLCMD scripts. 같은 스크립트에서 Windows 시스템 명령과 Transact-SQLTransact-SQL 문을 처리해야 하는 경우 SQLCMD 스크립트를 사용합니다.You use SQLCMD scripts when you have to process Windows System commands and Transact-SQLTransact-SQL statements in the same script.

SQLCMD 모드SQLCMD Mode

데이터베이스 엔진Database Engine 쿼리 편집기를 사용하여 SQLCMD 스크립트를 작성하거나 편집하려면 SQLCMD 스크립팅 모드를 설정해야 합니다.To use the 데이터베이스 엔진Database Engine Query Editor to write or edit SQLCMD scripts, you must enable the SQLCMD scripting mode. 기본적으로 SQLCMD 모드는 쿼리 편집기에서 설정되지 않습니다.By default, SQLCMD mode is not enabled in the Query Editor. 도구 모음에서 SQLCMD 모드 아이콘을 클릭하거나 쿼리 메뉴에서 SQLCMD 모드 를 선택하여 스크립팅 모드를 설정할 수 있습니다.You can enable scripting mode by clicking the SQLCMD Mode icon in the toolbar or by selecting SQLCMD Mode from the Query menu.

참고

SQLCMD 모드를 설정하면 Transact-SQLTransact-SQL 쿼리 편집기에서 IntelliSense 및 데이터베이스 엔진Database Engine 디버거가 해제됩니다.Enabling SQLCMD mode turns off IntelliSense and the Transact-SQLTransact-SQL debugger in the 데이터베이스 엔진Database Engine Query Editor.

쿼리 편집기에서 SQLCMD 스크립트는 모든 Transact-SQLTransact-SQL 스크립트가 사용하는 것과 동일한 기능을 사용할 수 있습니다.SQLCMD scripts in the Query Editor can use the same features that all Transact-SQLTransact-SQL scripts use. 이러한 기능에는These features include the following:

  • 색 구분Color Coding

  • 스크립트 실행Executing Scripts

  • 원본 제어Source Control

  • 스크립트 구문 분석Parsing Scripts

  • ShowplanShowplan

쿼리 편집기에서 SQLCMD 스크립팅 설정Enable SQLCMD Scripting in Query Editor

활성 데이터베이스 엔진Database Engine 쿼리 편집기 창에 대해 SQLCMD 스크립팅을 설정하려면 다음 절차를 사용합니다.To turn SQLCMD scripting on for an active 데이터베이스 엔진Database Engine Query Editor window, use the following procedure.

데이터베이스 엔진 쿼리 편집기 창을 SQLCMD 모드로 전환하려면To switch a Database Engine Query Editor window to SQLCMD mode

  1. 개체 탐색기에서 서버를 마우스 오른쪽 단추로 클릭한 다음 새 쿼리 데이터베이스 엔진Database Engine를 클릭하여 새 쿼리 편집기 창을 엽니다.In Object Explorer, right-click the server, and then click New Query, to open a new 데이터베이스 엔진Database Engine Query Editor window.

  2. 쿼리 메뉴에서 SQLCMD 모드를 클릭합니다.On the Query menu, click SQLCMD Mode.

    쿼리 편집기의 컨텍스트에서 sqlcmd 문이 실행됩니다.The Query Editor executes sqlcmd statements in the context of the Query Editor.

  3. SQL 편집기 도구 모음의 사용 가능한 데이터베이스 목록에서 AdventureWorks2012AdventureWorks2012를 선택합니다.On the SQL Editor toolbar, in the Available Databases list, select AdventureWorks2012AdventureWorks2012.

  4. 쿼리 편집기 창에 다음 두 Transact-SQLTransact-SQL 문과 !!DIR sqlcmd 문을 입력합니다.In the Query Editor window, type the following two Transact-SQLTransact-SQL statements and the !!DIR sqlcmd statement:

    SELECT DISTINCT Type FROM Sales.SpecialOffer;  
    GO  
    !!DIR  
    GO  
    SELECT ProductCategoryID, Name FROM Production.ProductCategory;  
    GO  
    
  5. F5 키를 눌러 혼합된 Transact-SQLTransact-SQL 및 MS-DOS 문의 전체 섹션을 실행합니다.Press F5 to execute the whole section of mixed Transact-SQLTransact-SQL and MS-DOS statements.

    첫 번째 문과 세 번째 문에서 생성된 두 SQL 결과 창을 확인합니다.Notice the two SQL result panes from the first and third statements.

  6. 결과 창에서 메시지 탭을 클릭하여 세 문 모두에서 생성된 메시지를 봅니다.In the Results pane, click the Messages tab to see the messages from all three statements:

    • (6개 행 적용됨)(6 row(s) affected)

    • <디렉터리 정보><The directory information>

    • (4개 행 적용됨)(4 row(s) affected)

중요

명령줄에서 sqlcmd 유틸리티를 실행하면 운영 체제와의 전체 상호 작용이 허용됩니다.When executed from the command line, the sqlcmd utility permits full interaction with the operating system. SQLCMD 모드에서 쿼리 편집기를 사용할 때는 대화형 문을 실행하지 않도록 주의해야 합니다.When you use the Query Editor in SQLCMD Mode, you must be careful not to execute interactive statements. 쿼리 편집기에는 운영 체제 프롬프트에 응답하는 기능이 없습니다.The Query Editor cannot respond to operating system prompts.

SQLCMD 실행 방법은 sqlcmd Utility를 참조하거나 SQLCMD 자습서를 따라하십시오.For more information about how to run SQLCMD, see sqlcmd Utility, or take the SQLCMD tutorial.

SQLCMD 스크립팅을 기본적으로 설정Enable SQLCMD Scripting by Default

SQLCMD 스크립팅을 기본적으로 설정하려면 도구 메뉴에서 옵션을 선택하고 쿼리 실행, SQL Server를 차례로 확장한 다음 일반 페이지를 클릭하고 기본적으로 SQLCMD 모드로 새 쿼리를 엽니다. 상자를 선택합니다.To turn SQLCMD scripting on by default, on the Tools menu select Options, expand Query Execution, and SQL Server, click the General page, and then check the By default open new queries in SQLCMD Mode box.

SQLCMD 스크립트 작성 및 편집Writing and Editing SQLCMD Scripts

스크립팅 모드를 설정한 후 SQLCMD 명령과 Transact-SQLTransact-SQL 문을 작성할 수 있습니다.After enabling scripting mode you may write SQLCMD commands and Transact-SQLTransact-SQL statements. 다음 규칙이 적용됩니다.The following rules apply:

  • SQLCMD 명령은 줄에서 첫 번째 문이어야 합니다.SQLCMD commands must be the first statement on a line.

  • 각 줄에서 SQLCMD 명령이 하나만 허용됩니다.Only one SQLCMD command is permitted on each line.

  • SQLCMD 명령은 주석이나 공백 뒤에 올 수 있습니다.SQLCMD commands can be preceded by comments or white space.

  • 주석 문자 내의 SQLCMD 명령은 실행되지 않습니다.SQLCMD commands within comment characters are not executed.

  • 단일 줄 주석 문자는 두 개의 하이픈(--) 이며 줄의 시작 부분에 표시되어야 합니다.Single line comment characters are two hyphens (--) and must appear at the beginning of a line.

  • 운영 체제 명령은 두 개의 느낌표(!!) 뒤에 와야 합니다.Operating system commands must be preceded by two exclamation points (!!). 이중 느낌표 명령은 느낌표 뒤에 있는 문이 cmd.exe 명령 처리기를 사용하여 실행되도록 합니다.The double-exclamation points command causes the statement that follows the exclamation points to be executed using the cmd.exe command processor. !! 뒤에 있는 텍스트는 매개 변수로 cmd.exe에 전달되므로 최종 명령줄은 "%SystemRoot%\system32\cmd.exe /c <text after !!>"로 실행됩니다.The text after !! is passed in as a parameter to cmd.exe, so the final command line will execute as: "%SystemRoot%\system32\cmd.exe /c <text after !!>".

  • SQLCMD 명령과 Transact-SQLTransact-SQL을 분명하게 구분하기 위해 모든 SQLCMD 명령 앞에 콜론(:) 접두사가 와야 합니다.To make a clear distinction between SQLCMD commands and Transact-SQLTransact-SQL, all SQLCMD commands, need to be prefixed with a colon (:).

  • GO 명령은 접두사 없이 사용하거나 앞에 !!:The GO command may be used without preface, or preceded by !!:

  • 이 올 수 있습니다. 데이터베이스 엔진Database Engine 쿼리 편집기는 SQLCMD 스크립트의 일부로 정의된 환경 변수 및 변수를 지원하지만 기본 제공 SQLCMD 또는 osql 변수는 지원하지 않습니다.The 데이터베이스 엔진Database Engine Query Editor supports environment variables and variables that are defined as part of a SQLCMD script, but does not support built-in SQLCMD or osql variables. SQL Server Management StudioSQL Server Management Studio 에서 처리하는 SQLCMD는 변수에 대해 대/소문자를 구분합니다.SQLCMD processing by SQL Server Management StudioSQL Server Management Studio is case sensitive for variables. 예를 들어 PRINT '$(COMPUTERNAME)'는 올바른 결과를 생성하는 반면 PRINT '$(ComputerName)'는 오류를 반환합니다.For example, PRINT '$(COMPUTERNAME)' produces the correct result, but PRINT '$(ComputerName)' returns an error.

주의

SQL Server Management StudioSQL Server Management Studio 는 일반 및 SQLCMD 모드에서의 실행을 위해 MicrosoftMicrosoft .NET Framework.NET FrameworkSqlClient를 사용합니다. SQL Server Management StudioSQL Server Management Studio uses MicrosoftMicrosoft .NET Framework.NET FrameworkSqlClient for execution in regular and SQLCMD mode. 명령줄에서 실행할 경우 SQLCMD는 OLE DB 공급자를 사용합니다.When run from the command line, SQLCMD uses the OLE DB provider. 다른 기본 옵션이 적용될 수 있으므로 SQL Server Management StudioSQL Server Management Studio SQLCMD 모드 및 SQLCMD 유틸리티에서 동일한 쿼리를 실행하는 동안 다른 동작이 수행될 수 있습니다.Because different default options may apply, it is possible to get different behavior while executing the same query in SQL Server Management StudioSQL Server Management Studio SQLCMD Mode, and in the SQLCMD utility.

지원되는 SQLCMD 구문Supported SQLCMD Syntax

데이터베이스 엔진Database Engine 쿼리 편집기는 다음 SQLCMD 스크립트 키워드를 지원합니다.The 데이터베이스 엔진Database Engine Query Editor supports the following SQLCMD script keywords:

[!!:]GO[count]

!! <command>

:exit(statement)

:Quit

:r <filename>

:setvar <var> <value>

:connect server[\instance] [-l login_timeout] [-U user [-P password]]

:on error [ignore|exit]

:error <filename>|stderr|stdout

:out <filename>|stderr|stdout

참고

:error:out모두에서 stderrstdout 은 출력을 메시지 탭으로 보냅니다.For both :error and :out, stderr and stdout send output to the messages tab.

위에 나열되지 않은 SQLCMD 명령은 쿼리 편집기에서 지원되지 않습니다.SQLCMD commands not listed above are not supported in Query Editor. 지원되지 않은 SQLCMD 키워드가 포함된 스크립트가 실행되면 쿼리 편집기는 지원되지 않는 각 키워드의 대상에 "Ignoring command <무시된 명령>" 메시지를 보냅니다.When a script containing SQLCMD keywords that are not supported is executed, the Query Editor will send an "Ignoring command <ignored command>" message to the destination for each unsupported keyword. 스크립트가 성공적으로 실행되지만 지원되지 않은 명령은 무시됩니다.The script will execute successfully, but the unsupported commands will be ignored.

주의

SQLCMD를 명령줄에서 시작하지 않기 때문에 SQLCMD 모드에서 쿼리 편집기를 실행할 때 몇 가지 제한 사항이 있습니다.Because you are not starting SQLCMD from the command line, there are some limitations when running Query Editor in SQLCMD Mode. 변수와 같은 명령줄 매개 변수를 전달할 수 없으며, 쿼리 편집기는 운영 체제 프롬프트에 응답하는 기능이 없으므로 대화형 문을 실행하지 않도록 주의해야 합니다.You cannot pass in command-line parameters such as variables, and, because the Query Editor does not have the ability to respond to operating system prompts, you must be careful not to execute interactive statements.

SQLCMD 스크립트에서 코드 색 구분Color Coding in SQLCMD Scripts

SQLCMD 스크립팅이 설정되어 있으면 스크립트의 색이 구분됩니다.With SQLCMD scripting enabled, scripts will be color coded. Transact-SQLTransact-SQL 키워드에 대한 색 구분은 동일하게 유지됩니다.The color coding for Transact-SQLTransact-SQL keywords will remain the same. SQLCMD 명령은 회색 배경과 함께 표시됩니다.SQLCMD commands are presented with a shaded background.

예제Example

다음 예에서는 sqlcmd 문을 사용하여 testoutput.txt 출력 파일을 만들고 Transact-SQLTransact-SQL SELECT 문 두 개와 운영 체제 명령 하나를 실행해 현재 디렉터리를 출력합니다.The following example uses a sqlcmd statement to create an output file called testoutput.txt, executes two Transact-SQLTransact-SQL SELECT statements along with one operating system command (to print out the current directory). 결과 파일에는 DIR 문의 메시지 출력과 Transact-SQLTransact-SQL 문의 결과 출력이 차례로 표시됩니다.The resultant file contains the message output from the DIR statement, followed by the results output from the Transact-SQLTransact-SQL statements.

:out C:\testoutput.txt  
SELECT @@VERSION As 'Server Version'  
!!DIR  
!!:GO  
SELECT @@SERVERNAME AS 'Server Name'  
GO  

참고 항목See Also

sqlcmd Utilitysqlcmd Utility