通过

SQL Server Express LocalDB

  • 项目

适用于： SQL Server

Microsoft SQL Server Express LocalDB 是一种面向开发人员的 SQL Server Express 功能。 可以在带有高级服务的 SQL Server Express 版本上使用。

LocalDB 安装将复制启动 SQL Server 数据库引擎 所需的最少的文件集。 安装 LocalDB 后，你可以使用特定连接字符串来启动连接。 连接时，将自动创建并启动所需的 SQL Server 基础结构，从而使应用程序无需执行复杂的配置任务即可使用数据库。 开发人员工具可以向开发人员提供 SQL Server 数据库引擎 ，使其不必管理 SQL Server 的完整服务器实例即可撰写和测试 Transact-SQL 代码。

安装媒体

LocalDB 是在 SQL Server Express 安装过程中选择的功能，可以在下载安装介质后使用。 如果下载介质，则选择 “Express Advanced” 或 “LocalDB” 包。

使用 Visual Studio 2019 和 Visual Studio 2022 的客户应安装 SQL Server 2019 Express Edition。

LocalDB 安装程序 SqlLocalDB.msi 在安装介质中可供所有版本（Express Core 除外）使用。 它位于 <installation_media_root>\<LCID>_ENU_LP\x64\Setup\x64 文件夹中。 LCID 是区域设置标识符或语言代码。 例如，LCID 值 1033 表示 en-US 区域设置。

LocalDB 也可以通过 Visual Studio 安装程序、“数据存储和处理”工作负荷和“ASP.NET 和 Web 开发”工作负荷安装，或作为单独组件安装。

安装 LocalDB

通过安装向导或使用 SqlLocalDB.msi 程序安装 LocalDB。 LocalDB 是安装 SQL Server Express LocalDB 时的一个选项。

在安装过程中，在“功能选择/共享功能”页上选择 LocalDB。 对于每个主要 SQL Server 数据库引擎 版本，只能存在一个 LocalDB 二进制文件的安装。 可以启动多个数据库引擎流程，并且这些流程都将使用相同的二进制文件。 作为 LocalDB 启动的 SQL Server 数据库引擎实例与 SQL Server Express 具有相同限制。

SQL Server Express LocalDB 的实例通过 SqlLocalDB.exe 实用工具进行托管。 SQL Server Express LocalDB 应该用于代替已弃用的 SQL Server Express 用户实例功能。

说明

LocalDB 安装程序使用 SqlLocalDB.msi 程序在计算机上安装所需文件。 安装后，LocalDB 是可以创建和打开 SQL Server 数据库的 SQL Server Express 的实例。 数据库的系统数据库文件存储于本地 AppData 路径中，这个路径通常是隐藏的。 例如，C:\Users\<user>\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\LocalDBApp1\。 用户数据库文件存储在用户指定的位置，通常为 C:\Users\<user>\Documents\ 文件夹中的某个位置。

有关将 LocalDB 包括在应用程序中的详细信息，请参阅 Visual Studio 本地数据概述和在 Visual Studio 中创建一个数据库并添加表。

有关 LocalDB API 的详细信息，请参阅 SQL Server Express LocalDB 参考。

SqlLocalDB 实用工具可以创建 LocalDB 的新实例，启动和停止 LocalDB 的实例，并且包含可帮助你管理 LocalDB 的选项。 如需详细了解 SqlLocalDB 实用工具，请参阅 SqlLocalDB 实用工具。

将 LocalDB 的实例排序规则设置为 SQL_Latin1_General_CP1_CI_AS，并且不能更改。 一般支持数据库级、列级和表达式级排序规则。 包含的数据库遵循包含数据库的排序规则所定义的元数据和 tempdb 排序规则。

限制

  • LocalDB 不能通过 SQL Server Management Studio 进行远程管理。

  • LocalDB 不能是合并复制订阅服务器。

  • LocalDB 不支持 FILESTREAM。

  • LocalDB 仅允许 Service Broker 的本地队列。

  • 由于 Windows 文件系统重定向，NT AUTHORITY\SYSTEM 等内置帐户拥有的 LocalDB 的一个实例可能具有管理性问题。 请改用常规 Windows 帐户作为所有者。

自动实例和命名实例

LocalDB 支持两种类型的实例：自动实例和命名实例。 不同的计算机用户可具有同名的实例。 每个实例在自己的流程中作为各自的用户运行。

自动实例

LocalDB 的自动实例是公共的。 系统自动为用户创建和管理此类实例，并可由任何应用程序使用。 安装在用户计算机上的每个 LocalDB 版本都存在一个自动 LocalDB 实例。 自动 LocalDB 实例提供无缝的实例管理。 无需创建实例；它可以自动执行工作。 此功能使得应用程序可以轻松地安装和迁移到另一台计算机。 如果目标计算机已安装指定版本的 LocalDB，则目标计算机也提供此版本的自动 LocalDB 实例。 自动 LocalDB 实例具有属于保留命名空间的特殊实例名称模式。 自动实例可以防止名称与 LocalDB 的命名实例发生冲突。 自动实例的名称为 MSSQLLocalDB。

命名实例

LocalDB 的命名实例是专用的。 这些命名实例由负责创建和管理该实例的单个应用程序所拥有。 命名实例提供与其他实例的隔离，并可以通过减少与其他数据库用户的资源争用来提高性能。 必须通过 LocalDB 管理 API 显式创建命名实例，或者通过托管应用程序的 app.config 文件隐式创建（尽管托管应用程序也会在需要时使用 API）。 LocalDB 的每个命名实例都具有关联的 LocalDB 版本，指向相应的 LocalDB 二进制文件集。 LocalDB 的命名实例为 sysname 数据类型并且可具有最多 128 个字符。 （此实例名称不同于常规的 SQL Server 命名实例，后者将名称限制为 15 个 ASCII 字符的常规 NetBIOS 名称。）LocalDB 实例名称可包含在文件名内合法的任何 Unicode 字符。 使用自动实例名称的命名实例将成为自动实例。

LocalDB 的共享实例

为了支持多个计算机用户需要连接到单个 LocalDB 实例的方案，LocalDB 支持实例共享。 实例所有者可以选择允许计算机上的其他用户连接实例。 LocalDB 的自动实例和命名实例都可以共享。 若要共享 LocalDB 的某个实例，用户需要为其选择一个共享名称（别名）。 因为该共享名称对于该计算机的所有用户都是可见的，则此共享名称在计算机上必须唯一。 LocalDB 实例的共享名称具有与 LocalDB 的命名实例相同的格式。

只有计算机上的管理员才能创建 LocalDB 的共享实例。 LocalDB 的共享实例可由管理员或 LocalDB 共享实例的所有者取消共享。 若要共享和取消共享某一 LocalDB 实例，请使用 LocalDB API 的 LocalDBShareInstance和 LocalDBUnShareInstance 方法，或者使用 SqlLocalDB 实用工具的共享和取消共享选项。

启动 LocalDB 并连接到 LocalDB

本节介绍了如何连接到自动实例、命名实例或共享实例。

连接到自动实例

使用 LocalDB 的最简单方法是通过使用连接字符串 Server=(localdb)\MSSQLLocalDB;Integrated Security=true 连接到当前用户拥有的自动实例。 若要通过使用文件名连接到特定数据库，请使用类似于 Server=(LocalDB)\MSSQLLocalDB;Integrated Security=true;AttachDbFileName=D:\Data\MyDB1.mdf 的连接字符串进行连接。

注意

在计算机上的用户首次尝试连接到 LocalDB 时，必须创建并启动该自动实例。 创建实例所用的额外时间可能会导致连接尝试失败并且具有超时消息。 在发生此情况时，等待几秒钟以便让创建过程完成，然后再次连接。

创建并连接到命名实例

除了自动实例之外，LocalDB 还支持命名实例。 使用 SqlLocalDB.exe 程序可以创建、启动和停止 LocalDB 的命名实例。 有关 SqlLocalDB.exe 的详细信息，请参阅 SqlLocalDB 实用工具。

REM Create an instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" create LocalDBApp1
REM Start the instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" start LocalDBApp1
REM Gather information about the instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" info LocalDBApp1

上一个代码示例中的最后一行返回类似于下表的信息。

类别 值
Name LocalDBApp1
版本 <Current version>
共享名称 ""
所有者 <Your Windows user>
自动创建 No
State Running
上次启动时间 <Date and time>
实例管道名称 np:\\.\pipe\LOCALDB#F365A78E\tsql\query

注意

如果应用程序使用早于 .NET Framework 4.0.2 的版本，则必须直接连接到 LocalDB 的命名管道。 实例管道名称值为 LocalDB 的实例正在侦听的命名管道。 LOCALDB# 之后的实例管道名称部分将在每次启动 LocalDB 实例时更改。 若要通过使用 SQL Server Management Studio 连接到 LocalDB 实例，请在“连接到 数据库引擎”对话框的“服务器名称”框中键入实例管道名称。 在自定义程序中，可以通过使用类似于 SqlConnection conn = new SqlConnection(@"Server=np:\\.\pipe\LOCALDB#F365A78E\tsql\query"); 的连接字符串建立与 LocalDB 实例的连接

连接到 LocalDB 的共享实例

若要连接到某一 LocalDB 共享实例，请将 \.\（反斜杠 + 句点 + 反斜杠）添加到连接字符串，以便引用为共享实例保留的命名空间。 例如，若要连接到名为 AppData 的 LocalDB 的共享实例，可使用连接字符串（例如 (localdb)\.\AppData）作为连接字符串的一部分。 连接到用户不拥有的 LocalDB 共享实例的用户必须具有 Windows 身份验证或 SQL Server 身份验证登录名。

疑难解答

有关 LocalDB 故障排除的信息，请参阅已知的 SQL Server 2012 安装和迁移问题。

权限

SQL Server Express LocalDB 的实例是用户根据需要创建的实例。 计算机上的任何用户都可以使用 LocalDB 实例创建数据库，在用户配置文件下存储文件并使用凭据来运行进程。 默认情况下，对 LocalDB 实例的访问仅限于其所有者。 LocalDB 中包含的数据受到对数据库文件的文件系统访问的保护。 如果用户数据库文件存储在共享位置，那么任何具有该位置文件系统访问权限的人都可以通过使用自己拥有的 LocalDB 实例打开该数据库。 如果数据库文件处于某一受保护的位置，例如用户数据文件夹，则只有该用户以及有权访问该文件夹的任何管理员才能打开该数据库。 LocalDB 文件只能一次通过一个 LocalDB 实例来打开。

LocalDB 始终在用户的安全上下文下运行。 LocalDB 从不使用来自本地管理员组的凭据运行。 这意味着 LocalDB 实例使用的所有数据库文件必须可以通过拥有的用户的 Windows 帐户来访问，而不必考虑本地 Administrators 组中的成员资格。

相关内容