Bermigrasi dengan file DACPAC atau file SQL

Berlaku untuk: ✅ Gudang di Microsoft Fabric

Fabric Migration Assistant untuk Data Warehouse adalah solusi migrasi yang dapat Anda gunakan untuk menyalin kumpulan SQL terdedikasi di Azure Synapse Analytics, database di SQL Server, dan database dari platform Mesin Database SQL lainnya secara mulus ke dalam Fabric Data Warehouse.

Panduan ini memandu Anda melalui langkah-langkah untuk bermigrasi ke Fabric Data Warehouse dengan menggunakan file DACPAC atau zip file .sql.

Petunjuk / Saran

Untuk informasi selengkapnya tentang strategi dan perencanaan migrasi Anda, lihat Perencanaan migrasi: Kumpulan SQL khusus Azure Synapse Analytics ke Fabric Data Warehouse.

Prasyarat

Sebelum memulai, pastikan Anda sudah menyiapkan item berikut:

• Ruang kerja Fabric dengan kapasitas aktif atau kapasitas uji coba.

• Buat ruang kerja atau pilih ruang kerja yang sudah ada yang ingin Anda pindahkan ke dalam. Asisten Migrasi membuat gudang baru untuk Anda.

• File yang berisi metadata objek database, termasuk skema tabel, tampilan, prosedur tersimpan, fungsi, dan lainnya.

  Anda memiliki beberapa opsi untuk file sumber:

  • File DACPAC yang diekstrak dari gudang Anda yang ada. File DACPAC (paket aplikasi tingkat data) dibangun dari proyek database SQL.
    • Anda dapat menggunakan proyek database gaya SDK dengan Visual Studio Code atau utilitas baris perintah SqlPackage.
    • Untuk membuat DAC di Visual Studio 2022 dari Azure Synapse Analytics dengan SQL Server Data Tools, lihat Ekstrak Aplikasi Tingkat Data (DAC) dari kumpulan SQL khusus Azure Synapse di Visual Studio 2022.
  • Zip terkompresi file .sql yang berisi definisi objek database. Ada beberapa cara di mana Anda dapat mengekstrak file .sql.
    • Untuk membuat skrip di SSMS, Anda dapat menggunakan Generate Scripts Wizard.
    • Anda juga dapat menggunakan Skrip SqlPackage.
  • Arsip ZIP terkompresi dari proyek basis data SQL.
    • Untuk membuat proyek database SQL di Visual Studio Code, lihat Proyek Database SQL.

Untuk menggunakan fitur migrasi bantuan AI asisten migrasi untuk memperbaiki masalah migrasi, Anda perlu mengaktifkan Copilot:

• Administrator Anda perlu mengaktifkan opsi penggantian penyewa sebelum Anda mulai menggunakan Copilot. Untuk informasi selengkapnya, lihat Pengaturan Penyewa Copilot.
• Kapasitas F2 atau P1 Anda harus berada di salah satu wilayah yang tercantum dalam ketersediaan wilayah Fabric.
• Jika penyewa atau kapasitas Anda berada di luar AS atau Prancis, Copilot dinonaktifkan secara default kecuali admin penyewa Fabric Anda mengaktifkan Data yang dikirim ke Azure OpenAI dapat diproses di luar wilayah geografis kapasitas Anda, batas kepatuhan, atau pengaturan penyewa instans cloud nasional di portal Fabric Admin.
• Copilot di Microsoft Fabric tidak didukung pada SKU uji coba. Hanya SKU berbayar (F2 atau lebih tinggi, atau P1 atau lebih tinggi) yang didukung saat ini.
• Untuk mengetahui lebih lanjut, lihatlah Ikhtisar Copilot di Fabric dan Power BI.

Salin metadata

1. Di ruang kerja Fabric Anda, pilih tombol Migrasi pada menu tindakan item.

   Cuplikan layar dari portal Fabric yang menampilkan tombol Migrasi di dek tindakan item.

2. Di menu sumber Migrasi ke Fabric, di bawah Migrasi ke gudang, pilih tile sistem sumber.

   • Jika Anda bermigrasi dari kumpulan SQL khusus Azure Synapse Analytics, pilih petak kumpulan SQL khusus Azure Synapse Analytics .
   • Jika Anda bermigrasi dari database T-SQL lainnya, seperti database di SQL Server, Azure SQL Database, atau Azure SQL Managed Instance, pilih petak peta database SQL Server .

   

3. Pada halaman Pilih metode Anda , pilih Unggah file dengan metadata sumber dan pilih Berikutnya.

4. Pilih Pilih file dan unggah file DACPAC gudang data sumber Anda atau zip file .sql yang diekstrak dari gudang data sumber Anda. Setelah unggahan selesai, pilih Berikutnya.

   

5. Di halaman Set tujuan, masukkan nama ruang kerja Fabric baru, item gudang baru yang ingin Anda migrasikan, dan pilih kolase. Pilih Selanjutnya.

6. Tinjau input Anda dan pilih Migrasi. Asisten Migrasi membuat item gudang baru dan memulai migrasi metadata.

   

   Selama langkah ini, Asisten Migrasi menerjemahkan metadata T-SQL ke sintaks T-SQL yang didukung di Fabric Data Warehouse. Setelah migrasi metadata selesai, Asisten Migrasi akan terbuka. Anda dapat mengakses Asisten Migrasi kapan saja dengan menggunakan tombol Migrasi di tab Beranda pita gudang.

7. Tinjau ringkasan migrasi metadata di Asisten Migrasi. Anda melihat jumlah objek yang dimigrasikan dan objek yang perlu diperbaiki sebelum dapat dimigrasikan.

   

8. Pilih Tampilkan objek yang dimigrasikan untuk memperluas bagian dan melihat daftar objek yang berhasil Anda migrasikan ke gudang Fabric Anda.

   Cuplikan layar dari portal Fabric yang menunjukkan ringkasan migrasi metadata dari Asisten Migrasi dan daftar objek yang telah dimigrasikan.

   Kolom Status menunjukkan apakah Asisten Migrasi menyesuaikan metadata objek selama terjemahan ke Fabric Data Warehouse. Misalnya, Anda mungkin melihat bahwa jenis data kolom atau konstruksi bahasa T-SQL tertentu secara otomatis dikonversi ke yang didukung di Fabric. Kolom Detail memperlihatkan informasi tentang penyesuaian yang dibuat portal ke objek.

9. Pilih objek apa pun untuk melihat penyesuaian yang dilakukan Asisten Migrasi selama migrasi.

10. Buka ringkasan migrasi metadata dalam tampilan layar penuh untuk keterbacaan yang lebih baik. Terapkan filter untuk melihat jenis objek tertentu.

    

11. Secara opsional, pilih menu Ekspor untuk mengunduh ringkasan migrasi sebagai file Excel atau CSV.

    • File Excel yang diunduh adalah buku kerja terstruktur penuh dengan dua lembar kerja: Objek yang Dimigrasikan dan Objek Untuk Diperbaiki. Ini sesuai dengan MIP dan selaras dengan label sensitivitas organisasi Anda.
    • CSV ringan dan ramah alat.

    

    Setiap file yang diekspor menyediakan tampilan terstruktur dan komprehensif dari hasil migrasi Anda, termasuk:

    Nama bidang	Deskripsi	Nilai sampel
    Nama objek	Nama objek SQL
    Jenis objek	Jenis objek SQL	Tabel, tampilan, prosedur tersimpan, fungsi
    Status	Status terjemahan	Disesuaikan: Pembaruan yang kompatibel dengan Fabric Data Warehouse diterapkan Tidak disesuaikan: Tidak ada perubahan dalam skrip asli
    Rincian	Daftar penyesuaian yang diterapkan atau pesan kesalahan
    Jenis kesalahan	Jenis kesalahan terjemahan	Pesan terjemahan, Kesalahan terjemahan, Kesalahan penerapan terjemahan

Memperbaiki masalah dengan menggunakan Asisten Migrasi

Beberapa metadata objek database mungkin gagal dimigrasikan. Umumnya, kegagalan ini terjadi karena Asisten Migrasi tidak dapat menerjemahkan metadata T-SQL ke dalam yang didukung di gudang Fabric atau kode yang diterjemahkan gagal diterapkan ke T-SQL.

Perbaiki skrip ini dengan menggunakan Asisten Migrasi.

1. Pilih langkah Perbaiki masalah di Asisten Migrasi untuk melihat skrip yang gagal dimigrasikan.

   Cuplikan layar dari portal Fabric yang menunjukkan daftar Memperbaiki Masalah Asisten Migrasi.

2. Pilih objek database yang gagal dimigrasikan. Kueri baru terbuka di bawah kueri Bersama di Explorer. Kueri baru ini memperlihatkan definisi metadata dan penyesuaian yang dibuat sebagai komentar otomatis yang ditambahkan ke kode T-SQL.

3. Tinjau komentar di awal skrip untuk melihat penyesuaian yang dibuat pada skrip.

4. Tinjau dan perbaiki skrip yang rusak dengan menggunakan informasi kesalahan dan dokumentasi.

5. Untuk menggunakan Copilot untuk bantuan yang didukung AI dalam memperbaiki kesalahan, pilih Perbaiki kesalahan kueri di bagian Tindakan yang disarankan . Copilot memperbarui skrip dengan saran. Kesalahan dapat terjadi karena Copilot menggunakan AI, jadi verifikasi saran kode dan buat penyesuaian apa pun yang Anda butuhkan.

6. Pilih Jalankan untuk memvalidasi dan membuat objek.

7. Skrip berikutnya yang akan diperbaiki terbuka.

8. Lanjutkan untuk memperbaiki sisa skrip. Anda dapat memilih untuk melewati perbaikan skrip yang tidak Anda butuhkan selama langkah ini.

9. Saat semua metadata yang diinginkan siap untuk migrasi, pilih tombol kembali di panel Perbaiki masalah untuk mengembalikan tampilan tingkat atas Asisten Migrasi. Periksa 2. Perbaiki masalah di Asisten Migrasi.

Menyalin data dengan menggunakan Asisten Migrasi

Menyalin data membantu memigrasikan data yang digunakan oleh objek yang Anda migrasikan. Anda dapat menggunakan tugas penyalinan Fabric Data Factory untuk melakukannya secara manual, atau mengikuti langkah-langkah ini untuk integrasi tugas penyalinan di Asisten Migrasi.

1. Pilih langkah Salin data di Asisten Migrasi.

2. Pilih tombol Gunakan tugas salin.

3. Masukkan nama untuk pekerjaan baru, lalu pilih Buat.

4. Pada halaman Sambungkan ke sumber data , masukkan Kredensial koneksi untuk gudang sumber. Pilih Selanjutnya.

5. Di halaman Pilih data , pilih tabel yang ingin Anda migrasikan. Metadata objek harus sudah ada di gudang target. Pilih Selanjutnya.

   

6. Di halaman Pilih tujuan data , pilih item gudang Fabric baru Anda dari katalog OneLake. Pilih Selanjutnya.

7. Di halaman Petakan ke tujuan , konfigurasikan pemetaan kolom setiap tabel. Pilih Selanjutnya.

8. Di halaman Mode pekerjaan salin, pilih mode salin. Pilih salinan data lengkap satu kali (disarankan untuk migrasi), atau penyalinan inkremental berkelanjutan. Pilih Selanjutnya.

9. Tinjau ringkasan pekerjaan. Pilih Simpan + Jalankan.

10. Ketika pekerjaan penyalinan selesai, periksa Langkah 3. Salin Data di Asisten Migrasi. Pilih tombol kembali di bagian atas untuk kembali ke tampilan tingkat atas Asisten Migrasi.

Mengalihkan ulang sambungan

Pada langkah terakhir, sambungkan kembali platform pemuatan dan pelaporan data sehingga koneksi mereka menunjuk ke gudang Fabric baru Anda.

1. Identifikasi koneksi pada gudang sumber yang sudah ada.

   • Pada instans SQL Server, Anda dapat menggunakan tampilan manajemen dinamis, misalnya:

   SELECT 
       s.program_name
   , s.login_name
   , c.client_net_address
   FROM sys.dm_exec_sessions AS s 
   INNER JOIN sys.dm_exec_connections AS c 
   ON s.session_id = c.session_id
   WHERE s.session_id >= 50 --retrieve only user spids
   and s.session_id <> @@SPID; --ignore myself
   

   • Di kumpulan SQL khusus Azure Synapse Analytics, Anda dapat menemukan informasi sesi termasuk aplikasi sumber, yang terhubung, dari mana koneksi berasal, dan jika menggunakan autentikasi Microsoft Entra atau SQL:

   SELECT DISTINCT CASE 
            WHEN len(tt) = 0
                THEN app_name
            ELSE tt
            END AS application_name
        ,login_name
        ,ip_address
   FROM (
        SELECT DISTINCT app_name
            ,substring(client_id, 0, CHARINDEX(':', ISNULL(client_id, '0.0.0.0:123'))) AS ip_address
            ,login_name
            ,isnull(substring(app_name, 0, CHARINDEX('-', ISNULL(app_name, '-'))), 'h') AS tt
        FROM sys.dm_pdw_exec_sessions
        ) AS a;
   

2. Perbarui koneksi ke platform pelaporan Anda untuk mengarah ke gudang Fabric milik Anda.

3. Uji gudang Fabric dengan beberapa laporan sebelum pengalihan jalur. Lakukan perbandingan dan pengujian validasi data di platform pelaporan Anda.

4. Perbarui koneksi untuk platform pengolahan data (ETL/ELT) agar mengarah ke gudang Fabric Anda.

   • Untuk alur Power BI/Fabric:
     1. Gunakan DAFTAR Koneksi REST API untuk menemukan koneksi ke sumber data lama Anda, kumpulan SQL khusus Azure Synapse Analytics.
     2. Perbarui koneksi ke gudang baru dengan menggunakan halaman Kelola Koneksi dan Gateway di Pengaturan.

5. Setelah selesai, periksa langkah Rutekan ulang koneksi di Asisten Migrasi.

Selamat! Anda sekarang siap untuk mulai menggunakan gudang baru Anda.

Konten terkait

• Asisten Migrasi Fabric untuk Gudang Data
• Gambaran Umum Migrasi Microsoft Fabric
• Meningkatkan alur Azure Data Factory Anda ke Fabric