Bagikan melalui

Menambahkan sumber CDC Azure SQL Database ke eventstream

Artikel ini memperlihatkan kepada Anda cara menambahkan sumber Azure SQL Database Change Data Capture (CDC) ke eventstream.

Konektor sumber Azure SQL Database CDC untuk aliran peristiwa Microsoft Fabric memungkinkan Anda mengambil cuplikan data saat ini dalam database Azure SQL. Konektor kemudian memantau dan merekam perubahan tingkat baris di masa mendatang pada data ini. Setelah perubahan diambil dalam eventstream, Anda dapat memproses data CDC ini secara real time dan mengirimkannya ke tujuan yang berbeda dalam Fabric untuk pemrosesan atau analisis lebih lanjut.

Catatan

Sumber ini tidak didukung di wilayah kapasitas ruang kerja Anda berikut: Barat US3, Barat Swiss.

Prasyarat

  • Akses ke ruang kerja dalam mode lisensi kapasitas Fabric atau mode lisensi Uji Coba dengan izin Kontributor atau yang setara atau lebih tinggi.
  • Server Azure SQL yang sedang berjalan dengan database Azure SQL.
  • Database Azure SQL Anda harus dapat diakses secara publik dan tidak berada di belakang firewall atau diamankan dalam jaringan virtual.
  • Mengaktifkan CDC di database Azure SQL Anda dengan menjalankan prosedur sys.sp_cdc_enable_dbtersimpan . Untuk detailnya, lihat Mengaktifkan dan menonaktifkan penangkapan data perubahan.
  • Jika Anda tidak memiliki eventstream, buat eventstream.

Perhatikan bahwa Anda tidak boleh mengaktifkan pencerminan di database Azure SQL Anda.

Mengaktifkan CDC di Azure SQL Database Anda

  1. Buka portal Azure, buka database Azure SQL Anda, dan pilih Editor kueri. Pilih metode autentikasi untuk masuk.

    Cuplikan layar membuka database Azure SQL.

  2. Jalankan perintah SQL berikut untuk mengaktifkan CDC di database Anda:

    -- Enable Database for CDC
EXEC sys.sp_cdc_enable_db;

-- Enable CDC for a table using a gating role option
EXEC sys.sp_cdc_enable_table
    @source_schema = N'dbo',
    @source_name   = N'MyTable',
    @role_name     = NULL
GO

Luncurkan panduan Pilih sumber data

Jika Anda belum menambahkan sumber apa pun ke eventstream Anda, pilih Gunakan petak sumber eksternal.

Cuplikan layar yang memperlihatkan pilihan petak Gunakan sumber eksternal.

Jika Anda menambahkan sumber ke eventstream yang sudah diterbitkan, beralihlah ke mode Edit , pilih Tambahkan sumber pada pita, lalu pilih Sumber eksternal.

Cuplikan layar yang memperlihatkan pilihan menu Tambahkan sumber ke Sumber eksternal.  

Pada halaman Pilih sumber data, cari dan pilih Sambungkan pada petak peta Azure SQL DB (CDC ).

Cuplikan layar yang memperlihatkan pemilihan Azure SQL DB CDC sebagai tipe sumber dalam wizard Pengambilan Peristiwa.

Mengonfigurasi dan menyambungkan ke Azure SQL Database CDC

  1. Pada halaman Sambungkan , pilih Koneksi baru.

    Cuplikan layar yang memperlihatkan halaman Hubungkan wizard Dapatkan acara dengan tautan **Koneksi Baru** yang disorot.

  2. Di bagian Pengaturan koneksi , masukkan nilai berikut untuk database Azure SQL Anda:

    • Server: Masukkan nama server Azure SQL dari portal Azure. Ini dalam bentuk ini: mysqlservername.database.windows.net.

    • Database: Masukkan nama database Azure SQL dari portal Azure.

      Cuplikan layar yang memperlihatkan bagian Pengaturan koneksi dari halaman Koneksi baru.

  3. Gulir ke bawah, dan di bagian Kredensial koneksi, ikuti langkah-langkah ini.

    • Untuk Nama koneksi, masukkan nama untuk koneksi.

    • Untuk Jenis autentikasi, pilih Dasar.

      Catatan

      Saat ini, aliran peristiwa Fabric hanya mendukung autentikasi Dasar .

    • Masukkan Nama Pengguna dan Kata Sandi untuk database.

  4. Pilih Sambungkan.

    Cuplikan layar yang memperlihatkan bagian Kredensial koneksi dari halaman Koneksi baru.

  5. Sekarang, pada halaman Sambungkan, pilih Semua tabel atau Masukkan nama tabel. Jika Anda memilih yang terakhir, tentukan tabel menggunakan daftar pengidentifikasi tabel lengkap yang dipisahkan koma (schemaName.tableName) atau ekspresi reguler yang valid. Misalnya:

    • Gunakan dbo.test.* untuk memilih semua tabel yang namanya dimulai dengan dbo.test.
    • Gunakan dbo\.(test1|test2) untuk memilih dbo.test1 dan dbo.test2.

    Anda dapat mencampur kedua format menggunakan koma. Hingga 100 tabel dapat dimasukkan, dengan setiap nama tabel (termasuk nama skema) dibatasi hingga 128 karakter jika menggunakan pengidentifikasi tabel lengkap secara langsung.

  6. Anda dapat memperluas pengaturan Tingkat Lanjut untuk mengonfigurasi mode Penanganan desimal, yang menentukan cara konektor menangani DECIMAL dan NUMERIC nilai kolom:

    • Precise: Mewakili nilai menggunakan jenis desimal yang tepat (misalnya, Java BigDecimal) untuk memastikan presisi dan akurasi penuh dalam representasi data.
    • Double: Mengonversi nilai menjadi angka floating-point presisi ganda. Ini meningkatkan kegunaan dan performa tetapi dapat mengakibatkan hilangnya presisi.
    • String: Mengodekan nilai sebagai string yang diformat. Ini membuatnya mudah dikonsumsi dalam sistem hilir tetapi kehilangan informasi semantik tentang jenis numerik asli.

  7. Pilih Selanjutnya.

    Cuplikan layar yang memperlihatkan halaman Sambungkan wizard Dapatkan peristiwa terisi.

  8. Pada layar Tinjau dan buat, tinjau ringkasan, lalu pilih Tambahkan.

    Cuplikan layar yang memperlihatkan halaman Tinjau dan buat dari wizard Get events yang sudah terisi.

Menampilkan eventstream yang diperbarui

  1. Anda dapat melihat sumber Azure SQL Database (CDC) ditambahkan ke eventstream Anda dalam mode Edit.

    Cuplikan layar streaming sumber CDC Azure SQL Database dalam tampilan Edit.

  2. Untuk menerapkan sumber CDC Azure SQL Database yang baru ditambahkan ini, pilih Terbitkan. Setelah Anda menyelesaikan langkah-langkah ini, sumber CDC Azure SQL Database Anda tersedia untuk visualisasi dalam Live view.

    Cuplikan layar streaming sumber CDC Azure SQL Database di tampilan Langsung.

Konten terkait

Konektor lain: