SQL Server Express LocalDB 헤더 및 버전 정보

SQL Server Express LocalDB 인스턴스 API에 대한 별도의 헤더 파일이 없습니다. LocalDB 함수 서명 및 오류 코드는 SQL Server Native Client 헤더 파일(sqlncli.h)에 정의됩니다. LocalDB 인스턴스 API를 사용하려면 프로젝트에 sqlncli.h 헤더 파일을 포함해야 합니다.

LocalDB 버전 관리

LocalDB 설치에서는 SQL Server 주 버전당 단일 이진 파일 집합을 사용합니다. 이러한 LocalDB 버전은 독립적으로 유지되고 패치됩니다. 따라서 사용자가 사용할 LocalDB 기준선 릴리스(주 SQL Server 버전)를 직접 지정해야 합니다. 버전은 .NET Framework System.Version 클래스에 정의된 표준 버전 형식으로 지정됩니다.

major.minor[.build[.revision]]

버전 문자열의 처음 두 번호(major 및 minor)는 필수 항목입니다. 버전 문자열의 마지막 두 번호(build 및 revision)는 선택 항목이며 사용자가 지정하지 않으면 기본적으로 0으로 설정됩니다. 즉, 사용자가 LocalDB 버전 번호로 "11.2"만 지정한 경우 "11.2.0.0"으로 지정한 것으로 처리됩니다.

LocalDB 설치에 대한 버전은 SQL Server 인스턴스 레지스트리 키 아래의 MSSQLServer\CurrentVersion 레지스트리 키에 정의됩니다. 예를 들면 다음과 같습니다.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\MSSQL11E.LOCALDB\ MSSQLServer\CurrentVersion: “CurrentVersion”=”10.0.2531.0”

동일한 워크스테이션에서 여러 LocalDB 버전을 함께 설치할 수 있습니다. 하지만 사용자 코드에서는 항상 로컬 컴퓨터에서 사용 가능한 최신 SQLUserInstance DLL을 사용하여 LocalDB 인스턴스에 연결합니다.

SQLUserInstance DLL 찾기

SQLUserInstance DLL을 찾기 위해 클라이언트 공급자는 다음 레지스트리 키를 사용합니다.

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Local DB\Installed Versions]

이 키 아래에는 컴퓨터에 설치된 각 LocalDB 버전별로 하나씩 키 목록이 있습니다. 각 키는 <major-version>.<minor-version> 형식의 LocalDB 버전 번호로 이름이 지정됩니다. 예를 들어 SQL Server 2012의 키를 11.0으로 지정합니다. 각 버전 키 아래에는 해당 버전과 함께 설치되는 SQLUserInstance.dll 파일의 전체 경로를 정의하는 InstanceAPIPath 이름-값 쌍이 있습니다. 다음 예에서는 LocalDB 버전 11.0 및 12.0이 설치된 컴퓨터에 대한 레지스트리 항목을 보여 줍니다.

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Local DB\Installed Versions\11.0]
"InstanceAPIPath"="C:\\Program Files\\Microsoft SQL Server\\110\\LocalDB\\Binn\\SqlUserInstance.dll"
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Local DB\Installed Versions\12.0]
"InstanceAPIPath"="C:\\Program Files\\Microsoft SQL Server\\120\\LocalDB\\Binn\\SqlUserInstance.dll"]

클라이언트 공급자는 설치된 모든 버전 중에서 최신 버전을 찾고 연결된 InstanceAPIPath 값에서 SQLUserInstance DLL 파일을 로드해야 합니다.

64비트 Windows의 WOW64 모드

64비트 LocalDB 설치에는 WOW64(Windows-32-on-Windows-64) 모드에서 실행 중인 32비트 응용 프로그램에서 LocalDB를 사용할 수 있도록 해주는 추가 레지스트리 키 집합이 있습니다. 특히 64비트 Windows에서 LocalDB MSI는 다음과 같은 레지스트리 키를 만듭니다.

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Wow6432Node\Microsoft SQL Server Local DB\Installed Versions\11.0]
"InstanceAPIPath"="C:\\Program Files (x86)\\Microsoft SQL Server\\110\\LocalDB\\Binn\\SqlUserInstance.dll"
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Wow6432Node\Microsoft SQL Server Local DB\Installed Versions\12.0]
"InstanceAPIPath"="C:\\Program Files (x86)\\Microsoft SQL Server\\120\\LocalDB\\Binn\\SqlUserInstance.dll"]

Installed Versions 키를 가진 64비트 프로그램은 64비트 SQLUserInstance DLL 버전을 가리키는 값을 표시하고, WOW64 모드의 64비트 Windows에서 실행 중인 32비트 프로그램은 Wow6432Node 하이브 아래에 있는 Installed Versions 키에 자동으로 리디렉션됩니다. 이 키는 32비트 SQLUserInstance DLL 버전을 가리키는 값을 포함합니다.

LOCALDB_DEFINE_PROXY_FUNCTIONS 사용

LocalDB 인스턴스 API는 SqlUserInstance DLL의 검색과 로드를 자동화하는 LOCALDB_DEFINE_PROXY_FUNCTIONS 상수를 정의합니다.

이 상수에 의해 설정되는 코드 섹션은 각 LocalDB API에 대한 프록시 구현을 제공합니다. 프록시 구현은 공통 함수를 사용하여 최근에 설치된 SqlUserInstance DLL의 진입점에 바인딩한 다음 요청을 전달합니다.

프록시 함수는 sqlncli.h 파일을 포함하기 전에 LOCALDB_DEFINE_PROXY_FUNCTIONS 상수가 사용자 코드에 정의되는 경우에만 사용됩니다. 이 상수는 모든 API 진입점에 대해 외부 함수 이름을 정의하기 때문에 원본 모듈(.cpp file) 하나에만 정의해야 합니다. 이 상수는 각 LocalDB API에 대한 프록시 구현을 제공합니다.

다음 코드 예제에서는 네이티브 C++ 코드에서 매크로를 사용하는 방법을 보여 줍니다.

// Define the LOCALDB_DEFINE_PROXY_FUNCTIONS constant to enable the LocalDB proxy functions 
// The #define has to take place BEFORE the API header file (sqlncli.h) is included
#define LOCALDB_DEFINE_PROXY_FUNCTIONS
#include <sqlncli.h>
…
HRESULT hr = S_OK;

// Create LocalDB instance by calling the create API proxy function included by macro
if (FAILED(hr = LocalDBCreateInstance( L“11.0”, L“name”, 0)))
{
…
}
…