Menambahkan Azure Cosmos DB CDC sebagai sumber di hub Real-Time

Artikel ini menjelaskan cara menambahkan Azure Cosmos DB untuk NoSQL Change Data Capture (CDC) sebagai sumber peristiwa di hub Fabric Real-Time.

Konektor sumber Azure Cosmos DB Change Data Capture (CDC) memungkinkan Anda mengambil rekam jepret data saat ini dalam database Azure Cosmos DB. Konektor kemudian memantau dan merekam perubahan tingkat baris di masa mendatang pada data ini. Setelah perubahan diambil dalam aliran, Anda dapat memproses data CDC ini secara real time dan mengirimkannya ke tujuan yang berbeda dalam Fabric untuk pemrosesan atau analisis lebih lanjut.

Prasyarat

• Akses ke ruang kerja dalam mode lisensi kapasitas Fabric (atau) mode lisensi Uji Coba dengan Kontributor atau izin yang lebih tinggi.
• Akses ke akun dan database Azure Cosmos DB for NoSQL .
• Database Azure Cosmos DB for NoSQL Anda harus dapat diakses secara publik dan tidak berada di belakang firewall atau diamankan dalam jaringan virtual.
• Jika Anda tidak memiliki eventstream, buat eventstream.

Mendapatkan detail koneksi dari portal Azure

Label untuk item yang perlu Anda kumpulkan dari portal Azure diperlihatkan dalam langkah-langkah berikut. Anda selalu memerlukan URI titik akhir, dalam format seperti https://<account>.<api>.azure.com:<port>/, Kunci Primer, dan NAMA database dan ID item yang ingin Anda kumpulkan datanya.

1. Pada halaman portal Azure untuk akun Azure Cosmos DB Anda, pilih Kunci di bawah Pengaturan di navigasi kiri.

2. Pada halaman Kunci , salin nilai URI dan Kunci primer yang akan digunakan untuk menyiapkan koneksi eventstream.

   

3. Pada halaman Gambaran Umum portal Azure untuk akun Azure Cosmos DB Anda, perhatikan ID Database dan item yang ingin Anda kumpulkan datanya.

   

Mendapatkan peristiwa dari Azure Cosmos DB CDC

Anda bisa mendapatkan peristiwa dari CdC Azure Cosmos DB ke hub Real-Time dengan salah satu cara:

• Menggunakan pengalaman Tambahkan sumber
• Menggunakan halaman sumber Microsoft

Halaman sumber data

1. Masuk ke Microsoft Fabric.

2. Pilih Real-Time di bilah navigasi kiri.

3. Pada halaman hub Real-Time, pilih + Sumber data di bawah Sambungkan ke di menu navigasi kiri. Anda juga bisa masuk ke halaman Sumber data dari semua aliran data atau Halaman aliran data saya dengan memilih tombol + Sambungkan sumber data di sudut kanan atas.

   

Gunakan instruksi dari bagian Tambahkan CdC Azure Cosmos DB sebagai sumber .

Halaman sumber Microsoft

1. Di Hub Real Time, pilih sumber Microsoft.

2. Di daftar drop-down Sumber, pilih Azure Cosmos DB (CDC).

3. Untuk Langganan, pilih langganan Azure yang memiliki grup sumber daya dengan akun Cosmos DB Anda.

4. Untuk Grup sumber daya, pilih grup sumber daya yang memiliki akun Cosmos DB Anda.

5. Untuk Wilayah, pilih lokasi tempat Cosmos DB Anda berada.

6. Sekarang, pindahkan mouse ke atas nama sumber CDC Cosmos DB yang ingin Anda sambungkan ke hub Real-Time dalam daftar database, dan pilih tombol Sambungkan , atau pilih ... (elipsis), lalu pilih tombol Sambungkan .

   

   Untuk mengonfigurasi informasi koneksi, gunakan langkah-langkah dari bagian Tambahkan AZURE Cosmos DB CDC sebagai sumber . Lewati langkah pertama memilih CdC Azure Cosmos DB sebagai jenis sumber di wizard Tambahkan sumber.

Menambahkan Azure Cosmos DB CDC sebagai sumber

1. Pada halaman Sambungkan , pilih Koneksi baru.

   

2. Di bagian Pengaturan koneksi , tentukan titik akhir Cosmos DB. Masukkan URI atau titik akhir untuk akun Cosmos DB yang Anda salin dari portal Azure.

   

3. Perluas opsi Tingkat Lanjut, dan ikuti langkah-langkah berikut:

   1. Untuk Jumlah percobaan ulang, tentukan berapa kali konektor harus mengirimkan ulang permintaan ke database Cosmos DB jika permintaan gagal dari kesalahan yang dapat dipulihkan.

   2. Untuk Aktifkan fungsi AVERAGE turun, tentukan apakah konektor harus menurunkan fungsi agregat AVG ke database Cosmos DB.

   3. Untuk Aktifkan sortir turun untuk beberapa kolom, tentukan apakah konektor harus mengizinkan beberapa kolom untuk diteruskan ke database Cosmos DB saat ditentukan dalam klausul ORDER BY dari kueri SQL.

      

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

   1. Pilih koneksi yang sudah ada dan pertahankan opsi Buat koneksi baru default.
   2. Untuk membuat koneksi, masukkan nilai berikut:

      1. Untuk Nama koneksi, masukkan nama untuk koneksi.

      2. Untuk Jenis autentikasi, pilih Kunci akun.

      3. Untuk Kunci akun, masukkan nilai kunci yang Anda simpan sebelumnya.

      4. Pilih Sambungkan.

         

5. Sekarang, pada halaman Sambungkan , lakukan langkah-langkah berikut:

   1. Tentukan ID Kontainer kontainer di akun Azure Cosmos DB Anda.

   2. Di bagian Detail aliran di sebelah kanan, pilih ruang kerja Fabric tempat Anda ingin menyimpan eventstream yang akan dibuat Wizard.

   3. Untuk nama eventstream, masukkan nama untuk eventstream. Wizard membuat eventstream dengan CDC Azure Cosmos DB yang dipilih sebagai sumber.

   4. Nama Stream secara otomatis dibuat untuk Anda dengan menambahkan -stream ke nama eventstream. Anda dapat melihat aliran ini di halaman Hub real-time Semua aliran data saat wizard selesai.

   5. Pilih Selanjutnya.

      

6. Pada layar Tinjau + sambungkan, tinjau ringkasan, lalu pilih Buat sumber.

   

Menampilkan detail aliran data

1. Pada halaman Tinjau + sambungkan , jika Anda memilih Buka eventstream, wizard akan membuka eventstream yang dibuatnya untuk Anda dengan CDC Azure Cosmos DB yang dipilih sebagai sumber. Untuk menutup wizard, pilih Tutup atau X* di sudut kanan atas halaman.

   

2. Di Hub Real-Time, pilih Semua aliran data. Untuk melihat aliran data baru, refresh halaman Semua aliran data.

   

   Untuk langkah-langkah terperinci, lihat Melihat detail aliran data di hub Fabric Real-Time.

Konten terkait

Untuk mempelajari tentang menggunakan aliran data, lihat artikel berikut ini:

• Memproses aliran data
• Menganalisis aliran data
• Mengatur pemberitahuan pada aliran data