SQL Server Express LocalDB 執行個體 API 參考

  • 發行項

在傳統、服務架構的 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 二進位檔存在，則自動實例一律存在。

刪除、共用及取消共用等其他執行個體管理作業也適用於自動執行個體。 具體而言，刪除自動執行個體會有效地重設執行個體，進而在下一個啟動作業中重新建立。 如果系統資料庫損毀，可能需要刪除自動執行個體。

自動執行個體命名規則

自動 LocalDB 執行個體的執行個體名稱採用屬於保留命名空間的特殊模式。 為了避免與具名 LocalDB 執行個體發生名稱衝突，這麼做是有必要的。

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

不合法的自動執行個體名稱範例如下：

  • 11.0 (在開頭) 遺漏 「v」 字元

  • v11 (遺漏句號及第二組版本號碼)

  • v11. (遺漏第二組版本號碼)

  • v11.0.1.2 (版本號碼超過兩個部分)

具名 LocalDB 執行個體

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

具名執行個體建立

使用者建立具名執行個體時，必須透過 LocalDB 管理 API 以明確的方式建立，或透過 Managed 應用程式的 app.config 檔案以隱含的方式建立。 Managed 應用程式也可以使用 API。

每個具名執行個體具有相關聯的 LocalDB 版本；亦即指向一組指定的 LocalDB 二進位檔。 您可以在執行個體建立程序期間設定具名執行個體的版本。

具名執行個體命名規則

LocalDB 執行個體名稱最多可以包含共 128 個字元 (這是 sysname 資料類型加諸的限制)。 這與傳統的 SQL Server 執行個體名稱相較下十分不同，傳統的執行個體限制使用 16 個 ASCII 字元的 NetBIOS 名稱。 此差異的原因是 LocalDB 會將資料庫視為檔案，因此隱含以檔案為基礎的語意，因此，使用者對於選擇實例名稱有更大的自由度是直覺的。

LocalDB 執行個體名稱可以在檔案名稱元件內包含合法的任何 Unicode 字元。 檔案名元件中的不合法字元通常包含下列字元：ASCII/Unicode 字元 1 到 31，以及引號 (「) 、小於 (<) 、大於 (>) 、 pipe (|) 、backspace (\b) 、tab (\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 執行個體的函數。