Delen via


SQL Server Express LocalDB-exemplaar-API's

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

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

Automatic LocalDB instances are public; they are created and managed automatically for the user and can be used by any application. Er bestaat één automatisch LocalDB-exemplaar voor elke versie van LocalDB die op de computer van de gebruiker is geïnstalleerd.

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.

Regels voor automatische naamgeving van exemplaren

Automatische LocalDB-exemplaren hebben een speciaal patroon voor de exemplaarnaam die deel uitmaakt van een gereserveerde naamruimte. Dit is nodig om naamconflicten met benoemde LocalDB-exemplaren te voorkomen.

De naam van de automatische instantie is het releasenummer van de LocalDB-basislijn, voorafgegaan door één v teken. Dit ziet eruit als v plus twee getallen met een punt ertussen, bijvoorbeeld v11.0 of V12.00.

Voorbeelden van illegale automatische exemplaarnamen zijn:

  • 11.0 (het teken ontbreekt v aan het begin)
  • v11 (er ontbreekt een punt en het tweede nummer van de versie)
  • v11. (het tweede nummer van de versie ontbreekt)
  • v11.0.1.2 (versienummer heeft meer dan twee delen)

Benoemde LocalDB-exemplaren

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

A LocalDB instance name can have up to a total of 128 characters (the limit is imposed by the sysname data type). Dit is een belangrijk verschil in vergelijking met traditionele SQL Server-exemplaarnamen, die beperkt zijn tot NetBIOS-namen van 16 ASCII-tekens. De reden voor dit verschil is dat LocalDB databases als bestanden behandelt en daarom semantiek op basis van bestanden impliceert, dus het is intuïtief voor gebruikers om meer vrijheid te hebben bij het kiezen van exemplaarnamen.

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 voorkomen, kunnen benoemde LocalDB-exemplaren geen naam hebben die het naamgevingspatroon voor automatische exemplaren volgt, zoals eerder is beschreven in de sectie Regels voor automatische naamgeving van exemplaren . Een poging om een benoemd exemplaar te maken met een naam die het automatische naamgevingspatroon van het exemplaar volgt, maakt effectief een standaardexemplaren.

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 Function Beschrijft de functie om een nieuw LocalDB-exemplaar te maken.
LocalDBDeleteInstance Function Beschrijft de functie om een LocalDB-exemplaar te verwijderen.
LocalDBFormatMessage Function 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 Function Beschrijft de functie om alle LocalDB-exemplaren met een opgegeven versie te retourneren.
LocalDBGetVersionInfo Function Beschrijft de functie om informatie te retourneren voor een opgegeven LocalDB-versie.
LocalDBGetVersions Function Beschrijft de functie om alle LocalDB-versies te retourneren die beschikbaar zijn op een computer.
LocalDBShareInstance Function Beschrijft de functie voor het delen van een opgegeven LocalDB-exemplaar.
LocalDBStartInstance Function Beschrijft de functie om een opgegeven LocalDB-instantie te starten.
LocalDBStartTracing Function Beschrijft de functie voor het inschakelen van API-tracering voor een gebruiker.
LocalDBStopInstance Function Beschrijft de functie om te voorkomen dat een opgegeven LocalDB-exemplaar wordt uitgevoerd.
LocalDBStopTracing Function Beschrijft de functie om API-tracering voor een gebruiker uit te schakelen.
LocalDBUnshareInstance Function Beschrijft de functie om het delen van een opgegeven LocalDB-exemplaar te stoppen.