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.3.93
  • Derleme numarası: 170.3.93.6
  • Sürüm tarihi: 10 Şubat 2026

SqlPackage hem .NET hem de .NET Framework için geliştirilmiş ve yayımlanmıştır. .NET 10 SqlPackage sürümünün yüklenmesi, platformlar arası ve kolayca güncelleştirilebilen kullanışlı dotnet tool yöntem veya taşınabilir kendi kendine .zip indirme yoluyla önerilir. .NET 10 SqlPackage sürümleri, windows için .NET Framework'ün bakım desteğinin aksine modern uygulamalara odaklanmanın bir parçası olarak .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'in gelecek sürümleriyle 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 veya .NET 10 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 10 .zip dosyası
Windows .msi dosyası
macOS .NET 10 .zip dosyası
Linux .NET 10 .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 10)

  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

Yükleme ve güncelleştirme kolaylığı nedeniyle SQLPackage'ın dotnet araç sürümünün yüklenmesi CI/CD işlem hatları gibi otomatik ortamlar için önerilir. Ancak, dosya indirme seçeneği otomatik ortamlarda da kullanılabilir.

dotnet tool install -g microsoft.sqlpackage

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

Desteklenen İşletim Sistemleri

SqlPackage Windows, macOS ve Linux üzerinde çalışır ve .NET 10 kullanılarak oluşturulur. .NET 10 işletim sistemi gereksinimleri, bağımlılıkları nedeniyle ek gereksinimlere sahip 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 14 "Sonoma"+

Linux (x64)

  • Debian 12+
  • Red Hat Enterprise Linux 8+
  • SUSE Linux Enterprise Server 15 SP6+
  • Ubuntu 22.04+

Kullanılabilir Diller

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

SqlPackage .NET 10 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 10 macOS:
Çince (Basitleştirilmiş) | Çince (Geleneksel) | İngilizce (ABD) | Fransızca | Almanca | İtalyanca | Japonca | Korece | Portekizce (Brezilya) | Rusça | İspanyolca

SqlPackage .NET 10 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