Поделиться через

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

  • Статья

Область применения: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 ] <экземпляр-имя><версия-экземпляра> [-s]

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

[ поделиться | h ]

Делает указанный частный экземпляр LocalDB общим, используя указанное общее имя. Если идентификатор безопасности пользователя или имя учетной записи не указаны, используется значение по умолчанию — имя текущего пользователя.

[ отменить доступ | u ]

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

[ delete | d ] <имя экземпляра>

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

[ start | s ] "<имя> экземпляра"

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

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

Останавливает указанный экземпляр SQL Server Express LocalDB. Добавление -i делает запрос на выключение экземпляра с параметром NOWAIT. Добавление -k завершает процесс экземпляра без взаимодействия с ним.

[ информация | i ] [ <instance-name> ]

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

<имя> экземпляра возвращает имя, версию, состояние (Запущено или Остановлено), время последнего запуска для указанного экземпляра SQL Server Express LocalDB и имя канала LocalDB.

[ трассировка | t ] включено | выключено

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

-?

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

Замечания

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

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

Операции, кроме запуска, могут выполняться только на экземпляре, принадлежащем пользователю, вошедшему в систему. Экземпляр SQLLOCALDB, если он является общим, может быть запущен и остановлен только владельцем экземпляра.

Примеры

А. Создание экземпляра 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>

См. также