Бөлісу құралы:


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

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

Используйте служебную программу SqlLocalDB для создания экземпляра SQL Server Express LocalDB. Служебная программа SqlLocalDB (SqlLocalDB.exe) — это средство командной строки, позволяющее пользователям и разработчикам создавать экземпляр SQL Server Express LocalDB и управлять ими. Сведения об использовании LocalDB см. в статье SQL Server 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 ] "<instance-name>"

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

[ stop | p ] <имя> экземпляра [ -i ] [ -k ]

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

[ информация | i ] [ <имя> экземпляра ]

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

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

[ трассировка | t ] { вкл. | выкл. }

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

-?

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

Замечания

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

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

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

Примеры

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>