Программа SqlLocalDBSqlLocalDB Utility

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions)

Для создания экземпляра MicrosoftMicrosoftSQL Server 2016 ExpressSQL Server 2016 Express LocalDB используйте служебную программу SqlLocalDB.Use the SqlLocalDB utility to create an instance of MicrosoftMicrosoftSQL Server 2016 ExpressSQL Server 2016 Express LocalDB. Служебная программа SqlLocalDB (SqlLocalDB.exe) — это простая программа командной строки, с помощью которой пользователи и разработчики могут создавать экземпляры SQL Server ExpressSQL Server Express LocalDB и управлять ими.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 Express LocalDB. Сведения об использовании LocalDBсм. в статье Экспресс-выпуск SQL Server 2016 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, указанная в аргументе <instance-version> .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. Если идентификатор безопасности пользователя или имя учетной записи не указаны, используется значение по умолчанию — имя текущего пользователя.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. В случае добавления параметра -i запрашивается завершение работы экземпляра с параметром NOWAIT.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.

<instance-name> возвращает имя, версию, состояние (выполняется или остановлено), время последнего запуска для указанного экземпляра 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 включает трассировку вызовов API SqlLocalDB для текущего пользователя.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.

RemarksRemarks

В аргументе имя-экземпляра должны соблюдаться правила для идентификаторов 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

A.A. Создание экземпляра LocalDBCreating an Instance of LocalDB

В следующем примере экземпляр SQL Server ExpressSQL Server ExpressLocalDB с именем DEPARTMENT создается с помощью двоичных файлов SQL Server 2019 (15.x)SQL Server 2019 (15.x) , а затем запускается.The following example creates an instance of SQL Server ExpressSQL Server ExpressLocalDB named DEPARTMENT using the SQL Server 2019 (15.x)SQL Server 2019 (15.x) binaries and starts the instance.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s  

Б.B. Работа с общим экземпляром LocalDBWorking 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