Bagikan melalui

Catatan rilis untuk SqlPackage

Unduh versi terbaru

Artikel ini mencantumkan fitur dan perbaikan yang dikirimkan oleh versi SqlPackage yang dirilis.

Cara membaca catatan rilis ini

Berlaku untuk kolom di setiap bagian dilingkup sebagai berikut:

  • SqlPackage CLI - tindakan baris perintah (menerbitkan, mengimpor, mengekspor, mengekstrak, Parquet, diagnostik, alat dotnet)
  • Proyek MSBuild / SQL - Build proyek SQL (Microsoft.Build.Sql integrasi SDK, SQL Server Data Tools (SSDT))
  • DacFx API / Perbandingan Skema - Microsoft.SqlServer.DacFx API NuGet, perbandingan skema
  • Platform - ScriptDom, Microsoft.Data.SqlClient, .NET dukungan, sistem DACPAC, pengaturan bawaan kompatibilitas

Rilis saat ini (170.x)

Rilis berikut adalah versi SqlPackage yang saat ini didukung.

170.3.93 SqlPackage

Tanggal rilis: 10 Februari 2026

dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Platform Download
Windows .NET 10 file .zip
Windows file.msi
macOS .NET 10 file .zip
Linux .NET 10 file .zip

Features

Feature Details Berlaku pada
Deployment Dukungan untuk opsi database ACCELERATED_DATABASE_RECOVERY dan OPTIMIZED_LOCKING telah ditambahkan. SqlPackage CLI; DacFx API / Perbandingan skema
Permissions Meningkatkan penerbitan hak akses untuk menyertakan izin EXECUTE ON EXTERNAL MODEL. SqlPackage CLI; DacFx API / Perbandingan skema
Platform Menambahkan dukungan .NET 10 ke pustaka DacFx dan SqlPackage CLI. SqlPackage dotnet tool tersedia untuk .NET 8 dan .NET 10. Platform; SqlPackage CLI; DacFx API / Perbandingan Skema
Platform Menambahkan dukungan .NET Standard 2.0 ke pustaka DacFx. Platform; DacFx API / Perbandingan skema
Platform Referensi Microsoft.Data.SqlClient v6.1.3. Platform
ScriptDom Memperbarui ScriptDom ke versi 170.157.0. Platform
Vector Memperluas dukungan kolom vektor untuk memungkinkan perubahan jenis dasar. SqlPackage CLI; Proyek MSBuild / SQL; DacFx API / Perbandingan skema

Fixes

Feature Details Berlaku pada
Deployment Telah memperbaiki bug ketika menyebarkan ke database SQL di Microsoft Fabric ketika database target menyertakan kebijakan keamanan. SqlPackage CLI; DacFx API / Perbandingan skema
Export Memperbaiki masalah di mana file yang diekspor .dacpac gagal validasi skema XSD karena nilai atribut boolean menggunakan nilai True/False alih-alih huruf kecil true/false. Masalah GitHub SqlPackage CLI
Import Memperbaiki masalah saat mengimpor tabel dengan karakter khusus dalam nama (seperti /, , "atau $) secara diam-diam gagal mengimpor data tanpa memperingatkan pengguna. Masalah GitHub SqlPackage CLI
Ledger Memperbaiki masalah di mana tabel ledger dengan kolom terhitung menyebabkan NullReferenceException selama proses validasi dan penyusunan model. Masalah GitHub Proyek MSBuild / SQL; DacFx API / Perbandingan skema
Proyek SQL Memperbaiki masalah saat membangun proyek SQL yang memiliki definisi indeks kolom berkluster sebaris pada tabel, yang gagal dengan kesalahan sintaks. Masalah GitHub Proyek MSBuild / SQL
Proyek SQL Memperbaiki masalah di mana indeks penyimpan kolom berkluster pada tabel dengan NVARCHAR(MAX) atau kolom jenis LOB lainnya salah melaporkan kesalahan bahwa indeks penyimpan kolom tidak didukung dengan kolom vektor. Masalah GitHub Proyek MSBuild / SQL
Vector Memperbaiki masalah di mana prosedur yang menggunakan VECTOR_SEARCH mengeluarkan peringatan validasi bahwa referensi kolom tidak dapat dipecahkan. Masalah GitHub Proyek MSBuild / SQL; DacFx API / Perbandingan skema

170.2.70 SqlPackage

Tanggal rilis: 14 Oktober 2025

dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Platform Download
Windows .NET 8 file .zip
Windows file.msi
macOS .NET 8 file .zip
Linux .NET 8 file .zip

Features

Feature Details Berlaku pada
Model eksternal Dukungan ditambahkan untuk model eksternal di Azure SQL Database dan SQL Server 2025 (17.x) untuk impor, ekspor, ekstrak, penyebaran, dan pembangunan proyek SQL. SqlPackage CLI; MSBuild / Proyek SQL; DacFx API / Perbandingan Skema
Model eksternal Menambahkan dukungan untuk fungsi AI_GENERATE_CHUNKS dan AI_GENERATE_EMBEDDINGS. SqlPackage CLI; DacFx API / Membandingkan skema
JSON Dukungan ditambahkan untuk indeks JSON di Azure SQL Database dan SQL Server 2025 (17.x) untuk impor, ekspor, ekstraksi, penyebaran, dan pembangunan proyek basis data SQL. SqlPackage CLI; Proyek MSBuild / SQL; DacFx API / Perbandingan skema
JSON Menambahkan dukungan untuk fungsi-fungsi JSON JSON_ARRAYAGG, JSON_OBJECTAGG, dan JSON_QUERY. SqlPackage CLI; Proyek MSBuild / SQL; DacFx API / Perbandingan skema
Platform SqlPackage .zip build .NET SDK diperbarui ke 8.0.414 Platform; SqlPackage CLI
Regex Menambahkan dukungan untuk fungsi REGEXP_LIKE ini. SqlPackage CLI; Proyek MSBuild / SQL; DacFx API / Perbandingan skema
ScriptDom ScriptDom yang diperbarui ke versi 170.128.0. Platform
Vector Telah ditambahkan dukungan untuk indeks vektor di Azure SQL Database dan SQL Server 2025 (17.x) untuk impor, ekspor, ekstraksi, penyebaran, dan pembuatan proyek SQL. SqlPackage CLI; Proyek MSBuild / SQL; DacFx API / Perbandingan skema
Vector Memperluas dukungan untuk jenis data vektor ke SQL Server 2025 (17.x) dan menentukan ukuran float 32-bit. SqlPackage CLI; Proyek MSBuild / SQL; DacFx API / Perbandingan skema
Vector Menambahkan dukungan untuk fungsi Vektor VECTOR_SEARCH. SqlPackage CLI; Proyek MSBuild / SQL; DacFx API / Perbandingan skema

Fixes

Feature Details Berlaku pada
Masking data Memperbaiki masalah di mana fungsi pengaburan tanggal dan waktu tidak dikenali selama build proyek. Masalah GitHub Proyek MSBuild / SQL
Model eksternal Memperbaiki masalah di mana dependensi model eksternal pada kredensial dengan cakupan database menyebabkan kompilasi proyek gagal. Proyek MSBuild / SQL
JSON Memperbaiki bug saat membandingkan indeks JSON dengan jalur JSON default. DacFx API / Skema membandingkan; SqlPackage CLI
Platform Referensi Microsoft.Data.SqlClient v5.1.7. Platform
XML Memperbaiki masalah di mana jalur kueri XML (xQuery) tidak diperlakukan sebagai sensitif terhadap huruf besar/kecil selama perbandingan model. Bahkan pada database yang tidak peka huruf besar/kecil, jalur xQuery peka huruf besar/kecil. Masalah GitHub DacFx API / Skema membandingkan; SqlPackage CLI

170.1.61 SqlPackage

Tanggal rilis: 30 Juli 2025

dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Platform Download
Windows .NET 8 file .zip
Windows file.msi
macOS .NET 8 file .zip
Linux .NET 8 file .zip

Features

Feature Details Berlaku pada
Virtualisasi data Menambahkan dukungan untuk objek yang terkait dengan virtualisasi data untuk Azure SQL Database dalam operasi impor, ekspor, ekstrak, dan terbitkan. SqlPackage CLI
Virtualisasi data Menambahkan Azure SQL Database ke pratinjau terbitkan dengan file Parquet, memungkinkan penggunaan Azure Blob Storage dan file Parquet untuk mengimpor data ke dalam database. Mengekstrak data ke file parket tidak tersedia untuk Azure SQL Database karena bergantung pada fungsionalitas yang tidak tersedia di Azure SQL Database, CREATE EXTERNAL TABLE AS SELECT. SqlPackage CLI
Deployment Menambahkan dukungan untuk properti /p:IgnorePreDeployScript dan /p:IgnorePostDeployScript dalam publikasi. Properti ini default ke false dan ketika diaktifkan mengakibatkan rencana penyebaran menghilangkan skrip yang sesuai. Masalah GitHub SqlPackage CLI; DacFx API / Membandingkan skema
Permissions Menambahkan dukungan untuk izin ALTER ANY EXTERNAL MIRROR untuk Database Azure SQL dan database SQL di Microsoft Fabric. Izin ini diperlukan untuk mengekspor database yang berisi satu atau beberapa tabel cermin. Masalah GitHub SqlPackage CLI; DacFx API / Membandingkan skema
Permissions Menambahkan dukungan untuk izin CREATE ANY EXTERNAL MODEL dan ALTER ANY EXTERNAL MODEL untuk SQL Server 2025 (17.x). SqlPackage CLI; DacFx API / Membandingkan skema
Permissions Menambahkan dukungan untuk izin ALTER ANY INFORMATION PROTECTION untuk SQL Server 2025 (17.x) dan Azure SQL Database. SqlPackage CLI; DacFx API / Membandingkan skema
Platform SqlPackage .zip build .NET SDK diperbarui ke 8.0.412. Platform; SqlPackage CLI
ScriptDom Memperbarui ScriptDom ke versi 170.0.64. Platform
ScriptDom Memperbarui gudang Data di platform Fabric untuk menggunakan TSqlFabricDWParser di ScriptDom. Platform; DacFx API / Perbandingan skema

Fixes

Feature Details Berlaku pada
Selalu Terenkripsi Memperbaiki masalah di mana opsi Interactive untuk parameter /AzureKeyVaultAuthMethod penerbitan tidak berfungsi dengan benar. SqlPackage CLI
Deployment Memperbaiki masalah DbScopedConfigMaxDOPSecondary di mana properti tidak ditetapkan dengan benar pada penyebaran. Masalah GitHub SqlPackage CLI; DacFx API / Membandingkan skema
Deployment Memperbaiki masalah saat menerbitkan tabel yang berisi batasan kunci asing gagal karena sintaksis yang tidak didukung oleh gudang data di Microsoft Fabric. SqlPackage CLI
Deployment Memperbaiki masalah di mana objek server disertakan saat menyebarkan ke database SQL di Microsoft Fabric. Objek server tidak didukung dalam database SQL di Microsoft Fabric. Masalah GitHub SqlPackage CLI
Deployment Memperbaiki masalah di mana indeks penyimpan kolom berkluster dibuat dengan terlebih dahulu membuat indeks berkluster, yang meningkatkan overhead sumber daya dan waktu implementasi. Masalah GitHub SqlPackage CLI
Extract Memperbaiki masalah saat mengekstrak database dari database SQL di Microsoft Fabric menghasilkan skrip definisi pengguna yang tidak dapat digunakan. Masalah GitHub SqlPackage CLI

170.0.94 SqlPackage

Tanggal rilis: 15 April 2025

dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Platform Download
Windows .NET 8 file .zip
Windows file.msi
macOS .NET 8 file .zip
Linux .NET 8 file .zip

Features

Feature Details Berlaku pada
DACPACVerify Dukungan untuk memverifikasi konten dua .dacpac file ditambahkan di alat pratinjau Microsoft.DacpacVerify. DacFx API / Perbandingan skema
Extract Menambahkan dukungan untuk membongkar file .dacpac ke dalam folder. Perintah /Action:Extract digunakan dengan parameter /SourceFile: dan /TargetFile:. File target harus berupa folder dan ketika file sumber (.dacpac) ditentukan tidak ada properti koneksi database yang valid. Properti /p:ExtractTarget=SchemaObjectType diperlukan untuk mengekstrak dari .dacpac file alih-alih database sumber. Executable Dacunpack.exe dihapus dari alat penginstal DacFx.msi . SqlPackage CLI; DacFx API / Membandingkan skema
Parquet Menambahkan dukungan untuk jenis data timestamp, rowversion, pengidentifikasi unik, text, ntext, image, json, xml, dan vektor saat menggunakan file Parquet di Azure Blob Storage dengan operasi ekstrak dan penerbitan SqlPackage. SqlPackage CLI
Parquet Menambahkan dukungan untuk mengekspor dan mengimpor data tabel ke file BCP saat tabel berisi jenis data yang tidak didukung saat menggunakan file Parquet di Azure Blob Storage untuk data yang tersisa dengan operasi ekstrak dan penerbitan SqlPackage. Contoh jenis data adalah sql_variant, dan tabel yang berisi kolom dengan jenis tersebut ditulis ke BCP terlebih dahulu, sementara tabel yang tersisa ditulis ke file Parquet di Azure Blob Storage. SqlPackage CLI
Platform Memperbarui SqlPackage untuk versi .NET Framework ke .NET Framework 4.7.2. Platform; SqlPackage CLI
Platform Menghapus dukungan untuk .NET 6. Platform; SqlPackage CLI
ScriptDom Memperbarui ScriptDom ke versi 170.18.0. Platform
Proyek SQL Tingkat kompatibilitas default untuk Azure SQL Database dan database SQL di Microsoft Fabric sekarang diatur ke 170. Untuk informasi selengkapnya, lihat Tingkat kompatibilitas database 170 di Azure SQL Database dan database SQL di Microsoft Fabric. Proyek MSBuild / SQL
Vector Jenis data vektor sekarang didukung di platform Azure SQL Database target untuk impor, ekspor, ekstrak, penyebaran, dan pembangunan proyek SQL. SqlPackage CLI; Proyek MSBuild / SQL; DacFx API / Perbandingan skema

Fixes

Feature Details Berlaku pada
Deployment Memperbaiki masalah saat menyebarkan perubahan ke tabel eksternal menyebabkan semua tabel eksternal dihilangkan dan dibuat ulang jika tabel yang dimodifikasi tidak berisi nilai untuk REJECT_VALUE atau REJECT_SAMPLE_VALUE. SqlPackage CLI; DacFx API / Membandingkan skema
Deployment Memperbaiki masalah di mana mengubah kolom untuk memperluas panjangnya mengakibatkan peringatan kehilangan data yang tidak tepat jika pengurutan kolom ditentukan dan sesuai dengan pengurutan default database. Masalah GitHub SqlPackage CLI; DacFx API / Membandingkan skema
Deployment Memperbaiki masalah saat klasifikasi sensitivitas berubah pada tabel menyebabkan indeks dibuat ulang. Masalah GitHub SqlPackage CLI; DacFx API / Membandingkan skema
Export Mengoptimalkan penggunaan estimasi ukuran tabel selama operasi ekspor. SqlPackage CLI
Extract Memperbaiki masalah di mana mengekstrak .dacpac dengan referensi database mengakibatkan kegagalan. Masalah GitHub SqlPackage CLI; DacFx API / Membandingkan skema
Gudang Data Fabric Memperbaiki masalah di mana prosedur tersimpan sp_refreshsqlmodule sistem dipanggil selama operasi penerbitan. Fabric Data Warehouse tidak mendukung sp_refreshsqlmodule dan ini menyebabkan penyebaran gagal. SqlPackage CLI
Gudang Data Fabric Memperbaiki masalah di mana batasan tabel disertakan dalam file .dacpac tetapi tidak dalam file .sql saat database diekstraksi dari Fabric Data Warehouse. Masalah GitHub SqlPackage CLI
Proyek SQL Memperbaiki masalah saat membangun tanpa SSDT yang diinstal di Visual Studio menghasilkan perilaku build yang salah. Masalah GitHub Proyek MSBuild / SQL
Proyek SQL Memperbaiki masalah di mana peringatan build muncul secara berulang dalam output ketika analisis kode diaktifkan. Masalah GitHub Proyek MSBuild / SQL
Proyek SQL Memperbaiki masalah di mana parameter broker layanan diatur ke variabel menghasilkan peringatan palsu. Masalah GitHub Proyek MSBuild / SQL

Rilis yang diarsipkan (162.x dan versi yang lebih lama)

Anda dapat menemukan catatan rilis untuk versi 162.x dan versi yang lebih lama di catatan Rilis untuk SqlPackage (arsip).

  • Last updated on