내보내기(0) 인쇄
모두 확장
이 문서는 수동으로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

Invoke-Sqlcmd cmdlet

Invoke-Sqlcmd는 Transact-SQL 및 XQuery 언어로 된 문과 sqlcmd 유틸리티에서 지원되는 명령이 포함된 스크립트를 실행하는 SQL Server cmdlet입니다.

Invoke-Sqlcmd cmdlet을 사용하여 sqlcmd 스크립트 파일을 Windows PowerShell 환경에서 실행할 수 있습니다. sqlcmd로 할 수 있는 많은 작업을 Invoke-Sqlcmd로도 수행할 수 있습니다.

다음은 Invoke-Sqlcmd를 호출하여 간단한 쿼리를 실행하는 예입니다. 이는 sqlcmd-Q-S 옵션을 지정하는 것과 유사합니다.

Invoke-Sqlcmd -Query "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance "MyComputer\MyInstance"

다음은 Invoke-Sqlcmd를 호출하고 입력 파일을 지정한 후 출력을 파일로 파이핑하는 예입니다. 이는 sqlcmd-i-o 옵션을 지정하는 것과 유사합니다.

Invoke-Sqlcmd -InputFile "C:\MyFolder\TestSQLCmd.sql" | Out-File -filePath "C:\MyFolder\TestSQLCmd.rpt"

다음은 Windows PowerShell 배열을 사용하여 여러 개의 sqlcmd 스크립팅 변수를 Invoke-Sqlcmd로 전달하는 예입니다. SELECT 문에서 sqlcmd 스크립팅 변수를 식별하는 "$" 문자는 PowerShell 역따옴표(`) 이스케이프 문자를 사용하여 이스케이프 처리되었습니다.

$MyArray = "MyVar1 = 'String1'", "MyVar2 = 'String2'"
Invoke-Sqlcmd -Query "SELECT `$(MyVar1) AS Var1, `$(MyVar2) AS Var2;" -Variable $MyArray

다음은 Windows PowerShell의 SQL Server 공급자를 사용하여 데이터베이스 엔진 인스턴스로 이동한 다음 Windows PowerShell Get-Item cmdlet을 사용하여 해당 인스턴스에 대한 SMO Server 개체를 가져와 Invoke-Sqlcmd로 전달하는 예입니다.

Set-Location SQLSERVER:\SQL\MyComputer\MyInstance
Invoke-Sqlcmd -Query "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance (Get-Item .)

-Query 매개 변수는 위치 매개 변수이며 이름을 지정할 필요가 없습니다. Invoke-Sqlcmd로 전달된 첫 번째 문자열이 이름이 지정되지 않은 경우 해당 문자열을 -Query 매개 변수로 처리합니다.

Invoke-Sqlcmd "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance "MyComputer\MyInstance"

-Database 매개 변수를 사용하지 않는 경우 Invoke-Sqlcmd에 대한 데이터베이스 컨텍스트는 cmdlet을 호출할 때 활성화된 경로에 의해 설정됩니다.

경로

데이터베이스 컨텍스트

SQLSERVER: 이외의 드라이브로 시작

로컬 컴퓨터에 있는 기본 인스턴스의 로그인 ID에 대한 기본 데이터베이스입니다.

SQLSERVER:\SQL

로컬 컴퓨터에 있는 기본 인스턴스의 로그인 ID에 대한 기본 데이터베이스입니다.

SQLSERVER:\SQL\ComputerName

지정된 컴퓨터에 있는 기본 인스턴스의 로그인 ID에 대한 기본 데이터베이스입니다.

SQLSERVER:\SQL\ComputerName\InstanceName

지정된 컴퓨터에 있는 지정된 인스턴스의 로그인 ID에 대한 기본 데이터베이스입니다.

SQLSERVER:\SQL\ComputerName\InstanceName\Databases

지정된 컴퓨터에 있는 지정된 인스턴스의 로그인 ID에 대한 기본 데이터베이스입니다.

SQLSERVER:\SQL\ComputerName\InstanceName\Databases\DatabaseName

지정된 컴퓨터에 있는 지정된 인스턴스의 지정된 데이터베이스입니다. 이는 또한 데이터베이스 내의 테이블 및 열 노드를 지정하는 경로와 같은 보다 긴 경로에 적용됩니다.

예를 들어 로컬 컴퓨터의 기본 인스턴스에 있는 Windows 계정에 대한 기본 데이터베이스가 master라고 가정합니다. 그러면 다음 명령에서 master를 반환합니다.

Set-Location SQLSERVER:\SQL
Invoke-Sqlcmd "SELECT DB_NAME() AS DatabaseName;"

다음 명령에서 AdventureWorks2012 를 반환합니다.

Set-Location SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2012\Tables\Person.Person
Invoke-Sqlcmd "SELECT DB_NAME() AS DatabaseName;"

Invoke-Sqlcmd에서 경로 데이터베이스 컨텍스트를 사용하는 경우 경고를 제공합니다. -SuppressProviderContextWarning 매개 변수를 사용하여 경고 메시지를 해제할 수 있습니다. -IgnoreProviderContext 매개 변수를 사용하여 Invoke-Sqlcmd에서 로그인에 대한 기본 데이터베이스를 항상 사용하도록 지정할 수 있습니다.

Invoke-Sqlcmd를 사용하면 sqlcmd 유틸리티로 실행할 수 있는 많은 스크립트를 실행할 수 있습니다. 하지만 Invoke-Sqlcmdsqlcmd가 실행되는 명령 프롬프트 환경과 다른 Windows PowerShell 환경에서 실행됩니다. Invoke-Sqlcmd의 동작은 Windows PowerShell 환경에서 작동하도록 수정되었습니다.

모든 sqlcmd 명령이 Invoke-Sqlcmd에서 구현되는 것은 아닙니다. 구현되지 않는 명령으로는 :!!, :connect, :error, :out, :ed, :list, :listvar, :reset, :perftrace:serverlist가 있습니다.

Invoke-Sqlcmdsqlcmd 환경 변수나 SQLCMDDBNAME 또는 SQLCMDWORKSTATION 같은 스크립팅 변수를 초기화하지 않습니다.

Invoke-Sqlcmd는 Windows PowerShell -Verbose 공통 매개 변수를 지정해야 PRINT 문 출력과 같은 메시지를 표시합니다. 예를 들면 다음과 같습니다.

Invoke-Sqlcmd -Query "PRINT N'abc';" -Verbose

모든 sqlcmd 매개 변수가 PowerShell 환경에서 필요한 것은 아닙니다. 예를 들어 Windows PowerShell은 cmdlet의 모든 출력 서식을 지정하므로 서식 옵션을 지정하는 sqlcmd 매개 변수는 Invoke-Sqlcmd에서 구현되지 않습니다. 다음 표에서는 Invoke-Sqlcmd 매개 변수와 sqlcmd 옵션의 관계를 보여 줍니다.

설명

sqlcmd 옵션

Invoke-Sqlcmd 매개 변수

서버 및 인스턴스 이름

-S

-ServerInstance

사용할 초기 데이터베이스

-d

-Database

지정된 쿼리 실행 후 종료

-Q

-Query

SQL Server 인증 로그인 ID

-U

-Username

SQL Server 인증 암호

-P

-Password

변수 정의

-v

-Variable

쿼리 제한 시간 간격

-t

-QueryTimeout

오류 발생 시 실행 중지

-b

-AbortOnError

관리자 전용 연결

-A

-DedicatedAdministratorConnection

대화형 명령, 시작 스크립트 및 환경 변수를 사용하지 않음

-X

-DisableCommands

변수 대체를 사용하지 않음

-x

-DisableVariables

보고할 최소 심각도 수준

-V

-SeverityLevel

보고할 최소 오류 수준

-m

-ErrorLevel

로그인 제한 시간 간격

-l

-ConnectionTimeout

호스트 이름

-H

-HostName

암호 변경 후 종료

-Z

-NewPassword

쿼리가 포함된 입력 파일

-i

-InputFile

최대 문자 출력 길이

-w

-MaxCharLength

최대 이진 출력 길이

-w

-MaxBinaryLength

SSL 암호화를 사용하여 연결

매개 변수 없음

-EncryptConnection

오류 표시

매개 변수 없음

-OutputSqlErrors

메시지를 stderr로 출력

-r

매개 변수 없음

클라이언트의 국가별 설정 사용

-R

매개 변수 없음

지정된 쿼리 실행 후 실행 중인 상태로 유지

-q

매개 변수 없음

출력 데이터에 사용할 코드 페이지

-f

매개 변수 없음

암호 변경 후 실행 중인 상태로 유지

-z

매개 변수 없음

패킷 크기

-a

매개 변수 없음

열 구분 기호

-s

매개 변수 없음

출력 헤더 제어

-h

매개 변수 없음

제어 문자 지정

-k

매개 변수 없음

고정 길이 표시 너비

-Y

매개 변수 없음

변수 길이 표시 너비

-y

매개 변수 없음

입력 에코

-e

매개 변수 없음

따옴표 붙은 식별자 사용

-I

매개 변수 없음

후행 공백 제거

-W

매개 변수 없음

인스턴스 나열

-L

매개 변수 없음

출력을 유니코드 형식으로 지정

-u

매개 변수 없음

통계 인쇄

-p

매개 변수 없음

명령 종료

-c

매개 변수 없음

Windows 인증을 사용하여 연결

-E

매개 변수 없음

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft