Справочник по API экземпляра SQL Server Express LocalDB

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

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

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

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

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

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

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

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

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

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

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

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

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

Имя автоматического экземпляра — номер версии версии базового выпуска LocalDB, предшествующий одному символу "v". Это выглядит как "v" плюс два числа с периодом между ними; например, v11.0 или V12.00.

Примерами незаконных имен автоматических экземпляров являются:

• 11.0 (отсутствует символ "v" в начале)

• версия 11 (отсутствует период и второй номер версии)

• версия 11. (отсутствует второй номер версии)

• v11.0.1.2 (номер версии имеет более двух частей)

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

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

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

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

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

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

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

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

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

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

Справочные статьи по SQL Server Express LocalDB

Сведения о заголовке и версии SQL Server Express LocalDB
Предоставляет сведения о файле заголовка и разделы реестра для поиска API экземпляра LocalDB.

Инструмент управления командной строкой: SqlLocalDB.exe
Описывает SqlLocalDB.exe— средство для управления экземплярами LocalDB из командной строки.

Функция LocalDBCreateInstance
Описывает функцию для создания нового экземпляра LocalDB.

Функция LocalDBDeleteInstance
Описывает функцию удаления экземпляра LocalDB.

Функция LocalDBFormatMessage
Описывает функцию, возвращаемую локализованное описание ошибки LocalDB.

Функция LocalDBGetInstanceInfo
Описывает функцию для получения сведений о экземпляре LocalDB, например о том, существует ли она, сведения о версии, выполняется ли она и т. д.

Функция LocalDBGetInstances
Описывает функцию для возврата всех экземпляров LocalDB с указанной версией.

Функция LocalDBGetVersionInfo
Описывает функцию для возврата сведений для указанной версии LocalDB.

Функция LocalDBGetVersions
Описывает функцию для возврата всех версий LocalDB, доступных на компьютере.

Функция LocalDBShareInstance
Описывает функцию для совместного использования указанного экземпляра LocalDB.

Функция LocalDBStartInstance
Описывает функцию для запуска указанного экземпляра LocalDB.

Функция LocalDBStartTracing
Описывает функцию для включения трассировки API для пользователя.

Функция LocalDBStopInstance
Описывает функцию, чтобы остановить выполнение указанного экземпляра LocalDB.

Функция LocalDBStopTracing
Описывает функцию отключения трассировки API для пользователя.

Функция LocalDBUnshareInstance
Описывает функцию, чтобы прекратить общий доступ к указанному экземпляру LocalDB.