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

Applies to: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, их предполагаемое использование аналогично. They are called instances to emphasize this similarity and to make them more intuitive to SQL Server users.

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

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

Automatic LocalDB instances are public; they are created and managed automatically for the user and can be used by any application. Для каждой версии LocalDB, установленной на компьютере пользователя, существует один автоматический экземпляр LocalDB.

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

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

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

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

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

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

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

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

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

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

Named LocalDB instances are private; an instance is owned by a single application that is responsible for creating and managing the instance. Именованные экземпляры LocalDB обеспечивают изоляцию и повышают производительность.

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

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

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

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

A LocalDB instance name can have up to a total of 128 characters (the limit is imposed by the sysname data type). Это существенно отличается от традиционных имен экземпляров SQL Server, которые ограничены именами NetBIOS из 16 ASCII-символов. Причина этой разницы заключается в том, что LocalDB обрабатывает базы данных как файлы и, следовательно, подразумевает семантику на основе файлов, поэтому интуитивно понятно, чтобы пользователи имели больше свободы при выборе имен экземпляров.

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

Note

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

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

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

Related tasks

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