다음을 통해 공유

SQL Server Express LocalDB 인스턴스 API 참조

  • 아티클

기존 서비스 기반 SQL Server 환경에서는 단일 컴퓨터에 설치되는 개별 SQL Server 인스턴스가 실제로 분리됩니다. 즉, 각 인스턴스가 개별적으로 설치 및 제거되고, 별도의 이진 파일 집합을 사용하며, 별도의 서비스 프로세스에 따라 실행됩니다. SQL Server 인스턴스 이름을 사용하여 연결할 SQL Server 인스턴스를 지정합니다.

SQL Server Express LocalDB 인스턴스 API는 단순화된 "light" 인스턴스 모델을 사용합니다. 개별 LocalDB 인스턴스가 디스크와 레지스트리에서 분리되지만, 동일한 공유 LocalDB 이진 파일 집합을 사용합니다. 또한 LocalDB는 서비스를 사용하지 않으며, LocalDB 인스턴스는 LocalDB 인스턴스 API 호출을 통해 요청될 때 실행됩니다. LocalDB에서는 인스턴스 이름을 사용하여 작업할 LocalDB 인스턴스를 지정합니다.

LocalDB 인스턴스는 항상 단일 사용자가 소유하며 인스턴스를 공유하도록 설정하지 않는 한 해당 사용자의 컨텍스트에서만 액세스할 수 있습니다.

기술적으로 LocalDB 인스턴스는 기존 SQL Server 인스턴스와 다르지만 용도는 비슷합니다. 이 유사성을 강조하고 SQL Server 사용자가 보다 쉽게 이해하도록 하기 위해 인스턴스라고 지칭합니다.

LocalDB에서는 AI(Automatic Instance) 및 NI(Named Instance)의 두 가지 인스턴스를 지원합니다. LocalDB 인스턴스에 대한 식별자는 인스턴스 이름입니다.

자동 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를 통해 명시적으로 명명된 인스턴스를 만들거나, 관리 응용 프로그램에 대한 app.config 파일을 통해 암시적으로 만들어야 합니다. 관리 응용 프로그램은 API를 사용할 수도 있습니다.

명명된 각각의 인스턴스에는 연결된 LocalDB 버전이 있습니다. 즉, 지정된 LocalDB 이진 파일 집합을 가리킵니다. 명명된 인스턴스의 버전은 인스턴스를 만드는 과정에서 설정됩니다.

명명된 인스턴스 명명 규칙

LocalDB 인스턴스 이름은 최대 128자까지 지정할 수 있으며, sysname 데이터 형식에 따라 제한됩니다. 이는 NetBIOS 이름이 16자의 ASCII 문자로 제한되는 기존 SQL Server 인스턴스 이름과 비교할 때 중요한 차이점입니다. 이렇게 차이가 나는 이유는 LocalDB에서 데이터베이스를 파일로 간주하여 파일 기반 의미 체계를 적용하기 때문이며 따라서 사용자가 인스턴스 이름을 훨씬 더 자유롭게 선택할 수 있습니다.

LocalDB 인스턴스 이름은 파일 이름 구성 요소에 적합한 모든 유니코드 문자를 포함할 수 있습니다. 일반적으로 ASCII/유니코드 문자 1 - 31, 따옴표("), 보다 작음(<), 보다 큼(>), 파이프(|), 백스페이스(\b), 탭(\t), 콜론(:), 별표(*), 물음표(?), 백슬래시(\), 슬래시(/) 등은 파일 이름 구성 요소로 적합하지 않습니다. null 문자(\0)는 문자열 종료를 나타내는 데 사용되므로 허용됩니다. 첫 번째 null 문자 뒤의 모든 문자가 무시됩니다.

[!참고]

부적합한 문자 목록은 운영 체제에 따라 다르며 이후 릴리스에서 변경될 수 있습니다.

인스턴스 이름의 선행 공백과 후행 공백은 무시되므로 제거됩니다.

앞의 "자동 인스턴스 명명 규칙"에서 설명한 대로 이름이 충돌하는 것을 방지하기 위해 명명된 LocalDB 인스턴스에는 자동 인스턴스에 대한 명명 패턴을 따르는 이름을 사용할 수 없습니다. 자동 인스턴스 명명 패턴을 따르는 이름을 가진 명명 인스턴스를 만들면 사실상 기본 인스턴스가 만들어집니다.

SQL Server Express LocalDB 참조 항목