Bagikan melalui


Tutorial: Mengonfigurasi database cermin Microsoft Fabric untuk Azure Cosmos DB (Pratinjau)

Dalam tutorial ini, Anda mengonfigurasi database cermin Fabric dari akun Azure Cosmos DB for NoSQL yang ada.

Mencerminkan secara bertahap mereplikasi data Azure Cosmos DB ke Fabric OneLake mendekati real-time, tanpa memengaruhi performa beban kerja transaksional atau menggunakan Unit Permintaan (RU). Anda dapat membuat laporan Power BI langsung pada data di OneLake, menggunakan mode DirectLake. Anda dapat menjalankan kueri ad-hoc di SQL atau Spark, membuat model data menggunakan notebook dan memanfaatkan kemampuan AI bawaan Copilot dan tingkat lanjut di Fabric untuk menganalisis data.

Penting

Pencerminan untuk Azure Cosmos DB saat ini dalam pratinjau. Beban kerja produksi tidak didukung selama pratinjau. Saat ini, hanya Azure Cosmos DB untuk akun NoSQL yang didukung.

Prasyarat

  • Akun Azure Cosmos DB for NoSQL yang sudah ada.
  • Kapasitas Fabric yang ada. Jika Anda tidak memiliki kapasitas yang ada, mulai uji coba Fabric. Pencerminan mungkin tidak tersedia di beberapa wilayah Fabric. Untuk informasi selengkapnya, lihat wilayah yang didukung.

Tip

Selama pratinjau publik, disarankan untuk menggunakan salinan pengujian atau pengembangan data Azure Cosmos DB Anda yang ada yang dapat dipulihkan dengan cepat dari cadangan.

Mengonfigurasi akun Azure Cosmos DB Anda

Pertama, pastikan bahwa akun Azure Cosmos DB sumber dikonfigurasi dengan benar untuk digunakan dengan pencerminan Fabric.

  1. Navigasi ke akun Azure Cosmos DB Anda di portal Azure.

  2. Pastikan bahwa pencadangan berkelanjutan diaktifkan. Jika tidak diaktifkan, ikuti panduan di memigrasikan akun Azure Cosmos DB yang ada ke pencadangan berkelanjutan untuk mengaktifkan pencadangan berkelanjutan. Fitur ini mungkin tidak tersedia dalam beberapa skenario. Untuk informasi selengkapnya, lihat batasan database dan akun.

  3. Pastikan bahwa opsi jaringan diatur ke akses jaringan publik untuk semua jaringan. Jika tidak, ikuti panduan di mengonfigurasi akses jaringan ke akun Azure Cosmos DB.

Membuat database cermin

Sekarang, buat database cermin yang merupakan target data yang direplikasi. Untuk informasi selengkapnya, lihat Apa yang diharapkan dari pencerminan.

  1. Navigasikan ke beranda portal Fabric.

  2. Buka ruang kerja yang sudah ada atau buat ruang kerja baru.

  3. Di menu navigasi, pilih Buat.

  4. Pilih Buat, temukan bagian Gudang Data, lalu pilih Azure Cosmos DB Cermin (Pratinjau).

  5. Berikan nama untuk database cermin lalu pilih Buat.

Menyambungkan ke database sumber

Selanjutnya, sambungkan database sumber ke database cermin.

  1. Di bagian Koneksi baru, pilih Azure Cosmos DB untuk NoSQL.

  2. Berikan kredensial untuk akun Azure Cosmos DB for NoSQL termasuk item berikut:

    Nilai
    Titik akhir Azure Cosmos DB Titik akhir URL untuk akun sumber.
    Nama koneksi Nama unik untuk koneksi.
    Jenis autentikasi Pilih Kunci akun.
    Kunci Akun Kunci baca-tulis untuk akun sumber.

    Cuplikan layar dialog koneksi baru dengan kredensial untuk akun Azure Cosmos DB for NoSQL.

  3. Pilih Sambungkan. Kemudian, pilih database yang akan dicerminkan.

    Catatan

    Semua kontainer dalam database dicerminkan.

Mulai proses pencerminan

  1. Pilih Cerminkan database. Pencerminan sekarang dimulai.

  2. Tunggu dua hingga lima menit. Lalu, pilih Pantau replikasi untuk melihat status tindakan replikasi.

  3. Setelah beberapa menit, status harus berubah menjadi Berjalan, yang menunjukkan bahwa kontainer sedang disinkronkan.

    Tip

    Jika Anda tidak dapat menemukan kontainer dan status replikasi yang sesuai, tunggu beberapa detik lalu refresh panel. Dalam kasus yang jarang terjadi, Anda mungkin menerima pesan kesalahan sementara. Anda dapat mengabaikannya dengan aman dan terus menyegarkan.

  4. Saat pencerminan menyelesaikan penyalinan awal kontainer, tanggal muncul di kolom refresh terakhir. Jika data berhasil direplikasi, kolom total baris akan berisi jumlah item yang direplikasi.

Memantau Pencerminan Fabric

Sekarang setelah data Anda aktif dan berjalan, ada berbagai skenario analitik yang tersedia di semua Fabric.

  1. Setelah Fabric Mirroring dikonfigurasi, Anda secara otomatis dinavigasi ke panel Status Replikasi.

  2. Di sini, pantau status replikasi saat ini. Untuk informasi selengkapnya dan detail tentang status replikasi, lihat Replikasi Monitor Fabric Mirror.

Mengkueri database sumber dari Fabric

Gunakan portal Fabric untuk menjelajahi data yang sudah ada di akun Azure Cosmos DB Anda, mengkueri database Cosmos DB sumber Anda.

  1. Navigasikan ke database cermin di portal Fabric.

  2. Pilih Tampilkan, lalu Database sumber. Tindakan ini membuka penjelajah data Azure Cosmos DB dengan tampilan baca-saja dari database sumber.

    Cuplikan layar data explorer dengan tampilan baca-saja data NoSQL di akun Azure Cosmos DB.

  3. Pilih kontainer, lalu buka menu konteks dan pilih Kueri SQL baru.

  4. Jalankan kueri apa pun. Misalnya, gunakan SELECT COUNT(1) FROM container untuk menghitung jumlah item dalam kontainer.

    Catatan

    Semua bacaan pada database sumber dirutekan ke Azure dan akan menggunakan Unit Permintaan (RU) yang dialokasikan di akun.

Menganalisis database cermin target

Sekarang, gunakan T-SQL untuk mengkueri data NoSQL Anda yang sekarang disimpan di Fabric OneLake.

  1. Navigasikan ke database cermin di portal Fabric.

  2. Beralih dari Titik akhir analitik Mirrored Azure Cosmos DB ke SQL.

    Cuplikan layar pemilih untuk beralih antar item di portal Fabric.

  3. Setiap kontainer dalam database sumber harus diwakili di titik akhir analitik SQL sebagai tabel gudang.

  4. Pilih tabel apa pun, buka menu konteks, lalu pilih Kueri SQL Baru, dan akhirnya pilih Pilih 100 Teratas.

  5. Kueri menjalankan dan mengembalikan 100 rekaman dalam tabel yang dipilih.

  6. Buka menu konteks untuk tabel yang sama dan pilih Kueri SQL Baru. Tulis contoh kueri yang menggunakan agregat seperti SUM, , COUNTMIN, atau MAX. Gabungkan beberapa tabel di gudang untuk menjalankan kueri di beberapa kontainer.

    Catatan

    Misalnya, kueri ini akan dijalankan di beberapa kontainer:

    SELECT
        d.[product_category_name],
        t.[order_status],
        c.[customer_country],
        s.[seller_state],
        p.[payment_type],
        sum(o.[price]) as price,
        sum(o.[freight_value]) freight_value 
    FROM
        [dbo].[products] p 
    INNER JOIN
        [dbo].[OrdersDB_order_payments] p 
            on o.[order_id] = p.[order_id] 
    INNER JOIN
        [dbo].[OrdersDB_order_status] t 
            ON o.[order_id] = t.[order_id] 
    INNER JOIN
        [dbo].[OrdersDB_customers] c 
            on t.[customer_id] = c.[customer_id] 
    INNER JOIN
        [dbo].[OrdersDB_productdirectory] d 
            ON o.product_id = d.product_id 
    INNER JOIN
        [dbo].[OrdersDB_sellers] s 
            on o.seller_id = s.seller_id 
    GROUP BY
        d.[product_category_name],
        t.[order_status],
        c.[customer_country],
        s.[seller_state],
        p.[payment_type]
    

    Contoh ini mengasumsikan nama tabel dan kolom Anda. Gunakan tabel dan kolom Anda sendiri saat menulis kueri SQL Anda.

  7. Pilih kueri lalu pilih Simpan sebagai tampilan. Beri tampilan nama yang unik. Anda dapat mengakses tampilan ini kapan saja dari portal Fabric.

  8. Kembali ke database cermin di portal Fabric.

  9. Pilih Kueri visual baru. Gunakan editor kueri untuk membangun kueri yang kompleks.

    Cuplikan layar editor kueri untuk kueri berbasis teks dan visual di Fabric.

Membuat laporan BI pada kueri atau tampilan SQL

  1. Pilih kueri atau tampilan lalu pilih Jelajahi data ini (pratinjau). Tindakan ini menjelajahi kueri di Power BI secara langsung menggunakan Data cermin Direct Lake di OneLake.
  2. Edit bagan sesuai kebutuhan dan simpan laporan.

Tip

Anda juga dapat secara opsional menggunakan Copilot atau penyempurnaan lainnya untuk membangun dasbor dan laporan tanpa pergerakan data lebih lanjut.

Contoh lainnya

Pelajari selengkapnya tentang cara mengakses dan mengkueri data Azure Cosmos DB yang dicerminkan di Fabric: