대상 플랫폼 개요
적용 대상:
Microsoft Fabric의 SQL ServerAzure SQL Database Azure SQL Managed Instance SQL 데이터베이스
대상 플랫폼 설정은 프로젝트 빌드 중에 T-SQL 구문 및 시스템 함수와 같은 프로젝트에 포함된 기능에 대한 지원의 유효성을 검사하는 데 사용되는 프로젝트 속성입니다. 대상 플랫폼 설정은 .dacpac 빌드 아티팩트에 통합되고 배포 중에 대상 플랫폼 설정이 대상 데이터베이스에 대해 확인되어 호환성을 보장합니다. 대상 플랫폼이 데이터베이스와 일치하지 않으며, 게시 속성 /p:AllowIncompatiblePlatform=true을(를) 지정하지 않으면 배포가 시작되지 않습니다.
SQL 프로젝트 파일 샘플 및 구문
대상 플랫폼 프로젝트 속성은 .sqlproj 항목 아래 <PropertyGroup> 파일의 DSP 태그에 포함됩니다.
<Project DefaultTargets="Build">
<Sdk Name="Microsoft.Build.Sql" Version="0.2.4-preview" />
<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 데이터베이스)Microsoft.Data.Tools.Schema.Sql.SqlDbFabricDatabaseSchemaProvider(패브릭 또는 패브릭 미러된 SQL Database의 SQL Database, 미리 보기)Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider(Azure Synapse SQL 풀)Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider(Azure Synapse 서버리스 SQL 풀)Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider(Microsoft Fabric의 Synapse Data Warehouse)
대상 플랫폼 변경
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 게시 속성을 사용합니다.