Служебная программа SqlLocalDB

2025-04-13

Область применения:SQL Server

Используйте служебную программу SqlLocalDB для создания экземпляра SQL Server Express LocalDB. Служебная программа SqlLocalDB (SqlLocalDB.exe) — это средство командной строки, позволяющее пользователям и разработчикам создавать экземпляр SQL Server Express LocalDB и управлять ими. Сведения об использовании LocalDB см. в разделе SQL Server 2016 Express LocalDB.

Синтаксис

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     | -? ]
}

Аргументы

[ create | c ] <instance-name><instance-version> [-s ]

Создает новый экземпляр SQL Server Express LocalDB. В SqlLocalDB используется версия двоичных файлов SQL Server Express, указанная в аргументе <instance-version>. Номер версии задается в числовом формате и содержит хотя бы один знак после разделителя. The minor version numbers (service packs) are optional. Например, следующие два номера версии будут допустимыми: 11.0 и 11.0.1186. Указываемая версия должна быть установлена на компьютере. Если номер версии не указан, то по умолчанию используется версия программы SqlLocalDB . Добавление -s запускает новый экземпляр LocalDB.

Shares the specified private instance of LocalDB using the specified shared name. Если идентификатор безопасности пользователя или имя учетной записи не указаны, используется значение по умолчанию — имя текущего пользователя.

[ unshare | u ]

Отменяет общий доступ к указанному экземпляру LocalDB.

[ delete | d ] <instance-name>

Удаляет указанный экземпляр SQL Server Express LocalDB.

[ start | s ] "<instance-name>"

Запускает указанный экземпляр SQL Server Express LocalDB. В случае успешного завершения инструкция возвращает адрес именованного канала LocalDB.

[ stop | p ] <instance-name> [-i ] [-k ]

Останавливает указанный экземпляр SQL Server Express LocalDB. Adding -i requests the instance shutdown with the NOWAIT option. Adding -k kills the instance process without contacting it.

[ info | i ] [ <instance-name> ]

Выводит список всех экземпляров SQL Server Express LocalDB , принадлежащих текущему пользователю.

<instance-name> returns the name, version, state (Running or Stopped), last start time for the specified instance of SQL Server Express LocalDB, and the local pipe name of the LocalDB.

[ trace | t ] on | off

Параметрtrace on включает трассировку вызовов API SqlLocalDB для текущего пользователя. Параметрtrace off отключает трассировку.

`-?`

Возвращает краткое описание каждого параметра SqlLocalDB .

Замечания

Имя экземпляра должно соответствовать правилам идентификаторов SQL Server или быть заключено в двойные кавычки.

Выполнение SqlLocalDB без аргументов возвращает текст справки.

Операции, кроме запуска, могут выполняться только на экземпляре, принадлежащем пользователю, вошедшему в систему. A SQLLOCALDB instance, when shared, can only be started and stopped by the owner of the instance.

Примеры

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

В следующем примере создается экземпляр SQL Server Express LocalDB с именем DEPARTMENT, который запускается с помощью компонентов SQL Server.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Работа с общим экземпляром LocalDB

Откройте командную строку с правами доступа администратора. Замените <password> допустимым паролем.

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 = '<password>';
GO
CREATE USER NewLogin;
GO
EXIT

Выполните следующий код, чтобы подключиться к общему экземпляру LocalDB с использованием имени входа NewLogin . Замените <password> допустимым паролем.

sqlcmd -S (localdb)\.\DeptSharedLocalDB -U NewLogin -P <password>