SqlLocalDB 实用工具

项目
05/30/2023

使用 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 使用由 <instance-version> 参数指定的 SQL Server Express 版本的二进制文件。版本号以数字格式指定，至少有一个小数点。次要版本号 (Service Pack）是可选的。例如，下面的两个版本号均可接受：11.0 或 11.0.1186。必须在计算机上安装指定的版本。如果未指定，版本号默认为 SqlLocalDB 实用工具的版本。添加 -s 可启动 LocalDB 的新实例。

使用指定的共享名称共享指定的 LocalDB 私有实例。如果省略该用户 SID 或帐户名称，则默认为当前用户。

[ 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 实例。添加 -i 可请求使用 NOWAIT 选项关闭该实例。添加 -k 可终止该实例进程而不联系它。

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

列出当前用户拥有的所有 SQL Server Express LocalDB 实例。

<instance-name> 返回指定的 SQL Server ExpressLocalDB 实例的名称、版本、状态（正在运行或已停止）、上次启动时间，以及 LocalDB 的本地管道名称。

[ trace | t ] on | off

trace on 为当前用户启用针对 SqlLocalDB API 调用的跟踪。 trace off 禁用跟踪。

`-?`

返回每个 SqlLocalDB 选项的简短说明。

备注

实例名称 参数必须遵循 SQL Server 标识符规则，或者必须将该参数放入双引号。

执行不带参数的 SqlLocalDB 将返回帮助文档。

只能在属于当前已登录用户的实例上执行启动以外的其他操作。共享的 SQLLOCALDB 实例只能由该实例的所有者启动和停止。

示例

A. 创建 LocalDB 的实例

下面的示例使用 SQL Server 二进制文件创建了一个名为 DEPARTMENT 的 SQL Server Express LocalDB 实例，并启动该实例。

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