최신 버전 다운로드
이 문서에는 SqlPackage의 릴리스 버전에서 제공하는 기능 및 수정 사항이 나열되어 있습니다.
이러한 릴리스 정보를 읽는 방법
각 섹션의 적용 대상 열의 범위는 다음과 같습니다.
-
SqlPackage CLI - 명령줄 작업(게시, 가져오기, 내보내기, 추출, Parquet, 진단, dotnet 도구)
-
MSBuild/SQL 프로젝트 - SQL 프로젝트 빌드(
Microsoft.Build.Sql SDK, SSDT(SQL Server Data Tools) 통합)
-
DacFx API/ 스키마 비교 -
Microsoft.SqlServer.DacFx NuGet API, 스키마 비교
-
플랫폼 - ScriptDom, Microsoft.Data.SqlClient, .NET 지원, 시스템 DACPAC, 호환성 기본값
현재 릴리스(170.x)
다음 릴리스는 현재 지원되는 SqlPackage 버전입니다.
170.3.93 SqlPackage
릴리스 날짜: 2026년 2월 10일
dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Features
| Feature |
Details |
적용 대상 |
| Deployment |
데이터베이스 옵션 ACCELERATED_DATABASE_RECOVERY 및 OPTIMIZED_LOCKING.에 대한 지원이 추가되었습니다. |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Permissions |
EXECUTE ON EXTERNAL MODEL 권한을 포함하도록 권한 게시를 향상시킵니다. |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Platform |
DacFx 라이브러리 및 SqlPackage CLI에 .NET 10 지원이 추가되었습니다. SqlPackage dotnet tool 는 .NET 8 및 .NET 10 모두에 사용할 수 있습니다. |
플랫폼; SqlPackage CLI; DacFx API/ 스키마 비교 |
| Platform |
DacFx 라이브러리에 .NET Standard 2.0 지원이 추가되었습니다. |
플랫폼; DacFx API/ 스키마 비교 |
| Platform |
Microsoft.Data.SqlClient v6.1.3을 참조합니다. |
Platform |
| ScriptDom |
ScriptDom을 버전 170.157.0으로 업데이트했습니다. |
Platform |
| Vector |
기본 형식을 변경할 수 있도록 벡터 열 지원을 확장합니다. |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
Fixes
| Feature |
Details |
적용 대상 |
| Deployment |
대상 데이터베이스에 보안 정책이 포함된 경우 Microsoft Fabric의 SQL 데이터베이스에 배포하는 버그가 수정되었습니다. |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Export |
내보낸 .dacpac 파일이 소문자 true/false 대신 True/False 값을 사용하는 부울 속성 값 때문에 XSD 스키마 유효성 검사에 실패하는 문제를 해결했습니다.
GitHub 문제 |
SqlPackage CLI |
| Import |
이름에 특수 문자가 있는 테이블 가져오기(예: /또는 "$)가 사용자에게 경고 없이 자동으로 데이터를 가져오지 못하는 문제를 해결했습니다.
GitHub 문제 |
SqlPackage CLI |
| Ledger |
계산 열이 있는 원장 테이블이 모델 유효성 검사 및 빌드 중에 발생하는 NullReferenceException 문제를 해결했습니다.
GitHub 문제 |
MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
| SQL 프로젝트 |
테이블에 인라인 클러스터형 columnstore 인덱스 정의를 사용하여 SQL 프로젝트를 빌드하는 데 실패하고 구문 오류가 발생하는 문제를 해결했습니다.
GitHub 문제 |
MSBuild/SQL 프로젝트 |
| SQL 프로젝트 |
NVARCHAR(MAX) 또는 다른 LOB 유형 열이 있는 테이블의 클러스터형 columnstore 인덱스에서 벡터 열과 함께 columnstore 인덱스가 지원되지 않는다는 오류를 잘못 보고하는 문제를 수정했습니다.
GitHub 문제 |
MSBuild/SQL 프로젝트 |
| Vector |
VECTOR_SEARCH를 사용하는 프로시저에서 열 참조를 해결할 수 없다는 유효성 검사 경고를 보고하는 문제를 해결했습니다.
GitHub 문제 |
MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
170.2.70 SqlPackage
릴리스 날짜: 2025년 10월 14일
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Features
| Feature |
Details |
적용 대상 |
| 외부 모델 |
가져오기, 내보내기, 추출, 배포 및 SQL 프로젝트 빌드를 위한 Azure SQL Database 및 SQL Server 2025(17.x)의 외부 모델에 대한 지원이 추가되었습니다. |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
| 외부 모델 |
함수 AI_GENERATE_CHUNKS 및 AI_GENERATE_EMBEDDINGS에 대한 지원이 추가되었습니다. |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| JSON |
가져오기, 내보내기, 추출, 배포 및 SQL 프로젝트 빌드를 위한 Azure SQL Database 및 SQL Server 2025(17.x)의 JSON 인덱스에 대한 지원이 추가되었습니다. |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
| JSON |
JSON 함수 및 .JSON_ARRAYAGGJSON_OBJECTAGGJSON_QUERY에 대한 지원이 추가되었습니다. |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
| Platform |
SqlPackage .zip 빌드 .NET SDK가 8.0.414로 업데이트됨 |
플랫폼, SqlPackage CLI |
| Regex |
함수에 대한 지원이 추가되었습니다 REGEXP_LIKE . |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
| ScriptDom |
ScriptDom을 버전 170.128.0으로 업데이트했습니다. |
Platform |
| Vector |
가져오기, 내보내기, 추출, 배포 및 SQL 프로젝트 빌드를 위한 Azure SQL Database 및 SQL Server 2025(17.x)의 벡터 인덱스에 대한 지원이 추가되었습니다. |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
| Vector |
벡터 데이터 형식에 대한 지원을 SQL Server 2025(17.x)로 확장하고 32비트 부동 소수 자릿수를 지정합니다. |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
| Vector |
Vector 함수 VECTOR_SEARCH에 대한 지원이 추가되었습니다. |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
Fixes
| Feature |
Details |
적용 대상 |
| 데이터 마스킹 |
프로젝트 빌드 중에 datetime 데이터 마스킹 함수가 인식되지 않는 문제를 해결했습니다.
GitHub 문제 |
MSBuild/SQL 프로젝트 |
| 외부 모델 |
데이터베이스 범위 자격 증명에 대한 외부 모델 종속성으로 인해 프로젝트 빌드가 실패하는 문제가 해결되었습니다. |
MSBuild/SQL 프로젝트 |
| JSON |
JSON 인덱스를 기본 JSON 경로와 비교할 때 발생하는 버그가 수정되었습니다. |
DacFx API/스키마 비교; SqlPackage CLI |
| Platform |
Microsoft.Data.SqlClient v5.1.7을 참조합니다. |
Platform |
| XML |
모델 비교 중에 XML 쿼리 경로(xQuery)가 대/소문자를 구분하지 않는 문제를 해결했습니다. 대/소문자를 구분하지 않는 데이터베이스에서도 xQuery 경로는 대/소문자를 구분합니다.
GitHub 문제 |
DacFx API/스키마 비교; SqlPackage CLI |
170.1.61 SqlPackage
릴리스 날짜: 2025년 7월 30일
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Features
| Feature |
Details |
적용 대상 |
| 데이터 가상화 |
가져오기, 내보내기, 추출 및 게시 작업에서 Azure SQL Database의 데이터 가상화 와 관련된 개체에 대한 지원이 추가되었습니다. |
SqlPackage CLI |
| 데이터 가상화 |
Parquet 파일 미리 보기를 사용하여 게시에 Azure SQL Database를 추가하여 Azure Blob Storage 및 parquet 파일을 사용하여 데이터를 데이터베이스로 가져올 수 있도록 했습니다. 데이터를 Parquet 파일로 추출하는 것은 Azure SQL Database에서는 사용할 수 없습니다. 이는 Azure SQL Database에서 제공되지 않는 기능에 의존하기 때문입니다. |
SqlPackage CLI |
| Deployment |
게시 속성 /p:IgnorePreDeployScript 및 /p:IgnorePostDeployScript.에 대한 지원이 추가되었습니다. 이러한 속성은 기본적으로 false 사용 가능한 경우 해당 스크립트를 생략하는 배포 계획을 생성합니다.
GitHub 문제 |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Permissions |
Microsoft Fabric에서 Azure SQL Database 및 SQL 데이터베이스에 대한 사용 권한 ALTER ANY EXTERNAL MIRROR 에 대한 지원이 추가되었습니다. 이 권한은 하나 이상의 미러 테이블이 포함된 데이터베이스를 내보내는 데 필요합니다.
GitHub 문제 |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Permissions |
사용 권한 CREATE ANY EXTERNAL MODEL 및 ALTER ANY EXTERNAL MODEL SQL Server 2025(17.x)에 대한 지원이 추가되었습니다. |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Permissions |
SQL Server 2025(17.x) 및 Azure SQL Database에 대한 권한 ALTER ANY INFORMATION PROTECTION 에 대한 지원이 추가되었습니다. |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Platform |
SqlPackage .zip 빌드 .NET SDK는 8.0.412로 업데이트됩니다. |
플랫폼; SqlPackage CLI |
| ScriptDom |
ScriptDom을 버전 170.0.64로 업데이트했습니다. |
Platform |
| ScriptDom |
ScriptDom에서 TSqlFabricDWParser를 사용하도록 Fabric 플랫폼의 데이터 웨어하우스를 업데이트합니다. |
플랫폼; DacFx API/ 스키마 비교 |
Fixes
| Feature |
Details |
적용 대상 |
| 항상 암호화됨 |
게시 매개 변수에 Interactive 대한 /AzureKeyVaultAuthMethod 옵션이 제대로 작동하지 않는 문제를 해결했습니다. |
SqlPackage CLI |
| Deployment |
배포에서 DbScopedConfigMaxDOPSecondary이 올바르게 설정되지 않은 문제를 해결했습니다.
GitHub 문제 |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Deployment |
Microsoft Fabric의 데이터 웨어하우스에서 지원되지 않는 구문으로 외래 키 제약 조건이 포함된 테이블을 게시하지 못하는 문제를 해결했습니다. |
SqlPackage CLI |
| Deployment |
Microsoft Fabric에서 SQL 데이터베이스에 배포할 때 서버 개체가 포함된 문제를 해결했습니다. 서버 개체는 Microsoft Fabric의 SQL 데이터베이스에서 지원되지 않습니다.
GitHub 문제 |
SqlPackage CLI |
| Deployment |
클러스터형 columnstore 인덱스가 먼저 클러스터형 인덱스를 생성해 배포 오버헤드와 시간이 증가하는 문제를 해결했습니다.
GitHub 문제 |
SqlPackage CLI |
| Extract |
Microsoft Fabric의 SQL 데이터베이스에서 데이터베이스를 추출하면 사용할 수 없는 사용자 정의 스크립트가 발생하는 문제를 해결했습니다.
GitHub 문제 |
SqlPackage CLI |
170.0.94 SqlPackage
출시일: 2025년 4월 15일
dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Features
| Feature |
Details |
적용 대상 |
| DACPACVerify |
두 .dacpac 파일의 내용을 확인하기 위한 지원이 미리 보기 도구 Microsoft.DacpacVerify에 추가되었습니다. |
DacFx API/ 스키마 비교 |
| Extract |
파일을 폴더에 압축 해제하는 지원이 추가되었습니다 .dacpac. 이 /Action:Extract 명령은 /SourceFile: 및 /TargetFile: 매개 변수와 함께 사용됩니다. 대상 파일은 폴더여야 하며 소스 파일(.dacpac)이 지정되면 유효한 데이터베이스 연결 속성이 없습니다. 이 속성은 소스 데이터베이스가 아닌 .dacpac 파일에서 추출하기 위해 필요합니다.
Dacunpack.exe 실행 파일이 DacFx.msi 설치 관리자에서 제거되었습니다. |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Parquet |
SqlPackage 추출 및 게시 작업으로 Azure Blob Storage에서 Parquet 파일을 사용할 때 데이터 형식 타임스탬프, rowversion, uniqueidentifier, text, ntext, 이미지, json, xml 및 벡터에 대한 지원이 추가되었습니다. |
SqlPackage CLI |
| Parquet |
SqlPackage 추출 및 게시 작업으로 나머지 데이터에 대해 Azure Blob Storage의 Parquet 파일을 사용하는 동안 테이블에 지원되지 않는 데이터 형식이 포함된 경우 테이블 데이터를 BCP 파일로 내보내고 가져오는 지원이 추가되었습니다. ko-KR: 예제 데이터 형식 중 하나는 sql_variant이며, 해당 형식의 열을 포함하는 테이블은 BCP .dacpac에 기록되고, 나머지 테이블은 Azure Blob Storage에 Parquet 파일로 저장됩니다. |
SqlPackage CLI |
| Platform |
.NET Framework용 SqlPackage 버전을 .NET Framework 4.7.2로 업데이트했습니다. |
플랫폼; SqlPackage CLI |
| Platform |
.NET 6에 대한 지원이 제거되었습니다. |
플랫폼; SqlPackage CLI |
| ScriptDom |
ScriptDom을 버전 170.18.0으로 업데이트했습니다. |
Platform |
| SQL 프로젝트 |
Microsoft Fabric의 Azure SQL Database 및 SQL 데이터베이스에 대한 기본 호환성 수준은 이제 170으로 설정됩니다. 자세한 내용은 Azure SQL Database의 데이터베이스 호환성 수준 170 및 Microsoft Fabric의 SQL 데이터베이스를 참조하세요. |
MSBuild/SQL 프로젝트 |
| Vector |
이제 벡터 데이터 형식이 가져오기, 내보내기, 추출, 배포 및 SQL 프로젝트 빌드를 위한 대상 플랫폼에서 Azure SQL Database 지원됩니다. |
SqlPackage CLI; MSBuild/SQL 프로젝트; DacFx API/ 스키마 비교 |
Fixes
| Feature |
Details |
적용 대상 |
| Deployment |
수정된 테이블에 값이 없거나 REJECT_VALUEREJECT_SAMPLE_VALUE없는 경우 외부 테이블에 변경 내용이 배포되면 모든 외부 테이블이 삭제되고 다시 만들어지는 문제가 해결되었습니다. |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Deployment |
열의 데이터 정렬이 지정되고 데이터베이스 기본 데이터 정렬과 일치하는 경우 열을 변경하여 길이를 확장하면 잘못된 데이터 손실 경고가 발생하는 문제를 해결했습니다.
GitHub 문제 |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Deployment |
테이블의 민감도 분류 변경으로 인덱스가 다시 만들어지는 문제가 해결되었습니다.
GitHub 문제 |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| Export |
내보내기 작업 중에 테이블 크기 예측 사용을 최적화했습니다. |
SqlPackage CLI |
| Extract |
.dacpac을(를) 데이터베이스 참조와 함께 추출하는 과정에서 발생하는 문제를 해결했습니다.
GitHub 문제 |
SqlPackage CLI; DacFx API/ 스키마 비교 |
| 패브릭 데이터 웨어하우스 |
게시 작업 중 시스템 저장 프로시저 sp_refreshsqlmodule가 호출되는 문제를 수정했습니다. 패브릭 데이터 웨어하우스는 지원하지 sp_refreshsqlmodule 않으며 이로 인해 배포가 실패합니다. |
SqlPackage CLI |
| 패브릭 데이터 웨어하우스 |
패브릭 데이터 웨어하우스에서 데이터베이스를 추출할 때 테이블 제약 조건이 .dacpac 파일에는 포함되지만 .sql 파일에는 포함되지 않는 문제를 해결했습니다.
GitHub 문제 |
SqlPackage CLI |
| SQL 프로젝트 |
Visual Studio에 SSDT가 설치되지 않은 빌드로 인해 잘못된 빌드 동작이 발생하는 문제를 해결했습니다.
GitHub 문제 |
MSBuild/SQL 프로젝트 |
| SQL 프로젝트 |
코드 분석을 사용할 때 출력에서 빌드 경고가 중복되는 문제를 해결했습니다.
GitHub 문제 |
MSBuild/SQL 프로젝트 |
| SQL 프로젝트 |
서비스 브로커 매개 변수를 변수로 설정하면 거짓 경고가 발생하는 문제를 해결했습니다.
GitHub 문제 |
MSBuild/SQL 프로젝트 |
보관된 릴리스(162.x 및 이전 버전)
SqlPackage의 릴리스 정보(보관)에서 버전 162.x 및 이전 버전에 대한 릴리스 정보를 찾을 수 있습니다.