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

Статья
10/20/2023

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

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

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

[ unshare | u ]

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

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

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

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

Запускает указанный экземпляр 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 доступ, может быть запущен и остановлен владельцем экземпляра.

Примеры

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

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

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

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

Откройте командную строку с правами доступа администратора.

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 .

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

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