Share via


SqlLocalDB-hulpprogramma

van toepassing op:SQL Server-

Gebruik het hulpprogramma SqlLocalDB om een exemplaar van SQL Server Express LocalDB te maken. Het hulpprogramma SqlLocalDB (SqlLocalDB.exe) is een opdrachtregelprogramma waarmee gebruikers en ontwikkelaars een exemplaar van SQL Server Express LocalDB kunnen maken en beheren. Zie SQL Server Express LocalDB voor informatie over het gebruik van LocalDB.

Syntaxis

SqlLocalDB.exe
{
      [ create   | c ] <instance-name> <instance-version> [ -s ]
    | [ delete   | d ] <instance-name>
    | [ start    | s ] <instance-name>
    | [ stop     | p ] <instance-name>  [ -i ] [ -k ]
    | [ share    | h ] [ "<user_SID>" | "<user_account>" ] "<private-name>" "<shared-name>"
    | [ unshare  | u ] "<shared-name>"
    | [ info     | i ] <instance-name>
    | [ versions | v ]
    | [ trace    | t ] [ on | off ]
    | [ help     | -? ]
}

Argumenten

[ maken | c ] <instance-name><instance-version> [ -s ]

Hiermee maakt u een nieuw exemplaar van SQL Server Express LocalDB. SqlLocalDB maakt gebruik van de versie van de binaire bestanden van SQL Server Express die is gespecificeerd door het argument <exemplaarversie>. Het versienummer wordt opgegeven in numerieke notatie met ten minste één decimaal. De secundaire versienummers (servicepacks) zijn optioneel. De volgende twee versienummers zijn bijvoorbeeld beide acceptabel: 11.0 of 11.0.1186. De opgegeven versie moet op de computer worden geïnstalleerd. Als dit niet is opgegeven, wordt het versienummer standaard ingesteld op de versie van het SqlLocalDB-hulpprogramma. Het toevoegen -s start het nieuwe exemplaar van LocalDB.

[ share | h ]

Deelt het opgegeven privé-exemplaar van LocalDB met behulp van de opgegeven gedeelde naam. Als de gebruikers-SID of accountnaam wordt weggelaten, wordt deze standaard ingesteld op de huidige gebruiker.

[ stop delen | u ]

Hiermee stopt u het delen van het opgegeven gedeelde exemplaar van LocalDB.

[ verwijderen | d ] <exemplaarnaam>

Hiermee verwijdert u het opgegeven exemplaar van SQL Server Express LocalDB.

[ start | s ] "<exemplaarnaam>"

Hiermee wordt het opgegeven exemplaar van SQL Server Express LocalDB gestart. Wanneer de instructie is geslaagd, wordt het adres van de benoemde pipe van de LocalDB geretourneerd.

[ stop | p ] <exemplaarnaam> [ -i ] [ -k ]

Hiermee stopt u het opgegeven exemplaar van SQL Server Express LocalDB. Het toevoegen van -i vraagt om het afsluiten van de instantie met de optie NOWAIT. Door -k toe te voegen, wordt het exemplaarproces beëindigd zonder contact ermee op te nemen.

[ info | i ] [ <exemplaarnaam> ]

Een lijst met alle exemplaren van SQL Server Express LocalDB die eigendom zijn van de huidige gebruiker.

<exemplaarnaam> retourneert de naam, versie, status (actief of gestopt), laatste begintijd voor het opgegeven exemplaar van SQL Server Express LocalDB en de naam van de lokale pijp van de LocalDB.

[ trace | t ] { aan | uit }

trace on maakt tracering mogelijk voor de SqlLocalDB-API-aanroepen voor de huidige gebruiker. trace off schakelt tracering uit.

-?

Retourneert korte beschrijvingen van elke SqlLocalDB- optie.

Opmerkingen

De naam van het exemplaar argument moet de regels voor SQL Server-identificaties volgen of tussen dubbele aanhalingstekens worden geplaatst.

Als u SqlLocalDB- uitvoert zonder argumenten, wordt de Help-tekst geretourneerd.

Andere bewerkingen dan starten kunnen alleen worden uitgevoerd op een exemplaar dat deel uitmaakt van de momenteel aangemelde gebruiker. Een SQLLOCALDB exemplaar, wanneer gedeeld, kan alleen worden gestart en gestopt door de eigenaar van het exemplaar.

Voorbeelden

A. Een exemplaar van LocalDB maken

In het volgende voorbeeld wordt een exemplaar van SQL Server Express LocalDB genaamd DEPARTMENT gemaakt met behulp van de binaire bestanden van SQL Server en wordt het exemplaar gestart.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Werken met een gedeeld exemplaar van LocalDB

Open een opdrachtprompt met beheerdersbevoegdheden. Vervang <password> door een geldig wachtwoord.

SqlLocalDB.exe create "DeptLocalDB"
SqlLocalDB.exe share "DeptLocalDB" "DeptSharedLocalDB"
SqlLocalDB.exe start "DeptLocalDB"
SqlLocalDB.exe info "DeptLocalDB"
REM The previous statement outputs the Instance pipe name for the next step
sqlcmd -S np:\\.\pipe\LOCALDB#<use your pipe name>\tsql\query
CREATE LOGIN NewLogin WITH PASSWORD = '<password>';
GO
CREATE USER NewLogin;
GO
EXIT

Voer de volgende code uit om verbinding te maken met het gedeelde exemplaar van LocalDB met behulp van de NewLogin aanmelding. Vervang <password> door een geldig wachtwoord.

sqlcmd -S (localdb)\.\DeptSharedLocalDB -U NewLogin -P <password>