SqlPackage untuk database SQL di Microsoft Fabric

Berlaku untuk:✅Database SQL di Microsoft Fabric

Dalam tutorial ini, Anda mempelajari cara bekerja dengan SqlPackage di database SQL Anda di Fabric.

SqlPackage adalah CLI yang menyediakan portabilitas database dan penyebaran database.

• Portabilitas (impor/ekspor) database yang dikelola di Azure atau di Fabric memastikan bahwa data Anda portabel ke platform lain, termasuk SQL Server atau Azure SQL Managed Instance, jika Anda ingin bermigrasi nanti.
• Portabilitas yang sama juga memungkinkan skenario migrasi tertentu melalui salinan database mandiri (.bacpac) dengan operasi impor/ekspor.

SqlPackage juga dapat mengaktifkan penyebaran database yang mudah dari perubahan bertahap pada objek database (kolom baru dalam tabel, perubahan pada prosedur tersimpan yang ada, dll.).

• SqlPackage dapat mengekstrak file yang .dacpac berisi definisi objek dalam database, dan menerbitkan .dacpac file untuk menerapkan status objek tersebut ke database baru atau yang sudah ada.
• Operasi penerbitan juga terintegrasi dengan proyek SQL, yang memungkinkan siklus pengembangan offline dan lebih dinamis untuk database SQL.

Prasyarat

• Anda memerlukan kapasitas Fabric yang ada. Jika tidak, mulai uji coba Fabric.
• Pastikan Anda Mengaktifkan database SQL di pengaturan penyewa Fabric.
• Buat ruang kerja baru atau gunakan ruang kerja Fabric yang ada.
• Membuat atau menggunakan database SQL yang ada di Fabric. Jika Anda belum memilikinya, buat database SQL baru di Fabric.
• Instal .NET 8 SDK.

Siapkan

SqlPackage tersedia untuk Windows, macOS, dan Linux sebagai alat dotnet. Anda dapat menginstalnya menggunakan perintah berikut:

dotnet tool install --global Microsoft.SqlPackage

Sebagai alat dotnet global, SqlPackage tersedia di terminal Anda seperti sqlpackage dari folder apa pun.

Mengimpor database dengan SqlPackage

.bacpac adalah salinan portabel database, berguna untuk beberapa skenario migrasi dan pengujian. Anda dapat .bacpac ke dalam database SQL kosong.

1. Jika menggunakan .bacpac dari lingkungan Azure SQL Database, Anda mungkin perlu mengubah database sumber untuk memenuhi area permukaan T-SQL database Fabric SQL.

2. Buat database SQL baru Anda di Fabric seperti biasa melalui antarmuka Fabric.

3. Salin string koneksi dari pengaturan.

   

4. Gunakan perintah impor dari terminal di folder sqlpackage. Berikan pemilik <servername> Anda dan <database_name>.

   sqlpackage /action:import /sourcefile:"C:\DatabaseName.bacpac" /targetconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"
   

   • Ganti string koneksi Anda dari dialog pengaturan database SQL.
   • sourcefile Ganti nilai dengan .bacpac nama (DatabaseName) dan location pada komputer lokal Anda.

Untuk informasi selengkapnya tentang impor, lihat Impor SqlPackage.

Mengekspor database dengan SqlPackage

Mengekspor adalah .bacpac operasi terbalik, di mana Anda targetfile adalah dan .bacpac Anda sourceconnectionstring dapat ditemukan dalam dialog pengaturan database SQL, seperti pada contoh sebelumnya. Berikan pemilik <servername> Anda dan <database_name>. Contohnya:

sqlpackage.exe /action:export /targetfile:"C:\DatabaseName.bacpac" /sourceconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"

Untuk informasi selengkapnya tentang ekspor, lihat Ekspor SqlPackage.

Mengekstrak dan menerbitkan

.dacpac adalah file model skema database, yang berisi definisi untuk tabel, prosedur tersimpan, dan objek lain dalam database sumber. File ini dapat dibuat dari database yang ada dengan SqlPackage atau dari proyek database SQL .

SqlPackage mampu menyebarkan .dacpac ke database baru (kosong) atau memperbarui database yang ada secara bertahap agar sesuai dengan status yang diinginkan .dacpac .

• Ekstrak membuat .dacpac file atau sql dari database yang sudah ada.
• Menerbitkan menyebarkan .dacpac ke database.

Sintaks SqlPackage menerbitkan dan ekstrak mirip dengan perintah impor/ekspor.

Untuk menyebarkan .dacpac yang dibuat dari Azure SQL Database, SQL Server, atau proyek SQL yang menargetkan platform selain database SQL di Fabric, tambahkan properti /p:AllowIncompatiblePlatform=true ke perintah terbitkan SqlPackage.

Konten terkait

• Database SQL di Microsoft Fabric
• Tutorial: Manajemen siklus hidup di Fabric
• Gambaran umum proyek SQL
• Integrasi kontrol sumber database SQL