Rozhraní API instancí SQL Serveru Express LocalDB

Applies to: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é. They are called instances to emphasize this similarity and to make them more intuitive to SQL Server users.

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

Automatické instance LocalDB

Automatic LocalDB instances are public; they are created and managed automatically for the user and can be used by any application. Jedna automatická instance LocalDB existuje pro každou verzi LocalDB nainstalovanou na počítači uživatele.

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í.

Pravidla automatického pojmenování instancí

Automatické instance LocalDB mají speciální vzor pro název instance, který patří do vyhrazeného oboru názvů. To je nezbytné, aby se zabránilo konfliktům názvů s pojmenovanými instancemi LocalDB.

Název automatické instance je číslo verze základní verze LocalDB, kterému předchází jeden v znak. Vypadá to jako v plus dvě čísla s tečkou, například v11.0V12.00.

Mezi příklady neplatných automatických názvů instancí patří:

• 11.0 (chybí v znak na začátku)
• v11 (chybí tečka a druhý počet verze)
• v11. (chybí druhý počet verze)
• v11.0.1.2 (číslo verze má více než dvě části)

Pojmenované instance LocalDB

Named LocalDB instances are private; an instance is owned by a single application that is responsible for creating and managing the instance. 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í

A LocalDB instance name can have up to a total of 128 characters (the limit is imposed by the sysname data type). Jedná se o významný rozdíl v porovnání s tradičními názvy instancí SQL Serveru, které jsou omezené na názvy rozhraní NetBIOS s 16 znaky ASCII. Důvodem tohoto rozdílu je, že LocalDB zpracovává databáze jako soubory, a proto implikuje sémantiku založenou na souborech, takže je intuitivní, aby uživatelé měli větší volnost při výběru názvů 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 nedocházelo ke konfliktům pojmenování, pojmenované instance LocalDB nemůžou mít název, který se řídí vzorem pojmenování pro automatické instance, jak je popsáno výše v části Pravidla pojmenování automatických instancí . Pokus o vytvoření pojmenované instance s názvem, který se řídí vzorcem automatického pojmenování instance, efektivně vytvoří výchozí instanci.

Related tasks

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.
LocalDBGetInstanceInfo Function	Popisuje funkci, která získá informace o instanci LocalDB, například jestli existuje, informace o verzi, jestli je spuštěná atd.
LocalDBGetInstances Function	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.
LocalDBStartInstance Function	Popisuje funkci, která spustí zadanou instanci LocalDB.
LocalDBStartTracing Function	Popisuje funkci pro povolení trasování rozhraní API pro uživatele.
LocalDBStopInstance Function	Popisuje funkci, která zastaví spuštění zadané instance LocalDB.
LocalDBStopTracing Function	Popisuje funkci, která zakáže trasování rozhraní API pro uživatele.
LocalDBUnshareInstance Function	Popisuje funkci, která ukončí sdílení zadané instance LocalDB.