SQL Server Express LocalDB 參考 - 實例 API

發行項
07/04/2024

適用於：SQL Server

在傳統的服務型 SQL Server 世界中，安裝在單一計算機上的個別 SQL Server 實例會實際分隔;也就是說，每個實例都必須個別安裝及移除、有一組個別的二進位檔，並在個別的服務進程中執行。 SQL Server 實例名稱是用來指定使用者想要連線的 SQL Server 實例。

SQL Server Express LocalDB 實例 API 會使用簡化的「淺色」實例模型。雖然個別 LocalDB 實例會分隔在磁碟和登錄中，但它們會使用相同的共用 LocalDB 二進位檔集。此外，LocalDB 不會使用服務;LocalDB 實例會視需要透過LocalDB實例 API 呼叫啟動。在LocalDB中，實例名稱是用來指定使用者想要使用的LocalDB實例之哪一個。

LocalDB 實例一律由單一用戶擁有，而且只能從此使用者的內容看見和存取，除非已啟用實例共用。

雖然技術上LocalDB實例與傳統SQL Server實例不同，但其預期用途類似。這些實例稱為實例，強調這種相似性，並讓 SQL Server 使用者更直覺。

LocalDB 支援兩種實例：自動實例（AI）和具名實例（NI）。 LocalDB 實例的標識碼是實例名稱。

自動LocalDB實例

自動LocalDB實例為「公用」;系統會為用戶自動建立及管理它們，而且可供任何應用程式使用。用戶電腦上安裝的每個 LocalDB 版本都有一個自動 LocalDB 實例。

自動LocalDB實例提供順暢的實例管理。使用者不需要建立實例。這可讓用戶輕鬆地安裝應用程式，並移轉至不同的電腦。如果目標計算機已安裝指定的LocalDB版本，該版本的自動LocalDB實例也會在該電腦上提供。

自動實例管理

使用者不需要建立自動LocalDB實例。實例會在第一次使用實例時延遲建立，前提是用戶的計算機上有指定的LocalDB版本可用。從用戶的觀點來看，如果 LocalDB 二進位檔存在，則自動實例一律存在。

其他實例管理作業，例如 Delete、Share 和 Unshare，也適用於自動實例。特別是，刪除自動實例會有效地重設實例，這會在下一個開始作業上重新建立。如果系統資料庫損毀，可能需要刪除自動實例。

自動實例命名規則

自動 LocalDB 實體具有屬於保留命名空間之實例名稱的特殊模式。這是防止名稱與具名LocalDB實例發生衝突的必要條件。

自動實例名稱是 LocalDB 基準發行版本號碼，前面加上單一 “v” 字元。這看起來像「v」加上兩個數位，其之間有句點;例如，v11.0 或 V12.00。

非法自動實例名稱的範例如下：

11.0 （開頭遺漏 “v” 字元）
v11 （遺漏句號和第二個版本號碼）
v11。（缺少第二個版本號碼）
v11.0.1.2 （版本號碼有兩個以上的部分）

具名LocalDB實例

具名LocalDB實例為「私人」;實例是由負責建立和管理實例的單一應用程式所擁有。具名LocalDB實例提供隔離並改善效能。

具名實例建立

用戶必須透過LocalDB管理 API 明確建立具名實例，或透過受控應用程式的App.config 檔案隱含建立具名實例。受控應用程式也可以使用 API。

每個具名實例都有相關聯的LocalDB版本;也就是說，它會指向一組指定的LocalDB二進位檔。具名實例的版本會在實例建立程式期間設定。

具名實例命名規則

LocalDB 實例名稱最多可以有 128 個字元（限制是由 sysname 數據類型強加）。與傳統 SQL Server 實例名稱相比，這是一個顯著差異，其限製為 16 個 ASCII 字元的 NetBIOS 名稱。此差異的原因是 LocalDB 會將資料庫視為檔案，因此表示以檔案為基礎的語意，因此使用者選擇實例名稱具有更多自由度是直覺的。

LocalDB 實例名稱可以包含檔名元件內合法的任何 Unicode 字元。檔名元件中的非法字元通常包含下列字元：ASCII/Unicode 字元 1 到 31，以及引號（）、小於<> （）、大於（）、管道（|）、後空格符（\b）、製表符（\t）、冒號（:)、星號！、問號（？）、反斜杠（\）和正斜線（/）。請注意，允許 Null 字元（\0），因為它用於字串終止;將會忽略第一個 Null 字元之後的所有專案。

注意

非法字元清單可能取決於操作系統，而且未來版本可能會變更。

實例名稱中的前置和尾端空格符會被忽略，並將加以修剪。

為了避免命名衝突，具名 LocalDB 實例不能有遵循自動實例命名模式的名稱，如「自動實例命名規則」稍早所述。嘗試以遵循自動實例命名模式的名稱建立具名實例，實際上會建立預設實例。

SQL Server Express LocalDB 參考主題

SQL Server Express LocalDB 標頭和版本資訊
提供頭文件資訊和登錄機碼，以尋找LocalDB實例 API。

命令列管理工具：SqlLocalDB.exe
描述SqlLocalDB.exe，這是從命令行管理 LocalDB 實例的工具。

LocalDBCreateInstance 函式
描述用來建立新LocalDB實例的函式。

LocalDBDeleteInstance 函式
描述移除 LocalDB 實例的函式。

LocalDBFormatMessage 函式
描述傳回 LocalDB 錯誤的當地語系化描述的函式。

LocalDBGetInstanceInfo 函式
描述要取得 LocalDB 實例資訊的函式，例如是否存在、版本資訊、是否正在執行等等。

LocalDBGetInstances 函式
描述要傳回具有指定版本之所有 LocalDB 實例的函式。

LocalDBGetVersionInfo 函式
描述傳回指定 LocalDB 版本資訊的函式。

LocalDBGetVersions 函式
描述傳回電腦上所有可用的 LocalDB 版本的函式。

LocalDBShareInstance 函式
描述要共用指定LocalDB實例的函式。

LocalDBStartInstance 函式
描述啟動指定 LocalDB 實例的函式。

LocalDBStartTracing 函式
描述為使用者啟用 API 追蹤的函式。

LocalDBStopInstance 函式
描述停止指定 LocalDB 實例執行的函式。

LocalDBStopTracing 函式
描述停用使用者 API 追蹤的函式。

LocalDBUnshareInstance 函式
描述停止共用指定LocalDB實例的函式。

共用方式為