Rozhraní API instancí SQL Serveru Express LocalDB

platí pro:SQL Server

V tradičním světě SQL Serveru založeném na službě jsou jednotlivé instance SQL Serveru nainstalované na jednom počítači fyzicky oddělené. Každá instance musí být nainstalovaná a odebraná samostatně, má samostatnou sadu binárních souborů a spouští se v rámci samostatného procesu služby. Název instance SYSTÉMU SQL Server se používá k určení instance SYSTÉMU SQL Server, ke které se chce uživatel připojit.

Rozhraní API instance SQL Serveru Express LocalDB používá zjednodušený, lehký model instance. I když jsou jednotlivé instance LocalDB oddělené na disku a v registru, používají stejnou sadu sdílených binárních souborů LocalDB. LocalDB navíc nepoužívá služby. Instance LocalDB se spouští na vyžádání prostřednictvím volání rozhraní API instance LocalDB. V LocalDB se název instance používá k určení, se kterými instancemi LocalDB chce uživatel pracovat.

Instance LocalDB je vždy vlastněna jedním uživatelem a je viditelná a přístupná pouze z kontextu tohoto uživatele, pokud není povoleno sdílení instancí.

I když technicky instance LocalDB nejsou stejné jako tradiční instance SQL Serveru, jejich zamýšlené použití je podobné. Nazývají se instance, aby zdůraznily tuto podobnost a aby byly pro uživatele SQL Server intuitivnější.

LocalDB podporuje dva druhy instancí: automatické instance (AI) a pojmenované instance (NI). Identifikátor instance LocalDB je název instance.

Automatické instance LocalDB

Automatické instance LocalDB jsou veřejné; jsou vytvářeny a spravovány automaticky pro uživatele a mohou být použity jakoukoli aplikací. Jedna automatická instance LocalDB existuje pro každou verzi LocalDB nainstalovanou na počítači uživatele. Název automatické instance LocalDB je MSSQLLocalDB.

Automatické instance LocalDB poskytují bezproblémovou správu instancí. Uživatel nemusí instanci vytvářet. To umožňuje uživatelům snadno instalovat aplikace a migrovat do různých počítačů. Pokud má cílový počítač nainstalovanou zadanou verzi LocalDB, je na tomto počítači dostupná také automatická instance LocalDB.

Automatická správa instancí

Uživatel nemusí vytvořit automatickou instanci LocalDB. Instance se lazily vytvoří při prvním použití instance, pokud je zadaná verze LocalDB k dispozici na počítači uživatele. Z pohledu uživatele je automatická instance vždy k dispozici, pokud jsou k dispozici binární soubory LocalDB.

Jiné operace správy instancí, jako je odstranění, sdílení a zrušení sdílení, fungují také pro automatické instance. Konkrétně odstranění automatické instance efektivně resetuje instanci, která se znovu vytvoří při další operaci Spuštění. Odstranění automatické instance může být vyžadováno, pokud dojde k poškození systémových databází.

Pojmenované instance LocalDB

Instance pojmenované LocalDB jsou soukromé; Instance je vlastněna jedinou aplikací, která je odpovědná za její vytvoření a správu. Pojmenované instance LocalDB poskytují izolaci a zlepšují výkon.

Vytvoření pojmenované instance

Uživatel musí vytvářet pojmenované instance explicitně prostřednictvím rozhraní API pro správu LocalDB nebo implicitně prostřednictvím app.config souboru pro spravovanou aplikaci. Spravovaná aplikace může také používat rozhraní API.

Každá pojmenovaná instance má přidruženou verzi LocalDB; to znamená, že odkazuje na zadanou sadu binárních souborů LocalDB. Verze pojmenované instance je nastavena během procesu vytváření instance.

Pravidla pojmenování pojmenovaných instancí

Název instance LocalDB může mít až 128 znaků (tento limit stanovuje typ dat sysname ). Toto omezení je významným rozdílem oproti tradičním názvům instancí SQL Server, které jsou omezeny na NetBIOS názvy o 15 ASCII znacích. Důvodem tohoto rozdílu je, že LocalDB považuje databáze za soubory, a proto implikuje sémantiku založenou na souborech, takže uživatelé mají větší volnost při výběru jmen instancí.

Název instance LocalDB může obsahovat jakékoli znaky Unicode, které jsou v komponentě názvu souboru právní. Mezi neplatné znaky v komponentě názvu souboru obecně patří následující znaky: Znaky ASCII/Unicode 1 až 31 a uvozovky ("), menší než (<), větší než (>), pipe (|), backspace (\b), tab (\t), dvojtečka (:), hvězdička (*), otazník (?), zpětné lomítko (\) a lomítko (/). Znak null (\0) je povolený, protože se používá pro ukončení řetězce; vše po ignorování prvního znaku null.

Note

Seznam neplatných znaků může záviset na operačním systému a může se změnit v budoucích verzích.

Úvodní a koncové mezery v názvech instancí se ignorují a oříznou.

Aby se předešlo konfliktům v názvech, instance pojmenované LocalDB nemůže použít rezervované automatické jméno MSSQLLocalDBinstance . Pokus o vytvoření pojmenované instance s tímto názvem efektivně vytvoří výchozí instanci.

Související úkoly

Article	Description
Informace o hlavičce a verzi SQL Serveru Express LocalDB	Poskytuje informace o souboru hlaviček a klíče registru pro vyhledání rozhraní API instance LocalDB.
Nástroj pro správu Command-Line: SqlLocalDB.exe	Popisuje SqlLocalDB.exe, nástroj pro správu instancí LocalDB z příkazového řádku.
LocalDBCreateInstance Function	Popisuje funkci pro vytvoření nové instance LocalDB.
LocalDBDeleteInstance Function	Popisuje funkci pro odebrání instance LocalDB.
LocalDBFormatMessage Function	Popisuje funkci, která vrátí lokalizovaný popis chyby LocalDB.
Funkce LocalDBGetInstanceInfo	Popisuje funkci, která získá informace o instanci LocalDB, například jestli existuje, informace o verzi, jestli je spuštěná atd.
Funkce LocalDBGetInstances	Popisuje funkci, která vrátí všechny instance LocalDB se zadanou verzí.
LocalDBGetVersionInfo Function	Popisuje funkci pro vrácení informací pro zadanou verzi LocalDB.
LocalDBGetVersions Function	Popisuje funkci, která vrátí všechny verze LocalDB dostupné v počítači.
LocalDBShareInstance Function	Popisuje funkci, která má sdílet zadanou instanci LocalDB.
Funkce LocalDBStartInstance	Popisuje funkci, která spustí zadanou instanci LocalDB.
Funkce LocalDBStartTracing	Popisuje funkci pro povolení trasování rozhraní API pro uživatele.
Funkce LocalDBStopInstance	Popisuje funkci, která zastaví spuštění zadané instance LocalDB.
LocalDBStopTracing funkce	Popisuje funkci, která zakáže trasování rozhraní API pro uživatele.
LocalDBUnshareInstance Function	Popisuje funkci, která ukončí sdílení zadané instance LocalDB.