SqlPackage 다운로드 및 설치

SqlPackage는 Windows, macOS 및 Linux에서 실행되며 dotnet tool를 통해 설치하거나 독립 실행형 zip 다운로드로 설치할 수 있습니다. 최신 릴리스에 대한 자세한 내용은 릴리스 정보를 참조하세요.

• 버전 번호: 162.5.57
• 빌드 번호: 162.5.57.1
• 릴리스 날짜: 2024년 11월 21일

SqlPackage는 .NET 8 및 .NET Framework 모두에 대해 개발 및 릴리스됩니다. 플랫폼 간 및 업데이트하기 쉬운 편리한 dotnet tool 메서드 또는 휴대용 자체 포함 .zip 다운로드를 통해 .NET 8 SqlPackage 버전을 설치하는 것이 권장됩니다. .NET 8 SqlPackage 릴리스는 최신 애플리케이션에 대한 중점의 일환으로 .NET의 성능과 확장성을 지속적으로 향상함으로써 Windows용 .NET Framework의 유지 관리 지원과는 대조적인 이점을 제공합니다. .NET Framework 버전은 .msi Windows Installer로만 사용할 수 있습니다.

참고 사항

이전에는 SqlPackage에 고유한 버전 번호(19)와 빌드 번호(160.x)가 있었습니다. 버전 161부터 SqlPackage의 버전 번호는 연결된 DacFx 버전 번호(예: 162.0.52)와 일치합니다.

설치, 플랫폼 간

SqlPackage를 dotnet 도구로 설치하려면 컴퓨터에 .NET SDK를 설치해야 합니다. SqlPackage를 전역 도구로 설치하면 경로에서 sqlpackage로 사용할 수 있으며 Windows, macOS 및 Linux용 SqlPackage를 설치하는 것이 좋습니다. SqlPackage는 .NET 6 및 .NET 8용 dotnet 도구로 사용할 수 있습니다.

SqlPackage를 전역 .NET 도구로 설치하려면 다음 명령을 실행합니다.

dotnet tool install -g microsoft.sqlpackage

dotnet tool install 명령과 함께 사용할 수 있는 옵션에 대한 자세한 내용은 dotnet 도구 설치 설명서에서 찾을 수 있습니다.

SqlPackage를 최신 버전으로 업데이트하려면 다음 명령을 실행합니다.

dotnet tool update -g microsoft.sqlpackage

SqlPackage를 제거하려면 다음 명령을 실행합니다.

dotnet tool uninstall -g microsoft.sqlpackage

미리 보기 릴리스

SqlPackage의 프리뷰 릴리스는 dotnet 도구 피드에서 사용할 수 있습니다. 프리뷰 릴리스에 액세스하려면 dotnet tool 명령과 --prerelease 옵션을 사용합니다. 예를 들어 최신 프리뷰 릴리스를 설치하려면 다음 명령을 실행합니다.

dotnet tool install -g --prerelease microsoft.sqlpackage

SqlPackage를 최신 프리뷰 버전으로 업데이트하려면 다음 명령을 실행합니다.

dotnet tool update -g --prerelease microsoft.sqlpackage

미리 보기 릴리스 목록은 SqlPackage용 dotnet 도구 피드에서 사용할 수 있습니다.

설치, 파일 다운로드(얼터너티브)

SqlPackage는 Windows, macOS 및 Linux용 자체 포함 다운로드로도 준비됩니다. .NET 설치는 필요하지 않습니다. 그러나 이 .zip 다운로드에 포함된 종속성은 SqlPackage의 dotnet 도구 옵션에서 더 자주 업데이트됩니다. 다음 링크는 최신 버전의 SqlPackage에 대한 것입니다.

플랫폼	다운로드
Windows .NET 8	zip 파일
Windows	.msi 파일
macOS .NET 8	zip 파일
Linux .NET 8	zip 파일

Linux

1. Linux용 SqlPackage를 다운로드합니다

2. 파일을 추출하고 SqlPackage를 실행하고, 새 터미널 창을 열고 다음 명령을 입력합니다.

   cd ~
   mkdir sqlpackage
   unzip ~/Downloads/sqlpackage-linux-<version string>.zip -d ~/sqlpackage 
   echo "export PATH=\"\$PATH:$HOME/sqlpackage\"" >> ~/.bashrc
   chmod a+x ~/sqlpackage/sqlpackage
   source ~/.bashrc
   sqlpackage
   

   참고 항목

   누락된 종속성이 있을 수 있습니다. 다음 명령을 사용하여 Linux 버전에 따라 이러한 종속성을 설치합니다.

   Debian:

   sudo apt-get install libunwind8
   

   Red Hat:

   yum install libunwind
   yum install libicu
   

   Ubuntu:

   sudo apt-get install libunwind8
   

macOS

1. macOS용 SqlPackage를 다운로드합니다

2. 파일을 추출하고 SqlPackage를 실행하고, 새 터미널 창을 열고 다음 명령을 입력합니다.

   mkdir sqlpackage
   unzip ~/Downloads/sqlpackage-osx-<version string>.zip -d ~/sqlpackage
   chmod +x ~/sqlpackage/sqlpackage
   echo 'export PATH="$PATH:~/sqlpackage"' >> ~/.bash_profile
   source ~/.bash_profile
   sqlpackage
   

   참고 항목

   macOS에서 SqlPackage를 실행하려면 보안 설정을 수정해야 할 수 있습니다. 다음 명령을 사용하여 명령줄에서 Gatekeeper와 상호 작용합니다.

   SqlPackage를 실행하기 전:

   sudo spctl --master-disable
   

   SqlPackage를 실행한 후:

   sudo spctl --master-enable
   

Windows(.NET 8)

1. Windows용 SqlPackage를 다운로드합니다

2. Windows 탐색기에서 파일을 마우스 오른쪽 단추로 클릭하고 파일을 추출하고, '전부 추출하기...'를 선택하여 대상 디렉터리를 선택합니다.

3. 새 터미널 창과 SqlPackage가 압축 해제된 위치에 대한 cd를 엽니다.

   > sqlpackage
   

Windows(.NET Framework)

SqlPackage의 릴리스는 표준 Windows 설치 관리자 환경 및 .zip을 포함하고 있습니다.

1. Windows DacFramework.msi 설치 관리자를 다운로드하고 실행합니다
2. 새 명령 프롬프트 창을 열고, SQLPackage를 실행합니다
   • SqlPackage가 C:\Program Files\Microsoft SQL Server\160\DAC\bin 폴더에 설치되었습니다.

SqlPackage 제거

Windows Installer를 사용하여 SqlPackage를 설치한 경우, 모든 Windows 애플리케이션을 동일한 방식으로 제거합니다.

.zip 또는 다른 아카이브로 SqlPackage를 설치한 경우 파일을 삭제하세요.

자동화된 환경

에버그린 링크는 최신 Sqlpackage 버전을 다운로드하는 데 사용할 수 있습니다.

• Linux(https://aka.ms/sqlpackage-linux)
• macOS(https://aka.ms/sqlpackage-macos)
• Windows(https://aka.ms/sqlpackage-windows)
• Windows, .NET Framework(https://aka.ms/dacfx-msi)

DacFx

SqlPackage는 DacFx 프레임워크의 명령줄 인터페이스로, 몇 가지 퍼블릭 DacFx API를 공개합니다. DacServices(Microsoft.SqlServer.Dac)는 데이터베이스 배포를 애플리케이션 파이프라인에 통합하기 위한 관련 메커니즘입니다. DacServices API는 NuGet, Microsoft.SqlServer.DacFx를 통해 패키지로 제공됩니다.

.NET 프로젝트에 NuGet 패키지를 추가하는 작업은 다음 명령을 사용하여 .NET CLI를 통해 수행됩니다.

dotnet add package Microsoft.SqlServer.DacFx

참고

추가 NuGet 패키지는 DacFx 이름인 “Microsoft.SqlServer.DacFx.x64” 및 “Microsoft.SqlServer.DacFx.x86”으로 게시되었습니다. ‘Microsoft.SqlServer.DACFx’ 패키지에 두 플랫폼 모두에 대한 지원이 포함되어 있습니다. x64 또는 x86 변형이 아니라 이 패키지에 대한 새 참조를 만들어야 합니다.

지원되는 운영 체제

SqlPackage는 Windows, macOS 및 Linux에서 실행되며 .NET 8을 사용하여 빌드됩니다. .NET 8 OS 요구 사항은 종속성으로 인해 추가 요구 사항이 있는 SqlPackage에 대한 최소 요구 사항입니다.

Windows(x64)

• Windows 11
• Windows 10(1607+)
• Windows Server Core 2012 R2+
• Windows Server 2012 R2+

macOS

• macOS 12 “Monterey”+

Linux(x64)

• Debian 11 이상
• Red Hat Enterprise Linux 8 이상
• SUSE Linux Enterprise Server v12 SP2+
• Ubuntu 20.04+

사용 가능한 언어

이 SqlPackage 릴리스는 다음 언어로 설치할 수 있습니다.

SqlPackage .NET 8 Windows:
중국어(간체) | 중국어(번체) | 영어(미국) | 프랑스어 | 독일어 | 이탈리아어 | 일본어 | 한국어 | 포르투갈어(브라질) | 러시아어 | 스페인어

SqlPackage .NET Framework Windows:
중국어(간체) | 중국어(번체) | 영어(미국) | 프랑스어 | 독일어 | 이탈리아어 | 일본어 | 한국어 | 포르투갈어(브라질) | 러시아어 | 스페인어

SqlPackage .NET 8 macOS:
중국어(간체) | 중국어(번체) | 영어(미국) | 프랑스어 | 독일어 | 이탈리아어 | 일본어 | 한국어 | 포르투갈어(브라질) | 러시아어 | 스페인어

SqlPackage .NET 8 Linux:
중국어(간체) | 중국어(번체) | 영어(미국) | 프랑스어 | 독일어 | 이탈리아어 | 일본어 | 한국어 | 포르투갈어(브라질) | 러시아어 | 스페인어

다음 단계

• SqlPackage에 대해 자세히 알아봅니다.
• CI/CD 파이프라인의 SqlPackage에 대해 자세히 알아보기
• SqlPackage 문제 해결에 대해 자세히 알아보기
• SQL 프로젝트에 대한 자세한 정보
• DacFx GitHub 리포지토리에서 SqlPackage에 대한 피드백 공유

Microsoft 개인정보처리방침