다음을 통해 공유


SQL Server Express LocalDB

적용 대상: SQL Server

Microsoft SQL Server Express LocalDB는 개발자를 대상으로 하는 SQL Server Express 기능입니다. 고급 서비스가 포함된 SQL Server Express 버전에서 사용할 수 있습니다.

LocalDB를 설치하면 SQL Server 데이터베이스 엔진을 시작하는 데 필요한 최소한의 파일 집합이 복사됩니다. LocalDB가 설치되면 특수 연결 문자열을 사용하여 연결을 시작할 수 있습니다. 연결할 때, 필요한 SQL Server 인프라가 자동으로 생성되고 시작되므로 복잡한 구성 태스크 없이 애플리케이션에서 데이터베이스를 사용하도록 할 수 있습니다. 개발자 도구는 SQL Server 데이터베이스 엔진의 전체 서버 인스턴스를 관리할 필요 없이 Transact-SQL 코드를 작성하고 테스트할 수 있게 해주는 SQL Server 데이터베이스 엔진을 개발자에게 제공합니다.

설치 미디어

LocalDB는 SQL Server Express 설치 중에 선택하는 기능이며, 미디어를 다운로드할 때 사용할 수 있습니다. 미디어를 다운로드하려면 Express Advanced 또는 LocalDB 패키지를 선택합니다.

Visual Studio 2019 및 Visual Studio 2022를 사용하는 고객은 SQL Server 2019 Express 버전을 설치해야 합니다.

LocalDB 설치 관리자(SqlLocalDB.msi)는 Express Core를 제외한 모든 버전의 설치 미디어에서 사용할 수 있으며, <installation_media_root>\<LCID>_ENU_LP\x64\Setup\x64 폴더에 있습니다. LCID는 로캘 식별자 또는 언어 코드입니다. 예를 들어 LCID 값 1033은 en-US 로캘을 나타냅니다.

또는 데이터 스토리지 및 처리 워크로드의 일부로, ASP.NET 및 웹 개발 워크로드의 일부로 또는 개별 구성 요소로 Visual Studio 설치 관리자를 통해 LocalDB를 설치할 수 있습니다.

LocalDB 설치

설치 마법사나 SqlLocalDB.msi 프로그램을 사용하여 LocalDB를 설치합니다. LocalDB는 SQL Server Express LocalDB를 설치할 때 옵션입니다.

설치 중에 기능 선택/공유 기능 페이지에서 LocalDB를 선택합니다. 각 주요 SQL Server 데이터베이스 엔진 버전에 대해 LocalDB 이진 파일을 하나만 설치할 수 있습니다. 여러 데이터베이스 엔진 프로세스를 시작할 수 있으며, 이러한 프로세스에는 모두 동일한 이진 파일이 사용됩니다. LocalDB로 시작된 SQL Server 데이터베이스 엔진 인스턴스는 SQL Server Express와 동일한 제한 사항을 갖습니다.

SQL Server Express LocalDB의 인스턴스는 SqlLocalDB.exe 유틸리티를 사용하여 관리됩니다. 더 이상 사용되지 않는 SQL Server Express 사용자 인터페이스 기능 대신 SQL Server Express LocalDB를 사용해야 합니다.

Description

LocalDB 설치 프로그램은 SqlLocalDB.msi 프로그램을 사용하여 컴퓨터에 필요한 파일을 설치합니다. 설치가 끝나면 LocalDB는 SQL Server 데이터베이스를 만들고 열 수 있는 SQL Server Express 인스턴스가 됩니다. 데이터베이스의 시스템 데이터베이스 파일은 로컬 AppData 경로에 저장되는데, 이 경로는 일반적으로 숨겨져 있습니다. 예들 들어 C:\Users\<user>\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\LocalDBApp1\입니다. 사용자 데이터베이스 파일은 일반적으로 C:\Users\<user>\Documents\ 폴더와 같은 사용자가 지정하는 위치에 저장됩니다.

애플리케이션에 LocalDB를 포함하는 방법에 대한 자세한 내용은 Visual Studio 로컬 데이터 개요, Visual Studio에서 데이터베이스 만들기 및 테이블 추가를 참조하세요.

LocalDB API에 대한 자세한 내용은 SQL Server Express LocalDB 참조에서 확인할 수 있습니다.

SqlLocalDB 유틸리티는 LocalDB의 새 인스턴스를 만들고 LocalDB 인스턴스를 시작 및 중지할 수 있으며 LocalDB를 관리하는 데 도움이 되는 옵션을 포함합니다. SqlLocalDB 유틸리티에 대한 자세한 내용은 SqlLocalDB 유틸리티를 참조하세요.

LocalDB의 인스턴스 데이터 정렬은 SQL_Latin1_General_CP1_CI_AS로 설정되며 변경할 수 없습니다. 데이터베이스 수준, 열 수준 및 식 수준 데이터 정렬은 일반적으로 지원됩니다. 포함된 데이터베이스는 포함된 데이터베이스데이터 정렬에 정의된 메타데이터 및 tempdb 데이터 정렬 규칙을 따릅니다.

제한

  • LocalDB는 SQL Server Management Studio를 통해 원격으로 관리할 수 없습니다.

  • LocalDB는 병합 복제 구독자일 수 없습니다.

  • LocalDB는 FILESTREAM을 지원하지 않습니다.

  • LocalDB는 Service Broker에 대한 로컬 큐만 허용합니다.

  • NT AUTHORITY\SYSTEM과(와) 같은 기본 제공 계정이 소유하는 LocalDB 인스턴스에는 Windows 파일 시스템 리디렉션으로 인한 관리 편의성 문제가 있을 수 있습니다. 대신 일반 Windows 계정을 소유자로 사용하세요.

자동 및 명명된 인스턴스

LocalDB는 자동 인스턴스 및 명명된 인스턴스의 두 가지 인스턴스 유형을 지원합니다. 컴퓨터의 다른 사용자는 동일한 이름의 인스턴스를 가질 수 있습니다. 각 인스턴스는 자체 프로세스에서 해당 사용자로 실행됩니다.

자동 인스턴스

LocalDB의 자동 인스턴스는 공용입니다. 이 인스턴스는 자동으로 생성 및 관리되고 모든 애플리케이션에서 사용될 수 있습니다. 사용자의 컴퓨터에 설치되는 모든 버전의 LocalDB에는 LocalDB의 자동 인스턴스가 하나씩 있습니다. LocalDB의 자동 인스턴스는 효율적으로 관리됩니다. 인스턴스를 만들 필요 없이 그대로 작동합니다. 이 기능을 사용하면 애플리케이션을 쉽게 설치할 수 있으며 다른 컴퓨터에 쉽게 마이그레이션할 수 있습니다. 대상 컴퓨터에 특정 버전의 LocalDB가 설치되어 있을 경우 해당 버전에 대한 LocalDB의 자동 인스턴스를 대상 컴퓨터에서도 사용할 수 있습니다. LocalDB의 자동 인스턴스는 예약된 네임스페이스에 속하는 특수한 인스턴스 이름 패턴을 사용합니다. 이러한 방식은 명명된 LocalDB 인스턴스와 이름이 충돌하는 것을 방지합니다. 자동 인스턴스의 이름은 MSSQLLocalDB입니다.

명명된 인스턴스

LocalDB의 명명된 인스턴스는 프라이빗입니다. 이 인스턴스는 인스턴스 만들기와 관리를 담당하는 단일 애플리케이션에 의해 소유됩니다. 명명된 인스턴스는 다른 인스턴스로부터의 격리를 제공하고 다른 데이터베이스 사용자와의 리소스 경합을 줄여서 성능을 향상시킬 수 있습니다. LocalDB 관리 API를 통해 명시적으로 명명된 인스턴스를 생성하거나 관리형 애플리케이션에 대한 app.config 파일을 통해 암시적으로(원하는 경우 관리형 애플리케이션도 API를 사용할 수 있지만) 명명된 인스턴스를 생성해야 합니다. LocalDB의 각 명명된 인스턴스에는 해당 LocalDB 바이너리 집합을 가리키는 LocalDB 버전이 연결되어 있습니다. LocalDB의 인스턴스 이름은 sysname 데이터 형식이며 최대 128자를 포함할 수 있습니다. (이 인스턴스 이름은 15 ASCII 문자의 일반 NetBIOS 이름으로 제한하는 SQL Server의 일반적인 명명된 인스턴스와 다릅니다.) LocalDB 인스턴스 이름은 파일 이름에 사용할 수 있는 모든 유니코드 문자를 포함할 수 있습니다. 자동 인스턴스 이름을 사용하는 명명된 인스턴스는 자동 인스턴스가 됩니다.

LocalDB의 공유 인스턴스

컴퓨터의 여러 사용자가 단일 LocalDB 인스턴스에 연결해야 하는 시나리오를 지원하기 위해 LocalDB는 인스턴스 공유를 지원합니다. 인스턴스 소유자는 컴퓨터의 다른 사용자가 자신의 인스턴스에 연결하도록 허용할 수 있습니다. LocalDB의 자동 및 명명된 인스턴스는 모두 공유 가능합니다. LocalDB 인스턴스를 공유하려면 사용자가 해당 인스턴스에 대한 공유 이름(별칭)을 선택합니다. 공유 이름은 컴퓨터의 모든 사용자에게 표시되기 때문에 이 공유 이름은 해당 컴퓨터에서 고유해야 합니다. LocalDB 인스턴스의 공유 이름은 LocalDB의 명명된 인스턴스와 형식이 동일합니다.

컴퓨터의 관리자만 LocalDB의 공유 인스턴스를 만들 수 있습니다. LocalDB의 공유 인스턴스는 관리자 또는 LocalDB의 공유 인스턴스 소유자가 공유를 해제할 수 있습니다. LocalDB인스턴스를 공유 및 공유 해제하려면 LocalDB API의 LocalDBShareInstanceLocalDBUnShareInstance 메서드를 사용하거나 SqlLocalDB 유틸리티의 공유 및 공유 해제 옵션을 사용합니다.

LocalDB 시작 및 LocalDB에 연결

이 섹션에서는 자동 인스턴스, 명명된 인스턴스 또는 공유 인스턴스에 연결하는 방법을 설명합니다.

자동 인스턴스에 연결

LocalDB를 사용하는 가장 쉬운 방법은 연결 문자열 Server=(localdb)\MSSQLLocalDB;Integrated Security=true을(를) 사용하여 현재 사용자가 소유한 자동 인스턴스에 연결하는 것입니다. 파일 이름을 사용하여 특정 데이터베이스에 연결하려면 Server=(LocalDB)\MSSQLLocalDB;Integrated Security=true;AttachDbFileName=D:\Data\MyDB1.mdf와 비슷한 연결 문자열을 사용하여 연결합니다.

참고 항목

컴퓨터에서 사용자가 처음으로 LocalDB에 연결하려고 시도하는 경우 자동 인스턴스가 생성되고 시작되어야 합니다. 인스턴스를 만드는 추가 시간으로 인해 시간 초과 메시지와 함께 연결 시도가 실패할 수 있습니다. 이 경우 만들기 프로세스가 완료되도록 몇 초 정도 기다린 후에 다시 연결하세요.

명명된 인스턴스를 만들고 연결합니다.

자동 인스턴스 외에도 LocalDB는 명명된 인스턴스를 지원합니다. SqlLocalDB.exe 프로그램을 사용하여 LocalDB의 명명된 인스턴스를 만들고, 시작 및 중지할 수 있습니다. SqlLocalDB.exe에 대한 자세한 내용은 SqlLocalDB 유틸리티를 참조하세요.

REM Create an instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" create LocalDBApp1
REM Start the instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" start LocalDBApp1
REM Gather information about the instance of LocalDB
"C:\Program Files\Microsoft SQL Server\160\Tools\Binn\SqlLocalDB.exe" info LocalDBApp1

이전 코드 샘플의 마지막 줄은 다음 표와 유사한 정보를 반환합니다.

범주
이름 LocalDBApp1
버전 <Current version>
공유 이름 ""
담당자 <Your Windows user>
자동 만들기 No
State(상태) Running
마지막 시작 시간 <Date and time>
인스턴스 파이프 이름 np:\\.\pipe\LOCALDB#F365A78E\tsql\query

참고 항목

응용 프로그램에서 .NET Framework 4.0.2 이전 버전을 사용하는 경우 LocalDB의 명명된 파이프에 직접 연결해야 합니다. 인스턴스 파이프 이름 값은 LocalDB 인스턴스가 수신 대기 중인 명명된 파이프입니다. LOCALDB# 다음의 인스턴스 파이프 이름 부분은 LocalDB 인스턴스가 시작될 때마다 변경됩니다. SQL Server Management Studio를 사용하여 LocalDB 인스턴스에 연결하려면 데이터베이스 엔진에 연결 대화 상자의 서버 이름 상자에 인스턴스 파이프 이름을 입력합니다. 사용자 지정 프로그램에서 SqlConnection conn = new SqlConnection(@"Server=np:\\.\pipe\LOCALDB#F365A78E\tsql\query");와 비슷한 연결 문자열을 사용하여 LocalDB 인스턴스에 연결할 수 있습니다.

LocalDB의 공유 인스턴스에 연결

LocalDB의 공유 인스턴스에 연결하려면 연결 문자열에 \.\(백슬래시 + 점 + 백슬래시)를 추가하여 공유 인스턴스에 대해 예약된 네임스페이스를 참조합니다. 예를 들어 이름이 AppData인 LocalDB의 공유 인스턴스에 연결하려면 연결 문자열의 일부로 (localdb)\.\AppData와 같은 연결 문자열을 사용합니다. 자신이 소유하고 있지 않은 LocalDB 공유 인스턴스에 연결하는 사용자는 Windows 인증 또는 SQL Server 인증 로그인을 갖고 있어야 합니다.

문제 해결

LocalDB 문제 해결에 대한 자세한 내용은 알려진 SQL Server 2012 설치 및 마이그레이션 문제를 참조하세요.

사용 권한

LocalDB SQL Server Express의 인스턴스는 사용자가 사용하기 위해 만든 인스턴스입니다. 컴퓨터의 모든 사용자는 LocalDB 인스턴스를 사용하여 데이터베이스를 만들고, 자신의 사용자 프로필에 파일을 저장하고, 자신의 자격 증명으로 프로세스를 실행할 수 있습니다. 기본적으로 LocalDB 인스턴스에 대한 액세스는 해당 인스턴스의 소유자로 제한됩니다. LocalDB에 포함된 데이터는 데이터베이스 파일에 대한 파일 시스템 액세스를 통해 보호됩니다. 공유 위치에 저장된 사용자 데이터베이스 파일은 해당 위치에 대한 파일 시스템 액세스 권한을 가진 사람이면 누구나 소유한 LocalDB 인스턴스를 사용하여 열 수 있습니다. 데이터베이스 파일이 사용자 데이터 폴더와 같은 보호되는 위치에 있으면 해당 사용자 및 해당 폴더에 대한 액세스 권한이 있는 관리자만 데이터베이스를 열 수 있습니다. LocalDB 파일은 한 번에 하나의 LocalDB 인스턴스에서만 열 수 있습니다.

LocalDB는 항상 사용자의 보안 컨텍스트에서 실행됩니다. LocalDB는 로컬 관리자 그룹의 자격 증명으로 실행되지 않습니다. 즉, LocalDB 인스턴스에서 사용하는 모든 데이터베이스 파일은 로컬 관리자 그룹의 멤버 자격을 고려하지 않고 소유 사용자의 Windows 계정을 사용하여 액세스할 수 있어야 합니다.