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ı: 162.5.57
• Derleme numarası: 162.5.57.1
• Sürüm tarihi: 21 Kasım 2024

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üncelleştirilebilen kullanışlı dotnet tool yöntemi veya taşınabilir kendi kendine .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.

Yükleme, platformlar arası uyumluluk

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

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ğrulama: 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
   

   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 dotnet tool komutuyla --prerelease 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:

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
   

   Not

   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
   

   Not

   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\160\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:

• 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, 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 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

• SqlPackage
• CI/CD işlem hatlarında SqlPackage
• SqlPackage ile ilgili sorunları giderme
• SQL projeleri
• DacFx GitHub deposu
• Microsoft Gizlilik Bildirimi