SqlLocalDB-Hilfsprogramm

Artikel
05/30/2023

Gilt für: SQL Server

Verwenden Sie das Hilfsprogramm SqlLocalDB, um eine Instanz von SQL Server Express LocalDB zu erstellen. Das Hilfsprogramm SqlLocalDB (SqlLocalDB.exe) ist ein Befehlszeilentool, mit dem Benutzer und Entwickler eine Instanz von SQL Server Express LocalDB erstellen und verwalten können. Informationen zum Verwenden von LocalDBfinden Sie unter SQL Server 2016 Express LocalDB.

Syntax

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     | -? ]
}

Argumente

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

Erstellt eine neue Instanz von SQL Server ExpressLocalDB. SqlLocalDB verwendet die Version der mit dem Argument <instance-version> angegebenen SQL Server Express-Binärdateien. Die Versionsnummer wird im numerischen Format mit mindestens einer Dezimalzahl angegeben. Die Nebenversionsnummern (Service Packs) sind optional. Beispielsweise werden die folgenden zwei Versionsnummern akzeptiert: 11.0 oder 11.0.1186. Die angegebene Version muss auf dem Computer installiert sein. Wenn die Versionsnummer nicht angegeben ist, wird standardmäßig die Version des Hilfsprogramms SqlLocalDB verwendet. Durch Hinzufügen von -s wird die neue Instanz von LocalDB gestartet.

Gibt die angegebene private Instanz von LocalDB mithilfe des angegebenen freigegebenen Namens frei. Wenn die Benutzer-SID oder der Kontoname weggelassen wird, wird standardmäßig der aktuelle Benutzer verwendet.

[ aufheben der Freigabe | u ]

Beendet die Freigabe der angegebenen freigegebenen Instanz von LocalDB.

[ delete | d ] <instance-name>

Löscht die angegebene Instanz von SQL Server ExpressLocalDB.

[ start | s ] "<instance-name>"

Startet die angegebene Instanz von SQL Server Express LocalDB. Bei Erfolg gibt die Anweisung die Named Pipe-Adresse von LocalDBzurück.

[ stop | p ] <instance-name> [-i ] [-k ]

Beendet die angegebene Instanz von SQL Server Express LocalDB. Durch Hinzufügen von -i wird das Herunterfahren der Instanz mit der NOWAIT-Option angefordert. Durch Hinzufügen von -k wird der Instanzprozess ohne Kontaktieren abgebrochen.

[ info | i ] [ <instance-name> ]

Listet alle Instanzen von SQL Server Express LocalDB auf, die im Besitz des aktuellen Benutzers bzw. der aktuellen Benutzerin sind.

<instance-name> gibt den Namen, die Version, den Zustand („Wird ausgeführt“ oder „Beendet“) und die letzte Startzeit für die angegebene Instanz von SQL Server Express LocalDB und den lokalen Pipenamen von LocalDB zurück.

[ trace | t ] on | off

trace on aktiviert die Ablaufverfolgung für die SqlLocalDB -API-Aufrufe für den aktuellen Benutzer. trace off deaktiviert die Ablaufverfolgung.

`-?`

Gibt eine kurze Beschreibungen jeder SqlLocalDB -Option zurück.

Bemerkungen

Für das instance name -Argument müssen die Regeln für SQL Server -Bezeichner befolgt werden, oder das Argument muss in doppelte Anführungszeichen eingeschlossen werden.

Bei der Ausführung von SqlLocalDB ohne Argumente wird der Hilfetext zurückgegeben.

Vorgänge, die keine Startvorgänge sind, können nur für eine Instanz ausgeführt werden, die zum/zur derzeit angemeldeten Benutzer*in gehört. Wenn eine SQLLOCALDB-Instanz freigegeben wird, kann sie nur vom Besitzer bzw. der Benutzerin der Instanz gestartet und beendet werden.

Beispiele

A. Erstellen einer Instanz von LocalDB

Im folgenden Beispiel wird mithilfe der SQL Server Express-Binärdateien eine Instanz von SQL Server Express LocalDB namens DEPARTMENT erstellt und die Instanz gestartet.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Verwenden einer freigegebenen Instanz von LocalDB

Öffnen Sie eine Eingabeaufforderung unter Administratorberechtigungen.

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 = 'Passw0rd!!@52';
GO
CREATE USER NewLogin;
GO
EXIT

Führen Sie den folgenden Code aus, um unter Verwendung des -Anmeldenamens eine Verbindung zur freigegebenen LocalDB NewLogin -Instanz herzustellen.

sqlcmd -S (localdb)\.\DeptSharedLocalDB -U NewLogin -P Passw0rd!!@52

Freigeben über