쿼리 편집기를 사용하여 SQLCMD 스크립트 편집

SSMS(SQL Server Management Studio)의 쿼리 편집기를 사용하여 쿼리를 SQLCMD 스크립트로 작성하고 편집합니다. SQLCMD 스크립트를 사용하여 동일한 스크립트에서 Windows 시스템 명령 및 Transact-SQL 문을 처리할 수 있습니다.

SQLCMD 모드 사용

쿼리 편집기를 사용하여 SQLCMD 스크립트를 작성하거나 편집하려면 SQLCMD 스크립팅 모드를 사용하도록 설정해야 합니다. SQLCMD 모드는 기본적으로 사용하도록 설정되지 않습니다. 도구 모음에서 SQLCMD 모드 아이콘을 선택하거나 쿼리 메뉴에서 SQLCMD 모드를 선택하여 스크립팅 모드를 사용하도록 설정할 수 있습니다.

쿼리 편집기에서 SQLCMD 스크립트는 모든 Transact-SQL 스크립트에서 사용하는 것과 동일한 기능을 사용할 수 있습니다. 이러한 기능은 다음과 같습니다.

• 색 구분
• 스크립트 실행
• 소스 제어
• 스크립트 구문 분석
• 쇼플랜

쿼리 편집기에서 SQLCMD 스크립팅 사용 설정

활성 쿼리 편집기 창에 대한 SQLCMD 스크립팅을 켜려면 다음 절차를 사용합니다.

쿼리 편집기 창을 SQLCMD 모드로 전환

1. 개체 탐색기에서 서버를 마우스 오른쪽 단추로 클릭한 다음 새 쿼리 를 선택하여 새 쿼리 편집기 창을 엽니다.

2. 쿼리 메뉴에서 SQLCMD 모드를 선택합니다.

   SQLCMD 문은 쿼리 편집기의 컨텍스트에서 실행됩니다.

3. SQL 편집기 도구 모음의 사용 가능한 데이터베이스 목록에서 AdventureWorks2025을(를) 선택합니다.

4. 쿼리 편집기 창에서 다음 Transact-SQL 문과 !!DIR SQLCMD 문을 입력합니다.

   SELECT DISTINCT Type FROM Sales.SpecialOffer;
   GO
   !!DIR
   GO
   SELECT ProductCategoryID, Name FROM Production.ProductCategory;
   GO
   

5. F5 키를 눌러 혼합된 Transact-SQL 및 MS-DOS 문 섹션을 실행합니다.

   첫 번째 문과 세 번째 문에서 두 개의 SQL 결과 창을 확인합니다.

6. 결과 창에서 메시지 탭을 선택하여 세 가지 문 모두의 메시지를 확인합니다.

   • (6 row(s) affected)
   • <The directory information>
   • (4 row(s) affected)

SQLCMD 스크립팅을 기본적으로 사용하도록 설정

기본적으로 SQLCMD 스크립팅을 켜려면 도구 메뉴에서 옵션을 선택하고 쿼리 실행, SQL Server를 확장하고 일반 페이지를 선택한 다음 기본적으로 SQLCMD 모드에서 새 쿼리 열기 상자를 선택합니다.

SQLCMD 스크립트 작성 및 편집

스크립팅 모드를 사용하도록 설정한 후에는 SQLCMD 명령과 Transact-SQL 문을 모두 작성할 수 있습니다. 다음 규칙이 적용됩니다.

• SQLCMD 명령은 한 줄의 첫 번째 구문이어야 합니다.

• 각 줄에는 하나의 SQLCMD 명령만 허용됩니다.

• SQLCMD 명령 앞에 주석과 공백을 사용할 수 있습니다.

• 주석 문자 내의 SQLCMD 명령은 실행되지 않습니다.

• 한 줄 주석 문자는 두 개의 하이픈(--)이며 줄의 시작 부분에 나타나야 합니다.

• 운영 체제 명령어에 두 개의 느낌표(!!)를 접두사로 붙이세요. 느낌표 뒤에 오는 문을 cmd.exe 명령 프로세서를 사용하여 실행하도록 하려면 이중 느낌표 명령을 사용하십시오. 이후 !! 의 텍스트는 매개 변수 cmd.exe로 전달되므로 최종 명령줄은 다음과 "%SystemRoot%\system32\cmd.exe /c <text after !!>"같이 실행됩니다.

• SQLCMD 명령과 Transact-SQL을 명확하게 구분하려면 콜론(:)을 사용하여 모든 SQLCMD 명령의 접두사를 지정합니다.

• 이 GO 명령은 서문 없이 사용하거나 앞에 !!:사용할 수 있습니다.

• 쿼리 편집기에서는 SQLCMD 스크립트의 일부로 정의하는 환경 변수 및 변수를 지원하지만 기본 제공 SQLCMD 또는 osql 변수는 지원하지 않습니다. SSMS는 SQLCMD 변수를 대/소문자를 구분하는 것으로 처리합니다. 예를 들어 PRINT '$(COMPUTERNAME)' 올바른 결과를 생성하지만 PRINT '$(ComputerName)' 오류를 반환합니다.

지원되는 SQLCMD 구문

쿼리 편집기에서 지원하는 SQLCMD 스크립트 키워드는 다음과 같습니다.

• [!!:]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 ²

¹ 명령에 대한 :connect 자세한 내용은 sqlcmd 유틸리티의 명령을 참조하세요.

² 쿼리 편집기는 stderr 및 stdout에 대해 메시지 탭으로 출력을 보냅니다.

쿼리 편집기에서는 이전 목록에 포함되지 않은 SQLCMD 명령을 지원하지 않습니다. 지원되지 않는 SQLCMD 키워드가 포함된 스크립트를 실행하면 쿼리 편집기에서 명령을 무시합니다. 지원되지 않는 각 키워드에 대해 쿼리 편집기에서 대상에 다음 메시지를 보냅니다.

Ignoring command <ignored_command>

SQLCMD 스크립트의 색 구분

SQLCMD 스크립팅을 사용하도록 설정하면 스크립트가 색으로 코딩됩니다. Transact-SQL 키워드의 색 코딩은 동일하게 유지됩니다. SQLCMD 명령은 음영 처리된 배경과 함께 표시됩니다.

예시

다음 예제에서는 SQLCMD 문을 사용하여 이름이 지정된 testoutput.txt출력 파일을 만듭니다. 두 개의 Transact-SQL SELECT 문과 현재 디렉터리를 인쇄하는 하나의 운영 체제 명령을 실행합니다. 결과 파일에는 DIR 문의 메시지 출력과 Transact-SQL 문의 결과 출력이 포함됩니다.

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

관련 콘텐츠

• sqlcmd 유틸리티