SQL Server Express LocalDB
Область применения: SQL Server
LocalDB в Microsoft SQL Server Express — это компонент SQL Server Express, ориентированный на разработчиков. Он доступен в выпуске SQL Server Express с расширенными службами.
Установка LocalDB копирует минимальный набор файлов, необходимых для запуска ядро СУБД SQL Server. После установки LocalDB вы можете установить соединение с помощью специальной строки подключения. При подключении необходимая инфраструктура SQL Server автоматически создается и запускается, что позволяет приложению использовать базу данных без сложных задач конфигурации. Средства разработчика позволяют использовать ядро СУБД SQL Server для создания и проверки кода Transact-SQL без обязательств по управлению полноценным экземпляром сервера SQL Server.
Установочный носитель
LocalDB — это компонент, выбираемый во время установки SQL Server Express и доступный при загрузке с носителя. Если вы скачиваете носитель, выберите Express Advanced или пакет LocalDB .
- Выпуск SQL Server 2022 Express
- Выпуск SQL Server 2019 Express
- Выпуск SQL Server 2017 Express
- Выпуск SQL Server 2016 Express
Клиенты, использующие Visual Studio 2019 и Visual Studio 2022, должны установить выпуск SQL Server 2019 Express.
Установщик SqlLocalDB.msi
LocalDB доступен на установочном носителе для всех выпусков, кроме Express Core. Он расположен в папке <installation_media_root>\<LCID>_ENU_LP\x64\Setup\x64
. LCID — это идентификатор языкового стандарта или код языка. Например, LCID-значение 1033 ссылается на языковой en-US
стандарт.
Кроме того, LocalDB можно установить с помощью Visual Studio Installer в составе рабочей нагрузки Хранение и обработка данных, рабочей нагрузки ASP.NET и веб-разработка или как отдельный компонент.
Установка LocalDB
Для установки LocalDB используйте мастер установки или программу SqlLocalDB.msi
. LocalDB подходит при установке SQL Server Express LocalDB.
Выберите LocalDB на странице Выбор компонентов или "Общие компоненты" во время установки. Для каждой основной версии SQL Server ядро СУБД может быть только одна установка двоичных файлов LocalDB. Можно запустить несколько ядро СУБД процессов и использовать одни и те же двоичные файлы. Экземпляр SQL Server ядро СУБД запущен, так как LocalDB имеет те же ограничения, что и SQL Server Express.
Экземпляр SQL Server Express LocalDB управляется с помощью служебной SqlLocalDB.exe
программы. SQL Server Express LocalDB следует использовать вместо функции экземпляра пользователя SQL Server Express, которая не рекомендуется.
Description
Программа установки LocalDB использует программу SqlLocalDB.msi
для установки необходимых файлов на компьютере. После установки LocalDB — это экземпляр SQL Server Express, который может создавать и открывать базы данных SQL Server. Файлы системной базы данных для базы данных хранятся в локальном AppData
пути, который обычно скрыт. Например, C:\Users\<user>\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\LocalDBApp1\
. Файлы пользовательской базы данных хранятся в месте, указанном пользователем, как правило, в папке C:\Users\<user>\Documents\
.
Дополнительные сведения о том, как включить LocalDB в приложение, см. в обзоре локальных данных Visual Studio, создании базы данных и добавлении таблиц в Visual Studio.
Дополнительные сведения об API LocalDB см. в разделе Справочник по SQL Server Express LocalDB.
Служебная программа SqlLocalDB
позволяет создавать новые экземпляры LocalDB, запускать и останавливать работу экземпляров, а также использовать функции для управления LocalDB. Дополнительные сведения о служебной программе см. в разделе "Служебная SqlLocalDB
программа SqlLocalDB".
Параметры сортировки экземпляра для LocalDB заданы SQL_Latin1_General_CP1_CI_AS
и не могут быть изменены. Параметры сортировки на уровне базы данных, на уровне столбца и на уровне выражения поддерживаются обычным образом. Содержащиеся базы данных следуют правилам метаданных и tempdb
параметров сортировки, определенными параметрами сортировки автономной базы данных.
Ограничения
LocalDB не может управляться удаленно с помощью SQL Server Management Studio.
LocalDB не может быть подписчиком репликации слиянием.
LocalDB не поддерживает FILESTREAM.
Для LocalDB разрешены только локальные очереди компонента Service Broker.
Экземпляр LocalDB, принадлежащий встроенным учетным записям, таким как
NT AUTHORITY\SYSTEM
, может иметь проблемы с управлением из-за перенаправления файловой системы Windows. Вместо этого используйте в качестве владельца обычную учетную запись Windows.
Автоматические и именованные экземпляры
LocalDB поддерживает два типа экземпляров: автоматические экземпляры и именованные экземпляры. Разные пользователи одного и того же компьютера могут иметь экземпляры с одинаковыми именами. Каждый экземпляр запускается в качестве соответствующего пользователя в собственном процессе.
Автоматические экземпляры
Автоматические экземпляры LocalDB являются общедоступными. Они создаются и управляются автоматически для пользователя и могут использоваться любым приложением. Для каждой версии LocalDB, установленной на компьютере пользователя, существует один автоматический экземпляр LocalDB. Автоматические экземпляры LocalDB обеспечивают удобное управление экземплярами. Нет необходимости создавать экземпляр; это просто работает. Эта функция упрощает установку приложения и его перенос на другой компьютер. Если на целевом компьютере установлена указанная версия LocalDB, то там также будет доступен автоматический экземпляр LocalDB для этой версии. Автоматические экземпляры LocalDB именуются по специальному шаблону, принадлежащему зарезервированному пространству имен. Автоматические экземпляры предотвращают конфликты имен с именованными экземплярами LocalDB. Имя автоматического экземпляра .MSSQLLocalDB
Именованные экземпляры
Именованные экземпляры LocalDB являются закрытыми. Они принадлежат одному приложению, ответственному за создание экземпляра и управление ими. Именованные экземпляры обеспечивают изоляцию от других экземпляров и способствуют повышению производительности за счет снижения уровня конфликта за ресурсы с другими пользователями базы данных. Необходимо явно создавать именованные экземпляры с помощью API управления LocalDB или неявно с помощью app.config
файла для управляемого приложения (хотя управляемое приложение также может использовать API при необходимости). Каждый именованный экземпляр LocalDB имеет связанную с ним версию LocalDB, которая указывает на соответствующий набор двоичных файлов LocalDB. Имя экземпляра LocalDB имеет тип данных sysname и может содержать до 128 символов. (Это имя экземпляра отличается от обычных именованных экземпляров SQL Server, что ограничивает имена обычных имен NetBIOS 15 символов ASCII.) Имя экземпляра LocalDB может содержать любые символы Юникода, которые являются законными в имени файла. Именованный экземпляр, в котором используется имя автоматического экземпляра, становится автоматическим экземпляром.
Общие экземпляры LocalDB
В LocalDB поддерживается общий доступ к экземплярам, если нескольким пользователям компьютера требуется доступ к одному экземпляру LocalDB. Владелец экземпляра может разрешить другим пользователям компьютера подключаться к своему экземпляру. Общими могут быть как автоматические, так и именованные экземпляры LocalDB. Для организации общего доступа к экземпляру LocalDB пользователь должен указать его общее имя (псевдоним). Поскольку общее имя видно всем пользователям компьютера, то оно должно быть уникальным на этом компьютере. Общее имя экземпляра LocalDB имеет тот же формат, что и именованный экземпляр LocalDB.
Только администратор компьютера может создавать общие экземпляры LocalDB. Администратор или владелец общего экземпляра LocalDB может отменить общий доступ к экземпляру LocalDB. Предоставление и отмена общего доступа к экземпляру LocalDB выполняется с помощью методов LocalDBShareInstance
и LocalDBUnShareInstance
API LocalDB либо с помощью соответствующих параметров служебной программы 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
Последняя строка в предыдущем примере кода возвращает сведения, аналогичные следующей таблице.
Категория | Значение |
---|---|
Имя | LocalDBApp1 |
Версия | <Current version> |
Общее имя | "" |
Ответственное лицо | <Your Windows user> |
Автоматическое создание | No |
Штат | Running |
Время последнего начала | <Date and time> |
Имя канала экземпляра | np:\\.\pipe\LOCALDB#F365A78E\tsql\query |
Примечание.
Если приложение использует версию платформа .NET Framework до версии 4.0.2, необходимо подключиться непосредственно к именованной каналу LocalDB. Значение "Имя канала экземпляра" — это именованный канал, который прослушивает экземпляр LocalDB. Часть имени канала экземпляра после LOCALDB#
изменения при каждом запуске экземпляра LocalDB. Чтобы подключиться к экземпляру LocalDB с помощью SQL Server Management Studio, введите имя канала экземпляра в поле имени сервера диалогового окна "Подключение к ядро СУБД". Можно установить соединение с экземпляром LocalDB из пользовательской программы с использованием строки подключения, аналогичной SqlConnection conn = new SqlConnection(@"Server=np:\\.\pipe\LOCALDB#F365A78E\tsql\query");
.
Подключение к общему экземпляру LocalDB
Чтобы подключиться к общему экземпляру LocalDB, добавьте \.\
(backslash + dot+ backslash) в строка подключения, чтобы ссылаться на пространство имен, зарезервированное для общих экземпляров. Например, чтобы подключиться к общему экземпляру LocalDB с именемAppData
, используйте строка подключения, например часть (localdb)\.\AppData
строка подключения. Пользователь, подключающийся к общему экземпляру LocalDB, которому он не владеет, должен иметь имя входа проверки подлинности Windows или проверки подлинности SQL Server.
Устранение неполадок
Сведения об устранении неполадок с LocalDB см. в статье "Известные проблемы с настройкой и миграцией SQL Server 2012".
Разрешения
SQL Server Express LocalDB — это экземпляр, созданный пользователем для самостоятельного использования. Любой пользователь компьютера может создать базу данных с помощью экземпляра LocalDB, сохранив файлы в своем пользовательском профиле и запустив процесс со своими учетными данными. По умолчанию доступ к экземпляру LocalDB имеет только его владелец. Данные, содержащиеся в LocalDB, защищены средствами файловой системы. Если файлы пользовательской базы данных хранятся в общем расположении, база данных может быть открыта любым пользователем с доступом к файловой системе в этом расположении с помощью экземпляра LocalDB, которому они принадлежат. Если файлы базы данных хранятся в защищенном месте, например в папке пользовательских данных, то базу данных может открыть только сам пользователь, а также администратор, обладающий правами доступа к данной папке. Файлы LocalDB могут быть одновременно открыты только одним экземпляром LocalDB.
LocalDB всегда выполняется в контексте безопасности пользователя. LocalDB никогда не выполняется с учетными данными из группы локального администратора. То есть доступ ко всем файлам базы данных, используемыми экземпляром LocalDB, возможен по учетной записи их владельца-пользователя Windows, не учитывая принадлежности к группе локальных администраторов.