Sinkronisasi metadata titik akhir analitik SQL

Artikel ini menjelaskan apa itu titik akhir analitik SQL, bagaimana titik akhir tersebut tetap sinkron dengan lakehouse Anda, dan kontrol yang Anda miliki untuk mengelola sinkronisasi tersebut. Titik akhir analitik SQL secara otomatis mendeteksi perubahan dan memperbarui metadata SQL-nya melalui proses latar belakang. Anda juga dapat menyegarkan metadata endpoint analitik SQL secara manual melalui portal Fabric, REST API, atau prosedur tersimpan T-SQL.

Proses latar belakang sinkronisasi metadata membaca log Delta dari /Tables folder di OneLake dan menjaga skema SQL tetap terbarui.

Fabric secara otomatis menjaga endpoint analitik SQL tetap sinkron dengan lakehouse yang mendasarinya. Tidak ada infrastruktur untuk disiapkan dan, dalam kebanyakan kasus, tidak ada tindakan pengguna yang diperlukan. Platform ini bertanggung jawab untuk:

  • Deteksi tabel - mendeteksi tabel Delta yang baru dibuat atau dihapus di lakehouse, serta membuat atau menghapus tabel SQL yang sesuai di endpoint.
  • Kebaruan data - mendeteksi perubahan (penyisipan, pembaruan, penghapusan) yang dilakukan pada data di tabel yang sudah ada dan memastikan kueri mengembalikan hasil yang mutakhir.
  • Deteksi perubahan skema - mendeteksi penambahan kolom, penghapusan, atau perubahan jenis dalam tabel Delta yang ada dan menyegarkan definisi tabel SQL yang sesuai.

Untuk detail tentang cara kerja sinkronisasi ini dan faktor-faktor yang memengaruhi latensi sinkronisasi, lihat Pertimbangan performa titik akhir analitik SQL.

Deteksi perubahan skema dan sinkronisasi metadata

Setiap lakehouse, gudang, database, dan database mirrored di Fabric secara otomatis disediakan dengan endpoint analitik SQL sendiri, sehingga Anda dapat melakukan query tabel Delta dengan T-SQL dan protokol TDS, tanpa memindahkan atau menyalin data.

  • Setiap lakehouse, gudang, database, dan database mirrored memiliki tepat satu endpoint SQL analytics.
  • Setiap tabel Delta dalam item yang mendasar secara otomatis muncul sebagai tabel SQL di titik akhir.
  • Titik akhir bersifat baca-saja melalui tabel yang dibuat secara otomatis. Anda dapat memperluas model dengan skema, tampilan, prosedur tersimpan, dan fungsi SQL Anda sendiri.
  • Titik akhir didukung oleh mesin komputasi yang sama dengan Fabric Data Warehouse, sehingga menyediakan kueri SQL berkinerja tinggi dan latensi rendah terhadap file Delta terbuka.

Sinkronisasi metadata baru (pratinjau)

Important

Fitur ini sedang dalam tahap pratinjau.

Pada Mei 2026, sinkronisasi metadata baru untuk titik akhir analitik SQL diumumkan sebagai fitur pratinjau. Anda dapat mengaktifkan proses sinkronisasi metadata baru, yang hanya berlaku untuk titik akhir analitik SQL baru. Opsi sinkronisasi metadata baru berfungsi menjaga data tetap tersedia untuk dikueri dalam hitungan detik setelah data masuk ke lakehouse.

Proses sinkronisasi metadata baru mencakup fitur-fitur berikut:

  • Arsitektur berbasis tabel eksternal baru untuk mengurai log Delta dan membuat katalog.
  • Arsitektur yang dipisahkan yang mendeteksi perubahan skema dan data secara terpisah serta memperbarui katalog sesuai dengan perubahan tersebut.
  • Penyegaran latar belakang yang memeriksa pembaruan data secara berkala.
  • Penyegaran data sesuai permintaan ketika ada kueri baca yang masuk dan sistem mendeteksi bahwa data sudah tidak mutakhir.

Mengaktifkan sinkronisasi metadata baru

Anda dapat mengaktifkan sinkronisasi metadata baru di ruang kerja dengan masuk ke Pengaturan gudang di bawah Pengaturan ruang kerja.

Tangkapan layar dari portal Fabric, halaman pengaturan workspace, menampilkan opsi sinkronisasi metadata baru di gudang dan panel Sinkronisasi metadata baru (pratinjau).

Saat Anda mengaktifkan sinkronisasi metadata baru, titik akhir analitik SQL baru di ruang kerja disinkronkan lebih cepat saat menyegarkan perubahan dari tabel yang mendasar. Saat ini, titik akhir analitik SQL yang ada di ruang kerja tersebut tetap berada pada versi lama sinkronisasi metadata.

Temukan kapan metadata terakhir diperbarui

Jika Anda menggunakan versi baru sinkronisasi metadata, Anda dapat menggunakan tampilan manajemen dinamis (DMV) untuk mendapatkan detail tentang pembaruan terbaru ke titik akhir analitik SQL. sys.dm_db_external_tables_log_status Gunakan DMV untuk mendapatkan detail tentang sinkronisasi metadata terbaru:

  • last_update_time_utc: Tanda waktu untuk terakhir kalinya tabel diperbarui dengan data baru.
  • latest_log_version: Versi log transaksi Delta tertinggi dari tabel yang diperbarui.
  • latest_checkpoint_version: Versi titik pemeriksaan Delta terbaru yang diproses.
  • is_blocked: Menunjukkan apakah upaya terakhir pada pembaruan tabel diblokir (1) atau berhasil (0).

Untuk informasi selengkapnya, lihat sys.dm_db_external_tables_log_status.

Batasan sinkronisasi metadata baru

  • Sinkronisasi metadata baru tidak mendukung checkpoint multi-part, fitur delta yang sudah tidak digunakan lagi. Jika tabel lakehouse Anda berisi titik pemeriksaan multi-bagian, tabel tersebut akan gagal diperbarui dalam sinkronisasi metadata baru.
  • Jika ruang kerja Anda menggunakan tautan privat ruang kerja, saat ini sinkronisasi metadata baru tidak dapat diaktifkan.

Pembaruan manual

Selain proses latar belakang yang memperbarui data secara otomatis, Anda dapat me-refresh metadata secara manual:

  • Refresh dari portal: Di editor titik akhir analitik SQL portal Fabric, pilih ikon Refresh di toolbar Explorer untuk memaksa sinkronisasi metadata sesuai permintaan. Buka Kueri titik akhir analitik SQL Anda, dan cari tombol refresh di toolbar.

    Cuplikan layar dari portal Fabric memperlihatkan tombol skema Refresh titik akhir analitik SQL.

  • Segarkan dengan REST API: Gunakan REST API untuk menyegarkan metadata titik akhir SQL guna menyegarkan metadata titik akhir analitik SQL secara terprogram.

  • Refresh melalui prosedur tersimpan: Gunakan prosedur tersimpan sistem sys.sp_dw_refresh_ext_table untuk menyegarkan data untuk tabel tertentu dalam titik akhir analitik SQL. Metode T-SQL ini hanya tersedia jika titik akhir analitik SQL dibuat setelah mengaktifkan Sinkronisasi metadata baru (pratinjau). Contohnya:

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";

Gunakan API hanya jika Anda memiliki perubahan skema, seperti menambahkan atau menghapus tabel atau kolom, atau mengubah jenis kolom, dan perlu me-refresh seluruh item. Untuk perubahan data saja di titik akhir analitik SQL, gunakan sys.sp_dw_refresh_ext_table prosedur tersimpan sistem untuk memperbarui tabel tertentu.

Untuk menyetel tabel Delta yang mendasar untuk mendapatkan sinkronisasi metadata terbaik dan performa kueri, lihat Pertimbangan performa titik akhir analitik SQL.

Konten terkait

  • Last updated on