osql 유틸리티

아티클
07/12/2024

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

osql 유틸리티를 사용하여 Transact-SQL 문, 시스템 프로시저 및 스크립트 파일을 입력할 수 있습니다. 이 유틸리티는 ODBC를 사용하여 서버와 통신합니다.

Important

SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 sqlcmd를 사용합니다. 자세한 내용은 sqlcmd 유틸리티를 참조하세요.

구문

  
osql  
[-?] |  
[-L] |  
[  
  {  
     {-Ulogin_id [-Ppassword]} | -E }  
     [-Sserver_name[\instance_name]] [-Hwksta_name] [-ddb_name]  
     [-ltime_out] [-ttime_out] [-hheaders]  
     [-scol_separator] [-wcolumn_width] [-apacket_size]  
     [-e] [-I] [-D data_source_name]  
     [-ccmd_end] [-q "query"] [-Q"query"]  
     [-n] [-merror_level] [-r {0 | 1}]  
     [-iinput_file] [-ooutput_file] [-p]  
     [-b] [-u] [-R] [-O]  
]

인수

-?
osql 스위치의 구문 요약을 표시합니다.

-L
로컬로 구성된 서버와 네트워크에서 브로드캐스팅 중인 서버의 이름을 나열합니다.

참고

네트워크상 브로드캐스팅의 특성으로 인해 osql은 모든 서버에서 적시에 응답을 받지 못할 수 있습니다. 따라서 반환되는 서버 목록은 이 옵션의 호출마다 다를 수 있습니다.

-U login_id
사용자 로그인 ID입니다. 로그인 ID는 대/소문자를 구분합니다.

-P password
사용자가 지정한 비밀번호입니다. -P 옵션을 사용하지 않으면 osql에서 비밀번호를 묻는 메시지를 표시합니다. 암호를 입력하지 않고 명령 프롬프트의 마지막에 -P 옵션을 사용하면 osql 은 기본 비밀번호인 NULL을 사용합니다.

Important

빈 비밀번호를 사용하지 마세요. 강력한 비밀번호를 사용하세요. 자세한 내용은 강력한 비밀번호를 참조하세요.

비밀번호는 대소문자를 구분합니다.

OSQLPASSWORD 환경 변수를 사용하면 현재 세션에 대한 기본 비밀번호를 설정할 수 있습니다. 그러므로 비밀번호를 배치 파일로 하드 코딩할 필요가 없습니다.

-P 옵션을 사용하여 비밀번호를 지정하지 않으면 osql은 먼저 OSQLPASSWORD 변수를 확인합니다. 값을 설정하지 않으면 osql은 기본 비밀번호인 NULL을 사용합니다. 다음 예에서는 먼저 명령 프롬프트에서 OSQLPASSWORD 변수를 설정하고 osql 유틸리티에 액세스합니다.

C:\>SET OSQLPASSWORD=abracadabra  
C:\>osql

Important

비밀번호를 마스킹하려면 -U 옵션과 함께 -P 옵션을 지정하지 마세요. 대신 -U 옵션 및 그 외 스위치(-P를 지정하지 않음)와 함께 osql을 지정한 다음, ENTER 키를 누르면 osql이 비밀번호를 묻는 메시지를 표시합니다. 이 방법을 사용하면 비밀번호 입력 시 비밀번호가 마스킹됩니다.

-E
비밀번호를 요청하는 대신 신뢰할 수 있는 연결을 사용합니다.

-S server_name[ \instance_name]
연결할 SQL Server 인스턴스를 지정합니다. 해당 서버에 있는 SQL Server의 기본 인스턴스에 연결하려면 server_name을 지정합니다. 해당 서버에 있는 명명된 SQL Server 인스턴스에 연결하려면 server_name\instance_name을 지정합니다. 서버 컴퓨터를 지정하지 않으면 osql이 로컬 컴퓨터에 있는 SQL Server의 기본 인스턴스에 연결됩니다. 이 옵션은 네트워크의 원격 컴퓨터에서 osql을 실행할 때 필요합니다.

-H wksta_name
워크스테이션 이름입니다. 워크스테이션 이름은 sysprocesses.hostname에 저장되고 sp_who에 의해 표시됩니다. 이 옵션을 지정하지 않으면 현재 컴퓨터 이름으로 간주됩니다.

-d db_name
osql이 시작되면 USE db_name 문을 실행합니다.

-l time_out
osql 로그인 시간이 초과되기 전의 시간(초)을 지정합니다. osql 로그인에 대한 기본 제한 시간은 8초입니다.

-t time_out
명령 시간이 초과되기 전의 시간(초)을 지정합니다. time_out 값을 지정하지 않으면 명령 시간이 초과되지 않습니다.

-h headers
열 제목 사이에 인쇄할 행 수를 지정합니다. 기본적으로 각 쿼리 결과 세트마다 제목을 한 번 인쇄합니다. 머리글을 인쇄하지 않으려면 -1을 사용합니다. -1을 사용하는 경우에는 매개 변수와 설정 사이에 공백이 없어야 합니다(올바른 예: -h-1, 잘못된 예: -h -1).

-s col_separator
기본적으로 공백인 열 구분 문자를 지정합니다. 운영 체제에서 특별한 의미를 갖는 문자(예: | ; & <>)를 사용하려면 해당 문자를 큰따옴표(")로 묶습니다.

-w column_width
사용자가 출력에 대한 화면 너비를 설정할 수 있습니다. 기본값은 80자입니다. 출력 줄이 최대 화면 너비에 도달하면 여러 줄로 구분됩니다.

-a packet_size
다른 크기의 패킷을 요청할 수 있습니다. packet_size에 유효한 값은 512~65,535입니다. 기본값 osql은 서버 기본값입니다. 패킷 크기가 증가하면 GO 명령 간의 SQL 문 양이 상당할 경우 규모가 더 큰 스크립트 실행에 대한 성능을 향상할 수 있습니다. Microsoft 테스트는 8,192가 일반적으로 대량 복사 작업에 가장 빠른 설정임을 나타냅니다. 더 큰 패킷 크기를 요청할 수 있지만 요청한 크기를 허용하지 않으면 osql이 서버 기본값을 사용합니다.

-e
입력을 화면에 표시합니다.

-I
QUOTED_IDENTIFIER 연결 옵션을 ON으로 설정합니다.

-D data_source_name
SQL Server용 ODBC 드라이버를 사용하여 정의된 ODBC 데이터 원본에 연결합니다. osql 연결은 데이터 원본에 지정된 옵션을 사용합니다.

참고

이 옵션은 다른 드라이버에 대해 정의된 데이터 원본에는 작동하지 않습니다.

-c cmd_end
명령 종료자를 지정합니다. 기본적으로 줄에 GO만 단독으로 입력하면 명령이 종료되어 SQL Server로 보내집니다. 명령 종료자를 다시 설정할 때는 앞에 백슬래시가 있더라도 Transact-SQL 예약어 또는 운영 체제와 연관된 특별한 의미를 가진 문자를 사용하지 마세요.

-q " query "
osql이 시작될 때 쿼리를 실행하지만 쿼리가 완료되면 osql을 종료하지 않습니다. (쿼리 문에는 GO가 포함되어서는 안 됩니다.) 배치 파일에서 쿼리를 실행한 경우 %variables 또는 환경 %variables%를 사용합니다. 예시:

SET table=sys.objects  
osql -E -q "select name, object_id from %table%"

쿼리는 큰따옴표로 묶고 쿼리 안에 포함되는 모든 것은 작은따옴표로 묶습니다.

-Q" query "
쿼리를 실행하고 osql을 즉시 종료합니다. 쿼리는 큰따옴표로 묶고 쿼리 안에 포함되는 모든 것은 작은따옴표로 묶습니다.

-n
입력 줄에서 번호 및 프롬프트 기호(>)를 제거합니다.

-m error_level
오류 메시지 표시를 사용자 지정합니다. 지정된 심각도 수준 이상의 오류에 대한 메시지 번호, 상태 및 오류 수준이 표시됩니다. 지정한 수준보다 낮은 심각도의 오류에 대해서는 표시되지 않습니다. -1을 사용하여 모든 머리글을 메시지(정보 메시지도 포함)와 함께 반환합니다. -1을 사용하는 경우에는 -m -1이 아니라 -m-1과 같이 매개 변수와 설정 사이에 공백이 없어야 합니다.

-r { 0| 1}
메시지 출력을 화면으로 리디렉션합니다(stderr). 매개 변수를 지정하지 않거나 0 을 지정하는 경우, 심각도 수준이 11 이상인 오류 메시지만 리디렉션됩니다. 1을 지정하면 “print”를 포함한 모든 오류 메시지 출력이 리디렉션됩니다.

-i input_file
SQL 문 또는 저장 프로시저의 배치가 포함된 파일을 식별합니다. -i 대신 less than(<) 비교 연산자를 사용할 수 있습니다.

-o output_file
osql에서 출력을 받는 파일을 식별합니다. -o 대신 greater than(>) 비교 연산자를 사용할 수 있습니다.

input_file이 유니코드가 아니고 -u가 지정되지 않은 경우, output_file이 OEM 형식으로 저장됩니다. input_file이 유니코드이거나 -u가 지정된 경우, output_file은 유니코드 형식으로 저장됩니다.

-p
성능 통계를 인쇄합니다.

-b
오류가 발생할 경우 osql이 종료되고 DOS ERRORLEVEL 값을 반환하도록 지정합니다. SQL Server 오류 메시지의 심각도가 11 이상이면 DOS ERRORLEVEL 변수에 1을 반환하고 아니면 0을 반환합니다. Microsoft MS-DOS 배치 파일은 DOS ERRORLEVEL 값을 테스트하여 오류를 적절하게 처리할 수 있습니다.

-u
input_file 형식에 관계없이 output_file이 유니코드 형식으로 저장되도록 지정합니다.

-R
통화, 날짜 및 시간 데이터를 문자 데이터로 변환할 때 SQL Server ODBC 드라이버에서 클라이언트 설정을 사용하도록 지정합니다.

-O
이전 버전의 isql 동작과 일치하도록 특정 osql기능을 비활성화합니다. 이러한 기능은 비활성화됩니다.

EOF 일괄 처리
자동 콘솔 너비 크기 조정
와이드 메시지

또한 기본 DOS ERRORLEVEL 값을 -1로 설정합니다.

참고

-n, -O 및 -D 옵션은 더 이상 osql에서 지원되지 않습니다.

설명

osql 유틸리티는 여기에 나열된 대/소문자 구분 옵션을 사용하여 운영 체제에서 직접 시작됩니다. osql을 시작하면 osql이 SQL 문을 받아서 대화형으로 SQL Server에 보냅니다. 결과는 서식이 지정되고 화면에 표시됩니다(stdout). QUIT 또는 EXIT를 사용하여 osql에서 종료합니다.

osql을 시작할 때 사용자 이름을 지정하지 않으면 SQL Server는 환경 변수를 확인하고 osqluser=(user) 또는 osqlserver=(server)와 같은 변수를 사용합니다. 환경 변수를 설정하지 않으면 워크스테이션 사용자 이름이 사용됩니다. 서버를 지정하지 않으면 워크스테이션 이름이 사용됩니다.

-U 또는 -P 옵션을 모두 사용하지 않는 경우 SQL Server는 Microsoft Windows 인증 모드를 사용하여 연결을 시도합니다. osql을 실행하는 사용자의 Microsoft Windows 계정을 기반으로 인증이 수행됩니다.

osql 유틸리티는 ODBC API를 사용합니다. 이 유틸리티는 SQL Server ISO 연결 옵션에 SQL Server ODBC 드라이버 기본 설정을 사용합니다. 자세한 내용은 ANSI 옵션의 효과를 참조하세요.

참고

osql 유틸리티는 CLR 사용자 정의 데이터 형식을 지원하지 않습니다. 이 데이터 형식을 처리하려면 sqlcmd 유틸리티를 사용해야 합니다. 자세한 내용은 sqlcmd 유틸리티를 참조하세요.

OSQL 명령

osql 내에서 Transact-SQL 문 외에 다음 명령을 사용할 수 있습니다.

명령	설명
GO	마지막 GO 이후에 입력한 모든 문을 실행합니다.
RESET	입력한 문을 지웁니다.
QUIT 또는 EXIT( )	osql에서 종료합니다.
Ctrl+C	osql에서 종료하지 않고 쿼리를 종료합니다.

참고

!! 및 ED 명령은 더 이상 osql에서 지원되지 않습니다.

명령 종료료자인 GO(기본), RESET EXIT, QUIT 및 CTRL+C는 osql 프롬프트 바로 뒤의 줄 시작 부분에 나올 때만 인식합니다.

GO는 배치의 끝과 캐시된 Transact-SQL 문의 실행을 모두 신호로 표시합니다. 각 입력 줄의 끝에서 Enter 키를 누르면 osql은 해당 줄에 문을 캐시합니다. GO를 입력한 후 Enter 키를 누르면 현재 캐시된 모든 문이 SQL Server에 배치로 전송됩니다.

현재 osql 유틸리티는 실행된 스크립트의 끝에 묵시적 GO가 있는 것처럼 작동하므로 스크립트의 모든 문이 실행됩니다.

명령 종료자로 시작하는 줄을 입력하여 명령을 종료합니다. 정수로 된 명령 종료자를 따라 명령을 실행할 횟수를 지정할 수 있습니다. 예를 들어 이 명령을 100번 실행하려면 다음을 입력합니다.

SELECT x = 1  
GO 100

결과는 실행이 끝날 때 한 번 인쇄됩니다. osql은 줄당 1,000자 이상을 허용하지 않습니다. 큰 문은 여러 줄로 분산되어야 합니다.

Windows의 명령 회수 기능을 사용하여 osql 문을 회수하고 수정할 수 있습니다. RESET을 입력하여 기존 쿼리 버퍼를 지울 수 있습니다.

저장 프로시저를 실행할 때 osql은 각 결과 세트 사이에 있는 빈 줄을 배치로 인쇄합니다. 또한 "영향을 받는 행 0개" 메시지는 실행된 문에 적용되지 않을 때는 표시되지 않습니다.

대화형으로 osql 사용

osql을 대화형으로 사용하려면 명령 프롬프트에 osql 명령(및 옵션)을 입력합니다.

다음과 유사한 명령을 입력하여 osql로 실행할 쿼리(예: Stores.qry)가 포함된 파일에서 읽을 수 있습니다.

osql -E -i stores.qry

쿼리(예: Titles.qry)가 포함된 파일에서 읽고 다음과 유사한 명령을 입력하여 결과를 다른 파일로 보낼 수 있습니다.

osql -E -i titles.qry -o titles.res

Important

가능하면 -E 옵션(신뢰할 수 있는 연결)을 사용합니다.

osql을 대화형으로 사용하면 :rfile_name을 지정하여 운영 체제 파일을 명령 버퍼로 읽을 수 있습니다. 이렇게 하면 file_name 내의 SQL 스크립트를 단일 배치로 서버에 직접 보내게 됩니다.

참고

osql을 사용하는 경우, SQL Server는 SQL 스크립트 파일에 표시되는 배치 구분 기호 GO를 구문 오류로 처리합니다.

메모 삽입

osql을 통해 SQL Server에 제출된 Transact-SQL 문에 메모를 포함할 수 있습니다. 허용되는 두 가지 메모 유형은 -- 및 /*...*/입니다.

EXIT를 사용하여 osql에서 결과 반환

SELECT 문의 결과를 osql의 반환 값으로 사용할 수 있습니다. 숫자인 경우 마지막 결과 행의 마지막 열이 4바이트 정수(long)로 변환됩니다. MS-DOS는 하위 바이트를 부모 프로세스 또는 운영 체제 오류 수준에 전달합니다. Windows가 전체 4 바이트 정수를 전달합니다. 구문은 다음과 같습니다.

EXIT ( < query > )

예시:

EXIT(SELECT @@ROWCOUNT)

배치 파일의 일부로 EXIT 매개 변수를 포함할 수도 있습니다. 예시:

osql -E -Q "EXIT(SELECT COUNT(*) FROM '%1')"

osql 유틸리티는 괄호() 안에 입력한 모든 내용을 서버에 전달합니다. 저장된 시스템 프로시저가 집합을 선택하고 값을 반환하는 경우 선택 항목만 반환됩니다. EXIT**()** 문의 괄호 사이에 아무 것도 없으면 이 문 앞에 나오는 모든 문을 실행한 다음 값을 반환하지 않고 종료합니다.

4개의 EXIT 형식이 있습니다.

EXIT

참고

일괄 처리를 실행하지 않고 즉시 종료하며 값을 반환하지 않습니다.

EXIT**()**

참고

배치를 실행한 다음 종료하고 값을 반환하지 않습니다.

EXIT**(query)**

참고

쿼리를 포함하는 배치를 실행한 다음 쿼리 결과를 반환한 후 종료합니다.

상태가 127인 RAISERROR

참고

osql 스크립트 내에서 RAISERROR를 사용하고 상태가 127인 경우 osql은 종료되고 메시지 ID를 클라이언트에 다시 반환합니다. 예시:

RAISERROR(50001, 10, 127)

이 오류가 발생하면 osql 스크립트가 종료되고 메시지 ID 50001이 클라이언트에 반환됩니다.

-1부터 -99까지의 반환 값은 SQL Server에 의해 예약되어 있습니다. osql 에는 다음의 값이 정의되어 있습니다.

-100

반환 값을 선택하기 전에 오류가 발생했습니다.
-101

반환 값을 선택할 때 행을 찾을 수 없습니다.
-102

반환 값을 선택할 때 변환 오류가 발생했습니다.

money 및 smallmoney 데이터 형식 표시

SQL Server는 내부적으로 네 개의 소수 자릿수로 값을 저장하지만 osql은 두 개의 소수 자릿수로 money 및 smallmoney 데이터 형식을 표시합니다. 예를 들어, 다음과 같습니다.

SELECT CAST(CAST(10.3496 AS money) AS decimal(6, 4))  
GO

이 문은 값이 모든 소수 자릿수 그대로 저장됨을 나타내는 10.3496의 결과를 생성합니다.

추가 참고

메모(MDX)
-- (메모)(MDX)
CAST 및 CONVERT(Transact-SQL)
RAISERROR(Transact-SQL)

다음을 통해 공유

osql 유틸리티

구문

인수

설명

OSQL 명령

대화형으로 osql 사용

메모 삽입

EXIT를 사용하여 osql에서 결과 반환

money 및 smallmoney 데이터 형식 표시

추가 참고

피드백

피드백

추가 리소스