Mengunduh dan menginstal SqlPackage

SqlPackage berjalan di Windows, macOS, dan Linux, dan tersedia untuk diinstal melalui dotnet tool atau sebagai unduhan zip mandiri. Untuk detail tentang rilis terbaru, lihat catatan rilis.

• Nomor versi: 162.5.57
• Nomor build: 162.5.57.1
• Tanggal rilis: 21 November 2024

SqlPackage dikembangkan dan dirilis untuk .NET 8 dan .NET Framework. Menginstal versi .NET 8 SqlPackage direkomendasikan melalui metode yang nyamandotnet tool, yang merupakan lintas platform dan mudah diperbarui, atau melalui unduhan .zip portabel mandiri. Rilis .NET 8 SqlPackage mendapat manfaat dari kemajuan berkelanjutan dalam performa dan skalabilitas .NET sebagai bagian dari fokus pada aplikasi modern, yang berlawanan dengan dukungan pemeliharaan .NET Framework untuk Windows. Versi .NET Framework hanya tersedia sebagai installer .msi Windows.

Penginstalan, lintas platform

Menginstal SqlPackage sebagai alat dotnet mengharuskan .NET SDK sudah terpasang di komputer Anda. Menginstal SqlPackage sebagai alat global membuatnya tersedia di path Anda sebagai sqlpackage dan merupakan metode yang direkomendasikan untuk menginstal SqlPackage di Windows, macOS, dan Linux. SqlPackage tersedia sebagai alat dotnet untuk .NET 8 dan versi yang lebih baru.

Untuk menginstal SqlPackage sebagai alat .NET global, jalankan perintah berikut:

dotnet tool install -g microsoft.sqlpackage

Informasi lebih lanjut tentang opsi yang tersedia dengan perintah dotnet tool install dapat ditemukan di dalam dokumentasi penginstalan alat dotnet.

Untuk memperbarui SqlPackage ke versi terbaru, jalankan perintah berikut:

dotnet tool update -g microsoft.sqlpackage

Untuk menghapus instalan SqlPackage, jalankan perintah berikut:

dotnet tool uninstall -g microsoft.sqlpackage

Memecahkan masalah penginstalan

Jika Anda mengalami masalah selama penginstalan, ikuti langkah-langkah berikut:

1. Pastikan .NET SDK diinstal: Verifikasi bahwa .NET SDK diinstal pada komputer Anda dengan menjalankan perintah berikut:

   dotnet --list-sdks
   

   Jika .NET SDK tidak tercantum, unduh dan instal dari halaman unduhan .NET SDK .

2. Verifikasi konfigurasi sumber NuGet: Pastikan bahwa nuget.org adalah sumber NuGet yang dikonfigurasi untuk dotnet. Cantumkan sumber NuGet yang dikonfigurasi dengan menjalankan:

   dotnet nuget list source
   

   Jika nuget.org tidak tercantum, tambahkan sebagai sumber NuGet menggunakan perintah berikut:

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

3. Coba lagi penginstalan: Setelah memverifikasi penginstalan .NET SDK dan konfigurasi sumber NuGet, coba lagi menginstal SqlPackage menggunakan perintah yang sesuai:

   dotnet tool install -g microsoft.sqlpackage
   

Rilis pratinjau

Rilis pratinjau SqlPackage tersedia melalui umpan alat dotnet. Untuk mengakses rilis pratinjau, gunakan pilihan --prerelease dengan perintah dotnet tool. Misalnya, untuk menginstal rilis pratinjau terbaru, jalankan perintah berikut:

dotnet tool install -g --prerelease microsoft.sqlpackage

Untuk memperbarui SqlPackage ke versi pratinjau terbaru, jalankan perintah berikut:

dotnet tool update -g --prerelease microsoft.sqlpackage

Daftar rilis pratinjau tersedia di umpan alat dotnet untuk SqlPackage.

Penginstalan, pengunduhan file (alternatif)

SqlPackage juga disiapkan sebagai unduhan mandiri untuk Windows, macOS, dan Linux. Namun, tidak diperlukan penginstalan .NET, persyaratan sistem operasi sama dengan penginstalan alat dotnet . Dependensi yang disertakan dalam unduhan .zip ini lebih sering diperbarui dalam opsi alat Dotnet untuk SqlPackage. Tautan berikut adalah untuk versi terbaru SqlPackage:

Linux

1. Unduh SqlPackage untuk Linux

2. Ekstrak file dan luncurkan SqlPackage, buka jendela Terminal baru dan ketik perintah berikut:

   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
   

   Catatan

   Anda mungkin kehilangan dependensi. Gunakan perintah berikut untuk menginstal dependensi ini tergantung pada versi Linux Anda:

   Debian:

   sudo apt-get install libunwind8
   

   Red Hat:

   yum install libunwind
   yum install libicu
   

   Ubuntu:

   sudo apt-get install libunwind8
   

macOS

1. Unduh SqlPackage untuk macOS

2. Ekstrak file dan luncurkan SqlPackage, buka jendela Terminal baru dan ketik perintah berikut:

   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
   

   Catatan

   Pengaturan keamanan mungkin memerlukan modifikasi untuk menjalankan SqlPackage di macOS. Gunakan perintah berikut untuk berinteraksi dengan Gatekeeper dari baris perintah.

   Sebelum menjalankan SqlPackage:

   sudo spctl --master-disable
   

   Setelah menjalankan SqlPackage:

   sudo spctl --master-enable
   

Windows (.NET 8)

1. Unduh SqlPackage untuk Windows

2. Ekstrak file dengan mengklik kanan pada file di Windows Explorer, dan memilih 'Ekstrak Semua...', dan pilih direktori target

3. Buka jendela Terminal dan cd baru ke lokasi tempat SqlPackage diekstrak:

   > sqlpackage
   

Windows (.NET Framework)

Rilis SqlPackage ini mencakup pengalaman penginstal Windows standar, dan .zip:

1. Mengunduh dan menjalankan alat penginstal DacFramework.msi untuk Windows
2. Buka jendela perintah baru, jalankan SqlPackage
   • SqlPackage diinstal ke C:\Program Files\Microsoft SQL Server\160\DAC\bin folder

Copot SqlPackage

Jika Anda menginstal SqlPackage menggunakan alat penginstal Windows, hapus instalan dengan cara yang sama seperti Anda menghapus aplikasi Windows apa pun.

Jika Anda menginstal SqlPackage dengan .zip atau arsip lainnya, hapus file.

Lingkungan otomatis

Tautan evergreen tersedia untuk mengunduh versi Sqlpackage terbaru:

• 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 adalah antarmuka baris perintah untuk kerangka kerja DacFx, yang mengekspos beberapa API DacFx publik. DacServices (Microsoft.SqlServer.Dac) adalah mekanisme terkait untuk mengintegrasikan penyebaran database ke dalam alur aplikasi Anda. DACServices API tersedia dalam paket melalui NuGet, Microsoft.SqlServer.DacFx.

Menambahkan paket NuGet ke proyek .NET dicapai melalui .NET CLI dengan perintah ini:

dotnet add package Microsoft.SqlServer.DacFx

Sistem Operasi yang Didukung

SqlPackage berjalan di Windows, macOS, dan Linux dan dibangun menggunakan .NET 8. Persyaratan OS .NET 8 adalah persyaratan minimum untuk SqlPackage, yang memiliki persyaratan tambahan karena dependensinya.

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+

Bahasa yang Tersedia

Rilis SqlPackage ini dapat diinstal dalam bahasa berikut:

SqlPackage .NET 8 Windows:
Mandarin (Sederhana) | Mandarin (Tradisional) | Inggris (Amerika Serikat) | Prancis | Jerman | Italia | Jepang | Korea | Portugis (Brasil) | Rusia | Spanyol

SqlPackage .NET Framework Windows:
Tionghoa (Sederhana) | Tionghoa (Tradisional) | Inggris (Amerika Serikat) | Prancis | Jerman | Italia | Jepang | Korea | Portugis (Brasil) | Rusia | Spanyol

SqlPackage .NET 8 macOS:
Mandarin (Sederhana) | Mandarin (Tradisional) | Inggris (Amerika Serikat) | Prancis | Jerman | Italia | Jepang | Korea | Portugis (Brasil) | Rusia | Spanyol

SqlPackage .NET 8 Linux:
Tionghoa (Sederhana) | Tionghoa (Tradisional) | Inggris (Amerika Serikat) | Prancis | Jerman | Italia | Jepang | Korea | Portugis (Brasil) | Rusia | Spanyol

Konten terkait

• SqlPackage
• SqlPackage dalam alur CI/CD
• memecahkan masalah dengan SqlPackage
• proyek SQL
• Repositori GitHub DacFx
• Pernyataan Privasi Microsoft