SqlLocalDB 유틸리티SqlLocalDB Utility

이 항목 적용 대상: 예SQL Server없습니다Azure SQL 데이터베이스없습니다Azure SQL 데이터 웨어하우스 없습니다 병렬 데이터 웨어하우스THIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse 사용 하 여는 SqlLocalDB 유틸리티의 인스턴스를 만드는 MicrosoftMicrosoft SQL Server 2016 ExpressSQL Server 2016 Express LocalDB합니다. Use the SqlLocalDB utility to create an instance of MicrosoftMicrosoft SQL Server 2016 ExpressSQL Server 2016 ExpressLocalDB. SqlLocalDB 유틸리티(SqlLocalDB.exe)는 사용자와 개발자가 SQL Server ExpressSQL Server ExpressLocalDB의 인스턴스를 만들고 관리하는 데 사용할 수 있는 간단한 명령줄 도구입니다.The SqlLocalDB utility (SqlLocalDB.exe) is a simple command line tool to enable users and developers to create and manage an instance of SQL Server ExpressSQL Server ExpressLocalDB. LocalDB를 사용하는 방법에 대한 자세한 내용은 SQL Server 2016 Express LocalDB를 참조하세요.For information about how to use LocalDB, see SQL Server 2016 Express LocalDB.

구문Syntax

SqlLocalDB.exe   
{  
      [ create   | c ] \<instance-name>  \<instance-version> [-s ]  
    | [ delete   | d ] \<instance-name>  
    | [ start    | s ] \<instance-name>  
    | [ stop     | p ] \<instance-name>  [ -i ] [ -k ]  
    | [ share    | h ] [" <user_SID> " | " <user_account> " ] " \<private-name> " " \<shared-name> "  
    | [ unshare  | u ] " \<shared-name> "  
    | [ info     | i ] \<instance-name>  
    | [ versions | v ]  
    | [ trace    | t ] [ on | off ]  
    | [ help     | -? ]  
}  

인수Arguments

[ create | c ] <instance-name> <instance-version> [-s ][ create | c ] <instance-name> <instance-version> [-s ]
SQL Server ExpressSQL Server ExpressLocalDB의 새 인스턴스를 만듭니다.Creates a new of instance of SQL Server ExpressSQL Server ExpressLocalDB. SqlLocalDB 의 버전을 사용 하 여 SQL Server ExpressSQL Server Express 로 지정 된 바이너리 <인스턴스 버전 > 인수입니다.SqlLocalDB uses the version of SQL Server ExpressSQL Server Express binaries specified by <instance-version> argument. 버전 번호는 하나 이상의 숫자를 포함하는 숫자 형식으로 지정됩니다.The version number is specified in numeric format with at least one decimal. 부 버전 번호(서비스 팩)는 선택 사항입니다.The minor version numbers (service packs) are optional. 예를 들어 버전 번호 11.0 또는 11.0.1186은 모두 허용됩니다.For example the following two version numbers are both acceptable: 11.0, or 11.0.1186. 지정된 버전을 컴퓨터에 설치해야 합니다.The specified version must be installed on the computer. 지정하지 않으면 버전 번호는 기본적으로 SqlLocalDB 유틸리티 버전으로 지정됩니다.If not specified, the version number defaults to the version of the SqlLocalDB utility. –s 를 추가하여 LocalDB의 새 인스턴스를 시작합니다.Adding –s starts the new instance of LocalDB.

[ share | h ][ share | h ]
지정한 공유 이름을 사용하여 지정한 개인 LocalDB 인스턴스를 공유합니다.Shares the specified private instance of LocalDB using the specified shared name. 사용자 SID 또는 계정 이름을 생략하면 기본값으로 현재 사용자가 사용됩니다.If the user SID or account name is omitted, it defaults to the current user.

[ unshared | u ][ unshared | u ]
LocalDB의 지정된 공유 인스턴스의 공유를 중지합니다.Stops the sharing of the specified shared instance of LocalDB.

[ delete | d ] <instance-name>[ delete | d ] <instance-name>
SQL Server ExpressSQL Server ExpressLocalDB의 지정된 인스턴스를 삭제합니다.Deletes the specified instance of SQL Server ExpressSQL Server ExpressLocalDB.

[ start | s ] "<instance-name>"[ start | s ] "<instance-name>"
SQL Server ExpressSQL Server ExpressLocalDB의 지정된 인스턴스를 시작합니다.Starts the specified instance of SQL Server ExpressSQL Server ExpressLocalDB. 성공하면 문이 LocalDB의 명명된 파이프 주소를 반환합니다.When successful the statement returns the named pipe address of the LocalDB.

[ stop | p ] <instance-name> [-i ] [-k ][ stop | p ] <instance-name> [-i ] [-k ]
SQL Server ExpressSQL Server ExpressLocalDB의 지정된 인스턴스를 중지합니다.Stops the specified instance of SQL Server ExpressSQL Server ExpressLocalDB. –iNOWAIT 옵션과 함께 추가하여 인스턴스 종료를 요청합니다.Adding –i requests the instance shutdown with the NOWAIT option. –k 를 추가하면 인스턴스 프로세스에 연결하지 않고 해당 프로세스를 중지합니다.Adding –k kills the instance process without contacting it.

[ info | i ] [ <instance-name> ][ info | i ] [ <instance-name> ]
현재 사용자가 소유한 SQL Server ExpressSQL Server ExpressLocalDB 의 모든 인스턴스를 나열합니다.Lists all instance of SQL Server ExpressSQL Server ExpressLocalDB owned by the current user.

<인스턴스 이름 > 이름을 반환 버전, 상태 (실행 중 또는 중지됨인), 마지막 시작 되는 지정된 된 인스턴스에 대 한 시간 SQL Server ExpressSQL Server Express LocalDB, 및의 로컬 파이프 이름을 LocalDB합니다.<instance-name> returns the name, version, state (Running or Stopped), last start time for the specified instance of SQL Server ExpressSQL Server ExpressLocalDB, and the local pipe name of the LocalDB.

[ trace | t ] on | off[ trace | t ] on | off
trace on을 사용하여 현재 사용자에 대한 SqlLocalDB API 호출을 추적할 수 있습니다.trace on enables tracing for the SqlLocalDB API calls for the current user. trace off 를 사용하면 추적이 사용되지 않습니다.trace off disables tracing.

-?-?
SqlLocalDB 옵션에 대한 간략한 설명을 반환합니다.Returns brief descriptions of each SqlLocalDB option.

주의Remarks

instance name 인수는 SQL ServerSQL Server 식별자에 대한 규칙을 따르거나 큰따옴표로 묶어야 합니다.The instance name argument must follow the rules for SQL ServerSQL Server identifiers or it must be enclosed in double quotes.

인수 없이 SqlLocalDB를 실행하면 도움말 텍스트가 반환됩니다.Executing SqlLocalDB without arguments returns the help text.

시작 이외의 작업은 현재 로그인한 사용자에 속하는 인스턴스에 대해서만 수행할 수 있습니다.Operations other than start can only be performed on an instance belonging to currently logged in user. SQLLOCALDB 인스턴스는 공유하는 경우 인스턴스 소유자만 시작하고 중지할 수 있습니다.An SQLLOCALDB Instance, when shared, can only be started and stopped by the owner of the instance.

Examples

1.A. LocalDB의 인스턴스 만들기Creating an Instance of LocalDB

다음 예에서는 SQL Server ExpressSQL Server Express바이너리를 사용하여 라는 DEPARTMENT LocalDB SQL Server 2017SQL Server 2017 의 인스턴스를 만든 다음 인스턴스를 시작합니다.The following example creates an instance of SQL Server ExpressSQL Server ExpressLocalDB named DEPARTMENT using the SQL Server 2017SQL Server 2017 binaries and starts the instance.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s  

2.B. LocalDB의 공유 인스턴스 작업Working with a Shared Instance of LocalDB

관리자 권한을 사용하여 명령 프롬프트를 엽니다.Open a command prompt using Administrator privileges.

SqlLocalDB.exe create "DeptLocalDB"  
SqlLocalDB.exe share "DeptLocalDB" "DeptSharedLocalDB"  
SqlLocalDB.exe start "DeptLocalDB"  
SqlLocalDB.exe info "DeptLocalDB"  
REM The previous statement outputs the Instance pipe name for the next step  
sqlcmd –S np:\\.\pipe\LOCALDB#<use your pipe name>\tsql\query  
CREATE LOGIN NewLogin WITH PASSWORD = 'Passw0rd!!@52';   
GO  
CREATE USER NewLogin;  
GO  
EXIT  

다음 코드를 실행해서 로그인을 사용하여 LocalDB NewLogin 의 공유 인스턴스에 연결합니다.Execute the following code to connect to the shared instance of LocalDB using the NewLogin login.

sqlcmd –S (localdb)\.\DeptSharedLocalDB -U NewLogin -P Passw0rd!!@52  

관련 항목:See Also

SQL Server 2016 Express LocalDBSQL Server 2016 Express LocalDB
명령줄 관리 도구: SqlLocalDB.exeCommand-Line Management Tool: SqlLocalDB.exe