다음을 통해 공유


SQL Server Data Tools, SDK 스타일(프리뷰)

SSDT(SQL Server Data Tools)는 SQL Server 데이터베이스 및 Azure SQL 데이터베이스를 빌드하는 데 중점을 두고 Visual Studio의 개발 도구 세트입니다. Visual Studio의 SDK 스타일 SQL 프로젝트를 사용하면 Visual Studio 2022에서 사용할 수 있는 SQL Server Data Tools, SDK 스타일(프리뷰) 기능의 일부로 차세대 SQL 프로젝트를 사용할 수 있습니다. SQL 프로젝트 기능은 CI/CD 파이프라인으로 확장되므로 SqlPackage CLI를 사용하여 데이터베이스 프로젝트의 빌드 및 배포를 자동화할 수 있습니다.

개요

원래 SQL 프로젝트 형식은 MSBuild(.NET Framework)를 기반으로 하며 Visual Studio의 SQL Server Data Tools에서 사용하는 형식입니다. SDK 스타일 프로젝트 형식은 새 SDK 스타일 프로젝트(Microsoft.Build.Sql)를 기반으로 하며 Azure Data Studio 및 VS Code용 SQL Database 프로젝트 확장에서 사용하는 형식입니다. Microsoft.Build.Sql 프로젝트 SDK는 원래 SQL 프로젝트보다 더 유연하며 다음과 같은 새로운 기능을 포함합니다.

  • .NET 8 지원(플랫폼 간)
  • 데이터베이스 참조에 대한 NuGet 패키지 참조
  • 프로젝트의 .sql 파일에 대한 기본 글로빙 패턴

새 개발 작업은 나중에 지원될 형식이기 때문에 SDK 스타일 프로젝트 형식을 사용하는 것이 좋습니다. SDK 스타일 프로젝트에는 원래 SQL 프로젝트의 기능 상위 집합이 있으며 기존 SQL 프로젝트는 프로젝트 파일 수정을 통해 SDK 스타일 프로젝트로 변환할 수 있습니다. 기능 검사의 예외는 .NET Framework가 필요하고 SDK 스타일 프로젝트에서 지원되지 않는 SQLCLR 개체에 대한 지원입니다.

SQL 프로젝트에 대한 추가 설명서는 SQL Database 프로젝트 항목에서 사용할 수 있으며 Microsoft.Build.Sql SDK는 GitHubNuGet.org에서 사용할 수 있습니다.

설치

Warning

SDK 스타일 SQL 프로젝트 기능은 프리뷰로 제공되며 원래 SQL 프로젝트와 함께 병렬 설치는 지원되지 않습니다. 독립 실행형 Visual Studio 인스턴스에 SDK 스타일 SQL 프로젝트를 설치하는 것이 좋습니다.

Visual Studio 2022에서 SDK 스타일 SQL 프로젝트를 설치하려면 다음 단계를 수행합니다.

  1. Visual Studio 다운로드 페이지에서 Visual Studio 2022 프리뷰(17.12 프리뷰 2 이상)를 다운로드하여 설치합니다.
  2. 설치하는 동안 개별 구성 요소 탭을 선택하고 "SQL"을 검색하여 "SQL Server Data Tools SDK 스타일(프리뷰)"을 찾아 선택합니다. 이 항목을 선택하면 필요한 종속성이 자동으로 선택됩니다.
  3. 워크로드 또는 추가 기능을 선택하지 않고 설치를 계속합니다.

개별 구성 요소 탭이 열려 있는 Visual Studio 설치 관리자의 스크린샷.

Visual Studio 설명서에서는 개별 구성 요소를 선택하도록 Visual Studio 설치를 수정하는 방법에 대한 추가 정보를 제공합니다.

SDK 스타일 SQL 프로젝트를 원래 SQL 프로젝트와 나란히 설치하는 경우 예기치 않은 동작이 발생할 수 있으며, SDK 스타일 SQL Server 데이터 도구를 독립 실행형 구성 요소로 설치하는 것이 좋습니다. Visual Studio 설치에 어떤 구성 요소가 포함되어 있는지 확인하려면 Visual Studio의 도움말 메뉴를 사용하여 Microsoft Visual Studio 정보를 선택합니다. 단일 시스템에서 여러 Visual Studio 인스턴스를 활용하기 위한 몇 가지 방법을 사용할 수 있습니다.

  • Visual Studio 2022 및 Visual Studio 2022 프리뷰와 같은 Visual Studio의 다른 릴리스 채널을 설치합니다.
  • Visual Studio Community 및 Visual Studio Enterprise 등 다른 버전의 Visual Studio를 설치합니다.
  • 특정 디렉터리에 설치하여 Visual Studio 인스턴스를 이전에 설치된 버전과 분리합니다.

제한 사항

SQL 프로젝트 도구 간의 기능에 대한 전체 비교는 SQL 프로젝트 도구에서 사용할 수 있습니다. Visual Studio의 SDK 스타일 SQL 프로젝트 기능에는 다음과 같은 제한 사항이 있습니다.

  • 원본 SQL 프로젝트와 나란히 설치하는 것은 지원되지 않습니다.
  • Visual Studio 17.12 프리뷰 2에서 SQL 프로젝트 파일은 .sqlprojx 대신 확장자 .sqlproj를 사용합니다.
  • SQLCLR 개체는 지원되지 않습니다.
  • 스키마 비교 인터페이스를 사용할 수 없습니다.
  • 테이블 디자이너 인터페이스를 사용할 수 없습니다.
  • 데이터 비교 인터페이스를 사용할 수 없습니다.
  • 데이터베이스 단위 테스트를 사용할 수 없습니다.

Visual Studio에서 SDK 스타일 SQL 프로젝트에 대한 지원은 프리뷰 상태이며 최신 Visual Studio 2022 프리뷰 릴리스에서 설치하는 것이 좋습니다. Visual Studio의 SQL 프로젝트 기능은 현재 개발 중이며 Developer Community를 통한 피드백을 환영합니다.

기존 프로젝트 변환

Microsoft.Build.Sql SDK 스타일 SQL 프로젝트를 처음부터 만들거나 기존 SQL 프로젝트에서 변환할 수 있습니다. 원본 SQL 프로젝트를 Microsoft.Build.Sql 프로젝트로 변환할 수 있지만 변환하기 전에 프로젝트의 백업을 만드는 것이 좋습니다. 기존 SQL 프로젝트를 SDK 스타일 프로젝트로 변환하려면 원본 SQL 프로젝트 변환 방법 가이드의 단계를 따릅니다.