Aracılığıyla paylaş

SqlPackage'ı indirme ve yükleme

SqlPackage Windows, macOS ve Linux üzerinde çalışır ve dotnet tool aracılığıyla veya tek başına zip indirmesi olarak yüklenebilir. En son sürümle ilgili ayrıntılar için sürüm notlarına bakın.

  • Sürüm numarası: 170.2.70
  • Derleme numarası: 170.2.70.1
  • Sürüm tarihi: 14 Ekim 2025

SqlPackage hem .NET 8 hem de .NET Framework için geliştirilmiş ve yayımlanmıştır. .NET 8 SqlPackage sürümünün yüklenmesi, platformlar arası ve kolayca güncellenebilen dotnet tool veya taşınabilir kendi başına paketlenmiş .zip indirme yöntemiyle önerilir. .NET 8 SqlPackage sürümleri, modern uygulamalar için odaklanılan ve Windows için .NET Framework'ün bakım desteğiyle karşıt olankapsamında .NET'in performansına ve ölçeklenebilirliğine yönelik sürekli ilerlemelerden yararlanıyor. .NET Framework sürümü yalnızca .msi Windows installerolarak kullanılabilir.

Note

Daha önce SqlPackage'ın ayrı bir sürüm numarası (19) ve derleme numarası (160.x) vardı. 161 sürümünden başlayarak, SqlPackage sürüm numarası ilişkili olduğu DacFx sürüm numarasıyla eşleşir (örneğin, 162.0.52).

Yükleme, platformlar arası

SqlPackage'ı dotnet aracı olarak yüklemek makinenize .NET SDK yüklenmesini gerektirir. SqlPackage'ı genel bir araç olarak yüklemek, sqlpackage olarak yolunuz üzerinde kullanılabilir olmasını sağlar ve Windows, macOS ve Linux için SqlPackage'ı yüklemek için önerilen yöntemdir. SqlPackage, .NET 8 ve sonraki sürümler için bir dotnet aracı olarak kullanılabilir.

SqlPackage'ı genel bir .NET aracı olarak yüklemek için aşağıdaki komutu çalıştırın:

dotnet tool install -g microsoft.sqlpackage

dotnet tool install komutuyla sağlanan seçenekler hakkında daha fazla bilgi dotnet aracı yükleme belgelerinde bulunabilir.

SqlPackage'ı en son sürüme güncelleştirmek için aşağıdaki komutu çalıştırın:

dotnet tool update -g microsoft.sqlpackage

SqlPackage'ı kaldırmak için aşağıdaki komutu çalıştırın:

dotnet tool uninstall -g microsoft.sqlpackage

.NET 9 veya üzeri ile SqlPackage yükleme

SqlPackage'ı .NET SDK'nın daha yeni bir sürümüyle yüklemek için yükleme komutuna ekleyin --allow-roll-forward :

dotnet tool install -g microsoft.sqlpackage --allow-roll-forward

Bu seçenek, .NET 8 yüklü değilse SqlPackage'ın .NET çalışma zamanının daha yeni bir sürümünü kullanmasına olanak tanır.

Yükleme sorunlarını giderme

Yükleme sırasında sorunlarla karşılaşırsanız şu adımları izleyin:

  1. .NET SDK'sınınyüklendiğinden emin olun: Aşağıdaki komutu çalıştırarak .NET SDK'sının makinenizde yüklü olduğunu doğrulayın:

    dotnet --list-sdks

    .NET SDK listelenmiyorsa .NET SDK indirme sayfasından indirin ve yükleyin.

  2. NuGet kaynak yapılandırmasını doğrulayın: SqlPackage, genel bir NuGet akışında nuget.orgyayımlanır. Bulunamadığını microsoft.sqlpackage belirten bir hatayla karşılaşabilirsiniz:

    microsoft.sqlpackage is not found in NuGet feeds C:\Program Files(x86)\Microsoft SDKs\NuGetPackages\

    nuget.org Dotnet için yapılandırılmış bir NuGet kaynağı olduğundan emin olun. Aşağıdakini çalıştırarak yapılandırılan NuGet kaynaklarını listeleyin:

    dotnet nuget list source

    Bu komut, NuGet kaynaklarının listesini görüntülemelidir. Çıkışta genellikle nuget.org olarak listelenen https://api.nuget.org/v3/index.json öğesini arayın. nuget.org listelenmiyorsa, aşağıdaki komutu kullanarak nuget kaynağı olarak ekleyin:

    dotnet nuget add source https://api.nuget.org/v3/index.json

  3. Yüklemeyi yeniden deneyin: .NET SDK yüklemesini ve NuGet kaynak yapılandırmasını doğruladıktan sonra, uygun komutu kullanarak SqlPackage'ı yüklemeyi yeniden deneyin:

    dotnet tool install -g microsoft.sqlpackage

Önizleme sürümleri

SqlPackage'ın önizleme sürümleri dotnet araç akışı ile kullanılabilir. Önizleme sürümlerine erişmek için --prerelease komutuyla dotnet tool seçeneğini kullanın. Örneğin, en son önizleme sürümünü yüklemek için aşağıdaki komutu çalıştırın:

dotnet tool install -g --prerelease microsoft.sqlpackage

SqlPackage'ı en son önizleme sürümüne güncelleştirmek için aşağıdaki komutu çalıştırın:

dotnet tool update -g --prerelease microsoft.sqlpackage

Önizleme sürümlerinin listesi SqlPackage içindotnet araç akışında bulunur.

Yükleme, dosya indirme (alternatif)

SqlPackage ayrıca Windows, macOS ve Linux için bağımsız bir indirme olarak da hazırlanır. .NET yüklemesi gerekmez, ancak işletim sistemi gereksinimleridotnet aracı yüklemeile aynıdır. Bu .zip indirmeye dahil edilen bağımlılıklar, SqlPackage içindotnet araç seçeneğinde daha sık güncelleştirilir. SqlPackage'ın en son sürümü için aşağıdaki bağlantılar bulunur:

Platform Download
Windows .NET 8 .zip dosyası
Windows .msi dosyası
macOS .NET 8 .zip dosyası
Linux .NET 8 .zip dosyası

Linux

  1. Linux için SqlPackage indirin

  2. Dosyayı ayıklayın ve SqlPackage'ı başlatın. Yeni bir Terminal penceresi açın ve aşağıdaki komutları yazın:

    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

    Note

    Eksik bağımlılıklarınız olabilir. Linux sürümünüze bağlı olarak bu bağımlılıkları yüklemek için aşağıdaki komutları kullanın:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. macOS için SqlPackage indirin

  2. Dosyayı ayıklayın ve SqlPackage'ı başlatın. Yeni bir Terminal penceresi açın ve aşağıdaki komutları yazın:

    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

    Note

    Güvenlik ayarları, macOS üzerinde SqlPackage'ı çalıştırmak için değişiklik gerektirebilir. Ağ Geçidi Denetleyicisi ile komut satırından etkileşime geçmek için aşağıdaki komutları kullanın.

    SqlPackage'i yürütmeden önce:

    sudo spctl --master-disable

    SqlPackage'i yürüttükten sonra:

    sudo spctl --master-enable

Windows (.NET 8)

  1. Windows için SqlPackage indirin

  2. Windows Gezgini'nde dosyaya sağ tıklayıp 'Tümünü Ayıkla...' seçeneğini belirleyerek dosyayı ayıklayın ve hedef dizini seçin

  3. Yeni bir Terminal penceresi açın ve SqlPackage'ın ayıklandığı konuma cd yazın:

    > sqlpackage

Windows (.NET Framework)

SqlPackage'ın bu sürümü standart bir Windows installer deneyimi ve .zipiçerir:

  1. Windows içinDacFramework.msi yükleyicisini indirme ve çalıştırma
  2. Yeni bir Komut İstemi penceresi açın ve SqlPackage'ı çalıştırın
    • SqlPackage C:\Program Files\Microsoft SQL Server\170\DAC\bin klasörüne yüklenir

SqlPackage'ı kaldırma

SqlPackage'ı Windows yükleyicisini kullanarak yüklediyseniz, herhangi bir Windows uygulamasını kaldırdığınız gibi kaldırın.

SqlPackage'ı bir .zip veya başka bir arşivle yüklediyseniz, dosyaları silin.

Otomatik ortamlar

Evergreen bağlantıları en son Sqlpackage sürümlerini indirmek için kullanılabilir:

DacFx

SqlPackage, bazı genel DacFx API'lerini sunarak DacFx çerçevesi için bir komut satırı arayüzüdür. DacServices (Microsoft.SqlServer.Dac), veritabanı dağıtımını uygulama işlem hattınızla tümleştirmeye yönelik ilgili bir mekanizmadır. DacServices API'sini Microsoft.SqlServer.DacFx NuGet aracılığıyla bir pakette bulabilirsiniz.

NuGet paketini bir .NET projesine ekleme işlemi şu komutla .NET CLI aracılığıyla gerçekleştirilir:

dotnet add package Microsoft.SqlServer.DacFx

Note

Diğer NuGet paketleri DacFx adı Microsoft.SqlServer.DacFx.x64 ve Microsoft.SqlServer.DacFx.x86altında yayımlanmıştır. Her iki platform için destek, Microsoft.SqlServer.DacFx paketi kapsamındadır. Yeni başvurular yalnızca bu pakete yapılmalıdır, x64 veya x86 varyantlarına değil.

Desteklenen İşletim Sistemleri

SqlPackage Windows, macOS ve Linux üzerinde çalışır ve .NET 8 kullanılarak oluşturulur. .NET 8 işletim sistemi gereksinimleri, bağımlılıkları nedeniyle ek gereksinimleri olan SqlPackage için en düşük gereksinimlerdir.

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+

Kullanılabilir Diller

SqlPackage'ın bu sürümü aşağıdaki dillerde yüklenebilir:

SqlPackage .NET 8 Windows:
Çince (Basitleştirilmiş) | Çince (Geleneksel) | İngilizce (ABD) | Fransızca | Almanca | İtalyanca | Japonca | Korece | Portekizce (Brezilya) | Rusça | İspanyolca

SqlPackage .NET Framework Windows:
Çince (Basitleştirilmiş) | Çince (Geleneksel) | İngilizce (ABD) | Fransızca | Almanca | İtalyanca | Japonca | Korece | Portekizce (Brezilya) | Rusça | İspanyolca

SqlPackage .NET 8 macOS:
Çince (Basitleştirilmiş) | Çince (Geleneksel) | İngilizce (ABD) | Fransızca | Almanca | İtalyanca | Japonca | Korece | Portekizce (Brezilya) | Rusça | İspanyolca

SqlPackage .NET 8 Linux:
Çince (Basitleştirilmiş) | Çince (Geleneksel) | İngilizce (ABD) | Fransızca | Almanca | İtalyanca | Japonca | Korece | Portekizce (Brezilya) | Rusça | İspanyolca

İlgili içerik

  • Last updated on