쿼리 편집기로 SQLCMD 스크립트 편집

아티클
08/17/2023

적용 대상:SQL Server Azure SQL Database Azure SQL Managed InstanceAzure Synapse Analytics Analytics Platform System(PDW)

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

SQLCMD 모드

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

참고 항목

SQLCMD 모드를 설정하면 Transact-SQL 쿼리 편집기에서 IntelliSense 및 데이터베이스 엔진 디버거가 해제됩니다.

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

색 구분
스크립트 실행
소스 컨트롤
스크립트 구문 분석
Showplan

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

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

데이터베이스 엔진 쿼리 편집기 창을 SQLCMD 모드로 전환

개체 탐색기에서 서버를 마우스 오른쪽 단추로 클릭한 다음 새 쿼리를 선택하여 새 데이터베이스 엔진 쿼리 편집기 창을 엽니다.
쿼리 메뉴에서 SQLCMD 모드를 선택합니다.

쿼리 편집기에서는 쿼리 편집기의 컨텍스트에서 SQLCMD 문을 실행합니다.
SQL 편집기 도구 모음의 사용 가능한 데이터베이스 목록에서 .를 선택합니다AdventureWorks2022.

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

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

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

첫 번째 및 세 번째 문에서 두 개의 SQL 결과 창을 확인합니다.
결과 창에서 메시지 탭을 선택하여 세 문 모두의 메시지를 확인합니다.
- (영향을 받는 행 6개)
- <디렉터리 정보>
- (영향을 받는 행 4개)

Important

명령줄 에서 실행되는 경우 sqlcmd 유틸리티는 운영 체제와의 전체 상호 작용을 허용합니다. SQLCMD 모드에서 쿼리 편집기를 사용하는 경우 대화형 문을 실행하지 않도록 주의해야 합니다. 쿼리 편집기가 운영 체제 프롬프트에 응답할 수 없습니다.

SQLCMD를 실행하는 방법에 대한 자세한 내용은 sqlcmd 유틸리티를 참조하거나 SQLCMD 자습서를 참조하세요.

기본적으로 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 변수를 지원하지 않는 환경 변수 및 변수를 지원합니다. SQL Server Management Studio의 SQLCMD 처리는 변수에 대/소문자를 구분합니다. 예를 들어 PRINT '$(COMPUTERNAME)'는 올바른 결과를 생성하지만 PRINT '$(ComputerName)'은 오류를 반환합니다.

주의

SQL Server Management Studio는 일반 모드 및 SQLCMD 모드로 실행하는 데 Microsoft .NET FrameworkSqlClient를 사용합니다. 명령줄에서 실행할 때 SQLCMD는 OLE DB 공급자를 사용합니다. 다른 기본 옵션이 적용될 수 있으므로 SQL Server Management Studio SQLCMD 모드 및 SQLCMD 유틸리티에서 동일한 쿼리를 실행하는 동안 다른 동작을 얻을 수 있습니다.

지원되는 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

참고 항목

메시지 탭에 출력을 보내고, 두 가지 모두 :error 에 대해 출력을 :outstderrstdout보냅니다.

위에 나열되지 않은 SQLCMD 명령은 쿼리 편집기에서 지원되지 않습니다. SQLCMD 키워드를 포함하는 스크립트가 지원되지 않는 경우 쿼리 편집기는 지원되지 않는 각 키워드의 대상으로 "무시 명령 <무시 명령>" 메시지를 보냅니다. 스크립트가 성공적으로 실행되지만 지원되지 않는 명령은 무시됩니다.

주의

명령줄에서 SQLCMD를 시작하지 않으므로 SQLCMD 모드에서 쿼리 편집기를 실행할 때 몇 가지 제한 사항이 있습니다. 변수와 같은 명령줄 매개 변수를 전달할 수 없으며 쿼리 편집기가 운영 체제 프롬프트에 응답할 수 없으므로 대화형 문을 실행하지 않도록 주의해야 합니다.

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 유틸리티