SqlLocalDB 公用程式
適用於: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 執行個體。
[ share | h ]
使用指定的共用名稱來共用指定的 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