SqlLocalDB 公用程式

發行項
05/04/2023

適用於：SQL Server

使用 SqlLocalDB 公用程式建立 SQL Server Express LocalDB 的執行個體。 SqlLocalDB 公用程式 (SqlLocalDB.exe) 是一個簡單的命令列工具，可讓使用者和開發人員建立及管理 SQL Server Express LocalDB 的執行個體。如需如何使用 LocalDB 的詳細資訊，請參閱 SQL Server 2016 Express LocalDB。

語法

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

引數

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

建立新的 SQL Server Express LocalDB 執行個體。 SqlLocalDB 會使用 <執行個體版本> 引數指定的 SQL Server Express 二進位檔版本。使用至少一個十進位數的數字格式指定版本號碼。次要版本號碼 (Service Pack) 為選擇性。例如，下列兩個版本號碼都可接受：11.0 或 11.0.1186。電腦上必須安裝指定的版本。如果未指定，版本號碼會預設為 SqlLocalDB 公用程式的版本。新增 -s 會啟動新的 LocalDB 執行個體。

使用指定的共用名稱來共用指定的 LocalDB 私用執行個體。如果省略使用者 SID 或帳戶名稱，會預設為目前的使用者。

[ unshare | u ]

停止共用指定的 LocalDB 共用執行個體。

[ delete | d ] <執行個體名稱>

刪除指定的 SQL Server Express LocalDB 執行個體。

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

啟動指定的 SQL Server Express LocalDB 執行個體。當成功的陳述式傳回 LocalDB 的具名管道位址時。

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

停止指定的 SQL Server Express LocalDB 執行個體。新增 -i 會要求使用 NOWAIT 選項關閉此執行個體。新增 -k 會在未經連絡的情況下終止執行個體處理序。

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

列出目前使用者擁有的所有 SQL Server Express LocalDB 執行個體。

<執行個體名稱> 會傳回指定之 SQL Server Express LocalDB 執行個體的名稱、版本、狀態 (執行中或已停止)、上次啟動時間，以及 LocalDB 的本機管道名稱。

[ trace | t ] on | off

trace on 會針對目前使用者啟用 SqlLocalDB API 呼叫的追蹤。 trace off 停用追蹤。

`-?`

傳回每一個 SqlLocalDB 選項的簡短描述。

備註

執行個體名稱引數必須遵循 SQL Server 識別碼的規則，或者必須以雙引號括住。

不使用任何引數執行 SqlLocalDB 會傳回說明文字。

啟動以外的作業只能在屬於目前登入使用者的執行個體上執行。 SQLLOCALDB 執行個體在共用時，只能由該執行個體的擁有者啟動和停止。

範例

A. 建立 LocalDB 的執行個體

以下範例會使用 SQL Server 二進位檔建立名為 DEPARTMENT 的 SQL Server Express LocalDB 執行個體，並啟動此執行個體。

SqlLocalDB.exe create "DEPARTMENT" 12.0 -s

B. 使用 LocalDB 的共用執行個體

使用管理員權限開啟命令提示字元。

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

使用 登入執行以下程式碼以連接到 LocalDB NewLogin 的共用執行個體。

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