共用方式為


SqlLocalDB 公用程式

適用於:SQL Server

使用 SqlLocalDB 工具建立 SQL Server Express LocalDB 的實例。 SqlLocalDB 工具(SqlLocalDB.exe)是一個命令列工具,讓使用者與開發者能夠建立並管理 SQL Server Express LocalDB 實例。 關於如何使用 LocalDB 的資訊,請參閱 SQL Server 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     | -? ]
}

引數

[ 建立 | c ] <實例名稱><實例版本> [ -s ]

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

[ 分享 | h ]

使用指定的共享名稱共享指定的 LocalDB 私有實例。 如果省略使用者 SID 或帳戶名稱,會預設為目前的使用者。

[ 取消分享 | u ]

停止分享指定的 LocalDB 共享實例。

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

刪除指定的 SQL Server Express LocalDB 實例。

[ 開始 | s ]「<實例名稱>

啟動指定的 SQL Server Express LocalDB 實例。 當成功時,該敘述會回傳 LocalDB 的命名管線位址。

[ 停止 | p ] <實例名稱> [ -i ] [ -k ]

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

[資訊] [ <實例名稱> ]

列出目前使用者擁有的所有 SQL Server Express LocalDB 實例。

<instance-name> 會回傳指定 SQL Server Express LocalDB 實例的名稱、版本、狀態(執行中或停止)、最後啟動時間,以及 LocalDB 的本地管線名稱。

[ 痕跡 | t ] { 開 | 關 }

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 的共用執行個體

使用管理員權限開啟命令提示字元。 以有效的密碼取代 <password>

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

執行以下程式碼,透過登入連接 LocalDB NewLogin 的共享實例。 以有效的密碼取代 <password>

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