SQL Server Express LocalDB-exemplaar-API's

Van toepassing op:SQL Server

In de traditionele, servicegebaseerde SQL Server-wereld worden afzonderlijke SQL Server-exemplaren die op één computer zijn geïnstalleerd, fysiek gescheiden. Elk exemplaar moet afzonderlijk worden geïnstalleerd en verwijderd, heeft een afzonderlijke set binaire bestanden en wordt uitgevoerd onder een afzonderlijk serviceproces. De naam van het SQL Server-exemplaar wordt gebruikt om op te geven met welk SQL Server-exemplaar de gebruiker verbinding wil maken.

De SQL Server Express LocalDB-exemplaar-API maakt gebruik van een vereenvoudigd, light instance-model. Hoewel afzonderlijke LocalDB-exemplaren op de schijf en in het register worden gescheiden, gebruiken ze dezelfde set gedeelde LokaleDB-binaire bestanden. Bovendien maakt LocalDB geen gebruik van services. LocalDB-exemplaren worden op aanvraag gestart via API-aanroepen van localDB-exemplaren. In LocalDB wordt de naam van het exemplaar gebruikt om op te geven met welke localDB-exemplaren de gebruiker wil werken.

Een LocalDB-exemplaar is altijd eigendom van één gebruiker en is alleen zichtbaar en toegankelijk vanuit de context van deze gebruiker, tenzij delen van exemplaren is ingeschakeld.

Hoewel localDB-exemplaren technisch gezien niet hetzelfde zijn als traditionele SQL Server-exemplaren, is het beoogde gebruik vergelijkbaar. Ze worden instanties genoemd om deze gelijkenis te benadrukken en ze intuïtiever te maken voor SQL Server-gebruikers.

LocalDB ondersteunt twee soorten exemplaren: automatische exemplaren (AI) en benoemde exemplaren (NI). De id voor een LocalDB-exemplaar is de naam van het exemplaar.

Automatische LocalDB-exemplaren

Automatische LocalDB-instanties zijn openbaar; Ze worden automatisch aangemaakt en beheerd voor de gebruiker en kunnen door elke applicatie worden gebruikt. Er bestaat één automatisch LocalDB-exemplaar voor elke versie van LocalDB die op de computer van de gebruiker is geïnstalleerd. De naam van de automatische LocalDB-instantie is MSSQLLocalDB.

Automatische LocalDB-exemplaren bieden naadloos exemplaarbeheer. De gebruiker hoeft het exemplaar niet te maken. Hierdoor kunnen gebruikers eenvoudig toepassingen installeren en migreren naar verschillende computers. Als op de doelcomputer de opgegeven versie van LocalDB is geïnstalleerd, is het automatische LocalDB-exemplaar voor die versie ook beschikbaar op die computer.

Automatisch exemplaarbeheer

Een gebruiker hoeft geen automatisch LocalDB-exemplaar te maken. Het exemplaar wordt lazily gemaakt wanneer het exemplaar voor het eerst wordt gebruikt, zolang de opgegeven versie van LocalDB beschikbaar is op de computer van de gebruiker. Vanuit het oogpunt van de gebruiker is het automatische exemplaar altijd aanwezig als de binaire localDB-bestanden aanwezig zijn.

Andere beheerbewerkingen voor exemplaren, zoals Verwijderen, Delen en Delen, werken ook voor automatische exemplaren. Met name wanneer u een automatisch exemplaar verwijdert, wordt het exemplaar opnieuw ingesteld, dat opnieuw wordt gemaakt bij de volgende startbewerking. Het verwijderen van een automatisch exemplaar is mogelijk vereist als de systeemdatabases beschadigd raken.

Benoemde LocalDB-exemplaren

Benoemde LocalDB-instanties zijn privé; Een instantie is eigendom van één applicatie die verantwoordelijk is voor het creëren en beheren van de instantie. Benoemde LocalDB-exemplaren bieden isolatie en verbeteren de prestaties.

Benoemd exemplaar maken

De gebruiker moet benoemde exemplaren expliciet maken via de LocalDB-beheer-API of impliciet via het app.config bestand voor een beheerde toepassing. Een beheerde toepassing kan ook gebruikmaken van de API.

Elk benoemd exemplaar heeft een bijbehorende LocalDB-versie; Dat wil gezegd: het verwijst naar een opgegeven set binaire LocalDB-bestanden. De versie voor het benoemde exemplaar wordt ingesteld tijdens het maken van het exemplaar.

Naamgevingsregels voor benoemde instanties

Een LocalDB-instantienaam kan tot 128 tekens hebben (het systeemnaamdatatype legt deze limiet op). Deze limiet is een aanzienlijk verschil ten opzichte van traditionele SQL Server-instantienamen, die beperkt zijn tot NetBIOS-namen van 15 ASCII-tekens. De reden voor dit verschil is dat LocalDB databases als bestanden behandelt en daardoor bestandsgebaseerde semantiek impliceert, waardoor gebruikers meer vrijheid hebben bij het kiezen van instantienamen.

De naam van een LocalDB-exemplaar kan unicode-tekens bevatten die legaal zijn binnen het bestandsbestandsonderdeel. Ongeldige tekens in een bestandsnaamonderdeel bevatten over het algemeen de volgende tekens: ASCII/Unicode-tekens 1 tot en met 31 en aanhalingsteken ("), kleiner dan (<), groter dan (>), pipe (|), backspace (\b), tab (), dubbele punt (\t:), sterretje (*), vraagteken (), backslash (?\) en slash (/). Het null-teken (\0) is toegestaan omdat het wordt gebruikt voor het beëindigen van tekenreeksen. Alles na het eerste null-teken wordt genegeerd.

Note

De lijst met ongeldige tekens kan afhankelijk zijn van het besturingssysteem en kan in toekomstige releases veranderen.

Voorloop- en volgspaties in instantienamen worden genegeerd en ingekort.

Om naamconflicten te vermijden, kan een benoemde LocalDB-instantie de gereserveerde automatische instantienaam MSSQLLocalDBniet gebruiken. Een poging om een benoemde instantie met die naam te maken, creëert effectief een standaardinstantie.

Article Description
Informatie over sql Server Express LocalDB-headers en -versies Biedt informatie over headerbestanden en registersleutels voor het vinden van de LocalDB-exemplaar-API.
Command-Line-beheerprogramma: SqlLocalDB.exe Beschrijft SqlLocalDB.exe, een hulpprogramma voor het beheren van LocalDB-exemplaren vanaf de opdrachtregel.
LocalDBCreateInstance functie Beschrijft de functie om een nieuw LocalDB-exemplaar te maken.
LocalDBDeleteInstance Function Beschrijft de functie om een LocalDB-exemplaar te verwijderen.
LocalDBFormatMessage-functie Beschrijft de functie om de gelokaliseerde beschrijving voor een LocalDB-fout te retourneren.
LocalDBGetInstanceInfo Function Beschrijft de functie om informatie op te halen voor een LocalDB-exemplaar, zoals of deze bestaat, versiegegevens, of deze wordt uitgevoerd, enzovoort.
LocalDBGetInstances-functie Beschrijft de functie om alle LocalDB-exemplaren met een opgegeven versie te retourneren.
LocalDBGetVersionInfo-functie Beschrijft de functie om informatie te retourneren voor een opgegeven LocalDB-versie.
LocalDBGetVersions-functie Beschrijft de functie om alle LocalDB-versies te retourneren die beschikbaar zijn op een computer.
LocalDBShareInstance functie Beschrijft de functie voor het delen van een opgegeven LocalDB-exemplaar.
LocalDBStartInstance Function Beschrijft de functie om een opgegeven LocalDB-instantie te starten.
LocalDBStartTracing-functie Beschrijft de functie voor het inschakelen van API-tracering voor een gebruiker.
LocalDBStopInstance-functie Beschrijft de functie om te voorkomen dat een opgegeven LocalDB-exemplaar wordt uitgevoerd.
LocalDBStopTracing-functie Beschrijft de functie om API-tracering voor een gebruiker uit te schakelen.
LocalDBUnshareInstance-functie Beschrijft de functie om het delen van een opgegeven LocalDB-exemplaar te stoppen.