Udostępnij za pośrednictwem

Narzędzie SqlLocalDB

  • Artykuł

Dotyczy:programu SQL Server

Użyj narzędzia SqlLocalDB, aby utworzyć wystąpienie programu SQL Server Express LocalDB. Narzędzie SqlLocalDB (SqlLocalDB.exe) to narzędzie wiersza polecenia umożliwiające użytkownikom i deweloperom tworzenie wystąpienia usługi SQL Server Express LocalDBoraz zarządzanie nim. Aby uzyskać informacje dotyczące użycia LocalDB, zobacz SQL Server 2016 Express LocalDB.

Składnia

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

Argumenty

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

Tworzy nowe wystąpienie programu SQL Server Express LocalDB. SqlLocalDB używa wersji plików binarnych SQL Server Express określonych przez <wersji wystąpienia argumentu>. Numer wersji jest określony w formacie liczbowym z co najmniej jedną liczbą dziesiętną. Numery mniejszych wersji (pakiety serwisowe) są opcjonalne. Na przykład dwa następujące numery wersji są dopuszczalne: 11.0 lub 11.0.1186. Określona wersja musi być zainstalowana na komputerze. Jeśli nie zostanie określony, numer wersji zostanie domyślnie określony jako wersja narzędzia SqlLocalDB. Dodanie -s rozpoczyna nowe wystąpienie LocalDB.

[ udostępnij | h ]

Udostępnia określone prywatne wystąpienie LocalDB, używając określonej nazwy współdzielonej. Jeśli identyfikator SID użytkownika lub nazwa konta zostanie pominięta, domyślnie użyty zostanie bieżący użytkownik.

[ cofnij udostępnianie | c ]

Zatrzymuje proces udostępniania określonego wystąpienia LocalDB.

[ delete | d ] <nazwa-wystąpienia>

Usuwa określone wystąpienie programu SQL Server Express LocalDB.

[ start | s ] "<nazwa wystąpienia>"

Uruchamia określone wystąpienie programu SQL Server Express LocalDB. Po pomyślnym wykonaniu instrukcji zwraca nazwany adres potoku LocalDB.

[ stop | p ] <nazwa wystąpienia> [-i ] [-k ]

Zatrzymuje określone wystąpienie programu SQL Server Express LocalDB. Dodanie -i powoduje żądanie zamknięcia instancji z opcją NOWAIT. Dodanie -k zabija proces wystąpienia bez konieczności nawiązywania z nim kontaktu.

[ info | i ] [ <nazwa wystąpienia> ]

Wyświetla listę wszystkich wystąpień programu SQL Server Express LocalDB należących do bieżącego użytkownika.

<nazwa wystąpienia> zwraca nazwę, wersję, stan (Uruchomiono lub Zatrzymano), czas ostatniego rozpoczęcia dla określonego wystąpienia programu SQL Server Express LocalDBi nazwę potoku lokalnego LocalDB.

[ trace | t ] on | wyłącz

śledzenie na umożliwia śledzenie wywołań interfejsu API sqlLocalDB dla bieżącego użytkownika. śledzenie wyłączone wyłącza śledzenie.

-?

Zwraca krótkie opisy każdej opcji SqlLocalDB.

Uwagi

Nazwa wystąpienia musi być zgodna z regułami identyfikatorów SQL Server lub musi być ujęta w cudzysłowie podwójnym.

Wykonanie SqlLocalDB bez argumentów zwraca tekst pomocy.

Operacje inne niż uruchamianie mogą być wykonywane tylko na wystąpieniu należącym do aktualnie zalogowanego użytkownika. Wystąpienie SQLLOCALDB, gdy jest udostępnione, może być uruchomione i zatrzymane tylko przez właściciela wystąpienia.

Przykłady

A. Tworzenie wystąpienia bazy danych LocalDB

Poniższy przykład tworzy wystąpienie programu SQL Server Express LocalDB o nazwie DEPARTMENT przy użyciu plików binarnych programu SQL Server i uruchamia wystąpienie.

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. Pracuj z udostępnionym wystąpieniem LocalDB

Otwórz wiersz polecenia przy użyciu uprawnień administratora. Zastąp <password> prawidłowym hasłem.

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

Wykonaj następujący kod, aby połączyć się z udostępnionym wystąpieniem LocalDB, używając loginu NewLogin. Zastąp <password> prawidłowym hasłem.

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

Zobacz też