Mengunduh dan menginstal SqlPackage

  • Artikel

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.2.111
  • Nomor build: 162.2.111.2
  • Tanggal rilis: 27 Februari 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 ke performa dan skalabilitas .NET sebagai bagian dari fokus pada aplikasi modern, yang berbeda dengan dukungan pemeliharaan .NET Framework untuk Windows. Versi .NET Framework hanya tersedia sebagai penginstal Windows .msi.

Catatan

Sebelumnya, SqlPackage memiliki nomor versi yang berbeda (19) dan nomor build (160.x). Dimulai dengan versi 161, nomor versi SqlPackage cocok dengan nomor versi DacFx yang terkait dengannya (misalnya 162.0.52).

Penginstalan, lintas platform

Menginstal SqlPackage sebagai alat dotnet mengharuskan .NET SDK diinstal pada komputer Anda. Menginstal SqlPackage sebagai alat global membuatnya tersedia di jalur Anda karena sqlpackage dan merupakan metode yang direkomendasikan untuk menginstal SqlPackage untuk Windows, macOS, dan Linux. SqlPackage tersedia sebagai alat dotnet untuk .NET 6 dan .NET 8.

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

dotnet tool install -g microsoft.sqlpackage

Informasi selengkapnya tentang opsi yang tersedia dengan dotnet tool install perintah dapat ditemukan 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

Rilis pratinjau

Rilis pratinjau SqlPackage tersedia dengan umpan alat dotnet. Untuk mengakses rilis pratinjau, gunakan --prerelease opsi dengan dotnet tool perintah . 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 ada penginstalan .NET yang diperlukan, dependensi yang disertakan dalam unduhan .zip ini diperbarui lebih sering dalam opsi alat dotnet untuk SqlPackage. Tautan berikut adalah untuk versi terbaru SqlPackage:

Platform Unduh
Windows .NET 8 file .zip
Windows file .msi
macOS .NET 8 file .zip
Linux .NET 8 file .zip

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 Prompt Perintah baru, dan jalankan SqlPackage
    • SqlPackage diinstal ke C:\Program Files\Microsoft SQL Server\160\DAC\bin folder

Hapus instalan 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:

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

Catatan

Paket NuGet tambahan diterbitkan dengan nama DacFx, "Microsoft.SqlServer.DacFx.x64" dan "Microsoft.SqlServer.DacFx.x86". Dukungan untuk kedua platform dicakup dalam paket "Microsoft.SqlServer.DacFx". Referensi baru harus dibuat ke paket ini, bukan varian x64 atau x86.

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 | | | Korea Portugis (Brasil) | Spanyol Rusia |

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

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

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

Langkah berikutnya

Pernyataan Privasi Microsoft