API экземпляра SQL Server Express LocalDB

Применимо к:SQL Server

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

API экземпляра SQL Server Express LocalDB использует упрощенную модель экземпляра. Хотя отдельные экземпляры LocalDB разделены на диске и в реестре, они используют тот же набор общих двоичных файлов LocalDB. Кроме того, LocalDB не использует службы. Экземпляры LocalDB запускаются по запросу с помощью вызовов API экземпляра LocalDB. В LocalDB имя экземпляра используется для указания того, с какими экземплярами LocalDB пользователь хочет работать.

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

Хотя технически экземпляры LocalDB не совпадают с традиционными экземплярами SQL Server, их предполагаемое использование аналогично. Их называют экземплярами, чтобы подчеркнуть это сходство и сделать их более интуитивными для пользователей SQL Server.

LocalDB поддерживает два вида экземпляров: автоматические экземпляры (AI) и именованные экземпляры (NI). Идентификатор для экземпляра LocalDB — это имя экземпляра.

Автоматические экземпляры LocalDB

Автоматические экземпляры локальной базы являются публичными; Они создаются и управляются автоматически для пользователя и могут использоваться любым приложением. Для каждой версии LocalDB, установленной на компьютере пользователя, существует один автоматический экземпляр LocalDB. Название автоматического экземпляра LocalDB — MSSQLLocalDB.

Автоматические экземпляры LocalDB обеспечивают гладкое управление экземплярами. Пользователю не нужно создавать экземпляр. Это позволяет пользователям легко устанавливать приложения и выполнять миграцию на другие компьютеры. Если на целевом компьютере установлена заданная версия LocalDB, на нем также будет доступен автоматический экземпляр LocalDB.

Автоматическое управление экземплярами

Пользователю не нужно создавать автоматический экземпляр LocalDB. Экземпляр создается при первом использовании экземпляра, если указанная версия LocalDB доступна на компьютере пользователя. С точки зрения пользователя автоматический экземпляр всегда присутствует, если двоичные файлы LocalDB присутствуют.

Другие операции управления экземплярами, такие, как удаление или включение и отключение совместного использования, также доступны для автоматических экземпляров. В частности, удаление автоматического экземпляра фактически сбрасывает экземпляр, который повторно создается при следующей операции запуска. Удаление автоматического экземпляра может потребоваться, если системные базы данных повреждены.

Именованные экземпляры LocalDB

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

Создание именованного экземпляра

Пользователь должен явно создавать именованные экземпляры через API управления LocalDB или неявно через app.config файл управляемого приложения. Управляемое приложение также может использовать API.

Каждый именованный экземпляр имеет соответствующую версию LocalDB; то есть он указывает на конкретный набор двоичных файлов LocalDB. Версия для именованного экземпляра устанавливается в процессе создания экземпляра.

Правила именования именованных экземпляров

Имя экземпляра LocalDB может содержать до 128 символов (тип данных sysname накладывает это ограничение). Это ограничение существенно отличается от традиционных имен экземпляра SQL Server, которые ограничены именами NetBIOS из 15 ASCII-символов. Причина этого различия в том, что LocalDB рассматривает базы данных как файлы и, следовательно, подразумевает семантику на основе файлов, поэтому пользователи имеют больше свободы выбора имён экземпляров.

Имя экземпляра LocalDB может содержать любые символы Юникода, допустимые в компоненте имени файла. Недопустимые символы в компоненте имени файла обычно включают следующие символы: ASCII/Юникод символы 1–31 и кавычки" (), меньше (), меньше< (), больше> (), канал| (), backspace\b (), tab (), двоеточие (\t), звездочка: (*), вопросительный знак (?), обратная косая черта () и косая\ черта (/). Допускается значение NULL,\0 так как оно используется для завершения строки; все после того, как первый символ NULL игнорируется.

Note

Список недопустимых символов может зависеть от операционной системы и может измениться в будущих выпусках.

Начальные и конечные пробелы в именах экземпляров игнорируются и обрезаются.

Чтобы избежать конфликтов в именовании, именованный экземпляр LocalDB не может использовать зарезервированное автоматическое имя MSSQLLocalDBэкземпляра . Попытка создать именованный экземпляр с таким именем фактически создаёт его по умолчанию.

Связанные задачи

Article	Description
Сведения о заголовке и версии SQL Server Express LocalDB	Содержит сведения из файла заголовка и разделы реестра для поиска API экземпляра LocalDB.
Программа командной строки SqlLocalDB.exe	Описывает программу SqlLocalDB.exe, средство для управления экземплярами LocalDB из командной строки.
LocalDBCreateInstance Function	Описывает функцию создания нового экземпляра LocalDB.
LocalDBDeleteInstance Function	Описывает функцию удаления экземпляра LocalDB.
Функция localDBFormatMessage	Описывает функцию возврата локализованного описания ошибки LocalDB.
LocalDBGetInstanceInfo Function	Описывает функцию для получения сведений о экземпляре LocalDB, например о том, существует ли она, сведения о версии, работает ли она и т. д.
Функция localDBGetInstances	Описывает функцию возврата всех экземпляров LocalDB с указанной версией.
LocalDBGetVersionInfo Function	Описывает функцию возврата сведений об определенной версии LocalDB.
Функция LocalDBGetVersions	Описывает функцию возврата всех версий LocalDB, доступных на компьютере.
LocalDBShareInstance Function	Описывает функцию включения для совместного использования заданного экземпляра LocalDB.
LocalDBStartInstance Function	Описывает функцию запуска указанного экземпляра LocalDB.
Функция трассировки localDBStart.	Описывает функцию включения трассировки API для пользователя.
LocalDBStopInstance Function	Описывает функцию остановки указанного экземпляра LocalDB.
Функция трассировки LocalDBStopTracing	Описывает функцию отключения трассировки API для пользователя.
LocalDBUnshareInstance Function	Описывает функцию остановки совместного использования указанного экземпляра LocalDB.