적용 대상:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric의 SQL 데이터베이스
대상 플랫폼 설정은 프로젝트 빌드 중에 T-SQL 구문 및 시스템 함수와 같은 프로젝트에 포함된 기능에 대한 지원의 유효성을 검사하는 데 사용되는 프로젝트 속성입니다. 대상 플랫폼 설정은 빌드 아티팩트에 .dacpac 통합되고 배포 중에 대상 플랫폼 설정이 대상 데이터베이스에 대해 확인되어 호환성을 보장합니다. 대상 플랫폼이 데이터베이스와 일치하지 않으면 게시 속성을/p:AllowIncompatiblePlatform=true 지정하지 않으면 배포가 시작되지 않습니다.
SQL 프로젝트 파일 샘플 및 구문
대상 플랫폼 프로젝트 속성은 항목 아래 파일의 DSP.sqlproj 태그에 <PropertyGroup> 포함됩니다.
<Project DefaultTargets="Build">
<Sdk Name="Microsoft.Build.Sql" Version="1.0.0" />
<PropertyGroup>
<Name>AdventureWorks</Name>
<DSP>Microsoft.Data.Tools.Schema.Sql.SqlAzureV12DatabaseSchemaProvider</DSP>
</PropertyGroup>
...
태그의 대상 플랫폼에 대한 유효한 값은 DSP 다음과 같습니다.
-
Microsoft.Data.Tools.Schema.Sql.Sql120DatabaseSchemaProvider(SQL Server 2014) -
Microsoft.Data.Tools.Schema.Sql.Sql130DatabaseSchemaProvider(SQL Server 2016) -
Microsoft.Data.Tools.Schema.Sql.Sql140DatabaseSchemaProvider(SQL Server 2017) -
Microsoft.Data.Tools.Schema.Sql.Sql150DatabaseSchemaProvider(SQL Server 2019) -
Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider(SQL Server 2022) -
Microsoft.Data.Tools.Schema.Sql.SqlAzureV12DatabaseSchemaProvider(Azure SQL Database) -
Microsoft.Data.Tools.Schema.Sql.SqlDbFabricDatabaseSchemaProvider(Fabric SQL Database 또는 Fabric 미러된 SQL Database 내부의 SQL 데이터베이스, 미리 보기) -
Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider(Azure Synapse SQL 풀) -
Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider(Azure Synapse 서버리스 SQL 풀) -
Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider(패브릭 데이터 웨어하우스)
대상 플랫폼 변경
Visual Studio에서 SQL 프로젝트의 대상 플랫폼을 변경하려면 솔루션 탐색기 에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 속성 창의 프로젝트 설정 탭에 있는 대상 플랫폼 드롭다운 목록에서 원하는 대상 플랫폼을 선택합니다.
Visual Studio에서 SQL 프로젝트의 대상 플랫폼을 변경하려면 솔루션 탐색기 에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 속성 창의 프로젝트 설정 탭에 있는 대상 플랫폼 드롭다운 목록에서 원하는 대상 플랫폼을 선택합니다.
SQL Database 프로젝트 확장에서 SQL 프로젝트의 대상 플랫폼을 변경하려면 데이터베이스 프로젝트 보기에서 프로젝트를 마우스 오른쪽 단추 로 클릭하고 대상 플랫폼 변경을 선택합니다. 드롭다운 목록에서 새 대상 플랫폼을 선택합니다.
또는 .sqlproj 파일을 직접 편집하여 대상 플랫폼을 변경할 수 있습니다.
.sqlproj 보기에서 파일을 열거나 데이터베이스 프로젝트 보기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 .sqlproj 파일 편집을 선택하여 파일을 엽니다. 텍스트 편집기에서 DSP 태그의 값을 원하는 대상 플랫폼으로 변경합니다.
파일에 지정된 .sqlproj 대상 플랫폼과 다른 대상 플랫폼에 대한 SQL 프로젝트를 빌드하려면 명령줄 인수를 /p:DSP= 사용합니다. 예를 들어 SQL Server 2019 호환성을 위한 SQL 프로젝트를 빌드하려면 다음을 수행합니다.
dotnet build /p:DSP=Microsoft.Data.Tools.Schema.Sql.Sql150DatabaseSchemaProvider
다른 대상 플랫폼에 게시
SQL 프로젝트를 게시할 때 프로젝트의 대상 플랫폼은 데이터베이스의 대상 플랫폼과 일치해야 합니다. 대상 플랫폼이 일치하지 않으면 오류와 함께 변경 내용을 적용하기 전에 배포가 종료됩니다. 다른 대상 플랫폼이 있는 데이터베이스에 프로젝트를 게시하려면 /p:AllowIncompatiblePlatform=true 사용합니다.