SQL Uç Noktası etkinliğini yenileme

Microsoft Fabric işlem hatlarındaki SQL Uç Noktasını Yenile etkinliği, yönetilen bir iş akışının parçası olarak bir Lakehouse SQL uç noktasını program aracılığıyla yenilemenizi sağlar. İşlem hatları için Lakehouse Utility Suite'in bir parçasıdır ve genellikle Lakehouse Bakım etkinliğinden sonra (örneğin, OPTIMIZE veya VACUUM işlemlerinden sonra) kullanılır. Power BI raporları, not defterleri veya dış SQL istemcileri gibi son kullanıcılar, veri hazırlama veya bakım adımları tamamlandıktan sonra en son verileri görürler.

SQL uç noktalarının el ile yapılan yenilemelere veya geçici işlemlere bağlı kalmadan son güncelleştirmeleri hemen yansıtmasını sağlamak için bu etkinliği kullanın. İşlem hattınız şu durumlarda bu etkinliği kullanın:

  • Lakehouse verilerini güncelleştirir veya korur (örneğin, Kopyalama İşleri, Not Defteri yürütme veya Lakehouse bakım etkinliklerinden sonra).
  • Lakehouse SQL uç noktasının en son meta verileri ve veri değişikliklerini yansıtmasını gerektirir.
  • Raporlama, analiz veya dışarı aktarma gibi aşağı akış adımlarından önce belirlenici yenileme zamanlaması gerekir.

Önkoşullar

Bu etkinliği kullanmadan önce şunları yaptığınızdan emin olun:

Kullanıcı arabiriminde işlem hattınıza SQL Uç Noktasını Yenileme etkinliği ekleme

  1. Çalışma alanınızda yeni bir işlem hattı oluşturun.  

  2. İşlem hattı Etkinlikleri bölmesinde SQL Uç Noktasını Yenile'yi arayın ve bunu seçerek işlem hattı tuvaline ekleyin.  

    Etkinlikler bölmesindeki SQL Uç Noktasını Yenile etkinliğinin ekran görüntüsü.

  3. Henüz seçili değilse tuvalde yeni SQL Uç Noktasını Yenile etkinliğini seçin.  

    İşlem hattı tuvalinde SQL Uç Noktasını Yenile etkinliğinin ekran görüntüsü.

    İpucu

    Bakım ve yenilemenin sırayla çalıştırılması için bu etkinliği, Lakehouse Bakım etkinliği gibi diğer Lakehouse Utility Suite etkinlikleriyle birlikte aynı işlem hattında düzenleyebilirsiniz.

  4. Genel ayarlar sekmesini yapılandırmak için Genel ayarları kılavuzuna bakın.

SQL Uç Noktası etkinlik ayarlarını yenileme

  1. Etkinliği yapılandırmak için Ayarlar sekmesini seçin.  

  2. Bağlantı açılan listesinden mevcut bir bağlantıyı seçerek veya yeni bir bağlantı oluşturarak ve yapılandırma ayrıntılarını belirterek bağlantıyı yapılandırın.

  3. Lakehouse'un bulunduğu Çalışma Alanını belirtin.

  4. Yenilemek istediğiniz Lakehouse için SQL Uç Noktasını belirtin. Yenileme, Lakehouse SQL uç noktası meta verilerini güncelleştirerek son verileri ve şema değişikliklerini yansıtmasını sağlar.

    SQL Uç Noktasını Yenile etkinlik ayarlarının ekran görüntüsü.

Etkinlik davranışı

Etkinlik çalıştırması tamamlandığında:

  • Çıktı açılır penceresinde Başarı durumu gösterildiyse istek eşitlenmemiş verileri başarıyla eşitler.

    Etkinlik Çıktısı açılır penceresindeki Başarı durumunun ekran görüntüsü.

  • Çıkış açılır penceresindeki NotRun durumu, SQL uç noktasının yenilenmesinin çalışmadığı anlamına gelir. Bu koşul genellikle son eşitlemeden sonra yeni veri eklemediğiniz anlamına gelir, bu nedenle çalıştırmanız gerekmez.

    Etkinlik Çıktısı açılır penceresinde Çalışmadı durumunun ekran görüntüsü.

  • Çıkış penceresinde Başarısızlık durumu gösterildiyse, bir şey ters gitti.

Uyarı

Etkinlik çalıştırması, Çıkış açılır penceresinde bu durumları ayarlar. Bu durumları etkinlik durumunun kendisiyle karıştırmayın.

Yaygın senaryolar

  • Not defteri dönüştürülen verileri Bir Lakehouse'a yazdıktan sonra SQL uç noktasını yenileme.
  • Lakehouse Bakım etkinliği (OPTIMIZE veya VACUUM) tamamlandıktan sonra SQL uç noktası yenilemesini tetikleyin.
  • Raporların ve panoların bir işlem hattındaki iyi tanımlanmış noktalarda en son Lakehouse durumunu sorgulamasını sağlama.

Temel alınan veriler kilitliyken SQL Uç Nokta Yenilemem neden başarısız oluyor?

Diğer işlemler temel alınan Lakehouse verilerini etkin bir şekilde güncelleştirdiğinde SQL Uç Noktasını Yenile etkinliği zaman zaman başarısız olabilir. Bu işlemler alım işlem hatlarını, not defterlerini veya eşzamanlı yazma işlemlerini içerir.

Bu hatanın nedeni SQL Uç Noktasının yenilemeyi tamamlamak için iç kilitler alması gerektiğidir. Başka bir işlem verileri kilitlerse, istek zaman aşımına uğradı veya bir hata döndürüyor.

Bu davranış, SQL Uç Noktalarının meta veri yenileme işlemlerini nasıl yönettiğine bağlı olarak beklenir.

Symptoms

  • Etkinlik sürekli değil aralıklı olarak başarısız olur.
  • Hata iletileri yenileme çakışmalarını veya kilit çekişmelerini gösterir.
  • Birden çok sıralı Yenileme SQL Uç Noktası etkinliği olan işlem hatları daha yüksek hata oranları gösterir.

Kök neden

SQL Uç Noktaları, yenileme sırasında belirli meta veri yapılarına özel erişim gerektirir. Lakehouse'a aynı anda başka bir işlem işlemi yazarsa kilit çekişmesi oluşur.

Bu davranış, SQL Uç Noktasını Yenile etkinliğindeki bir hata değildir. Temel alınan verilerde eşzamanlı okuma ve yazma işlemlerinin doğal bir sonucudur.

Geçici Çözümler

İki pratik yaklaşım bu sorunu hafifletebilir:

İşlemin Sonunda Yalnızca Bir Yenileme SQL Uç Noktası Etkinliği Kullanın.

Kilit çakışması olasılığını azaltmak için boru hattınızı konsolide edin:

  • İlk olarak tüm alma, dönüştürme ve güncelleştirme etkinlikleri çalıştırılır,
  • Ardından, sonunda yalnızca bir SQL Uç Noktasını Yenileme etkinliği yürütülür.
  • Bu yaklaşım hataları tamamen ortadan kaldırmaz, ancak bunların oluşma sıklığını büyük ölçüde azaltır.

Yinelenen Yenileme Zamanlaması Belirleme

Senaryonuz belirli bir anda katı işlem tutarlılığı gerektirmiyorsa, yinelenen yenileme desenini benimseyin:

  • Sürekli olarak 15 dakikada bir yenileme zamanlayın. Bazı yenileme girişimleri kilitleme nedeniyle başarısız olabilir, ancak SQL Endpoint'inizi nispeten güncel tutmak için yeterince başarılı olur.

Yinelenen SQL Uç Noktasını Yenile zamanlaması yapılandırmasının ekran görüntüsü.

Bu yaklaşım, birçok analiz iş yükü için pratik ve sağlamdır.

İşlem hattını kaydet ve çalıştır veya zamanlamayı ayarla

İşlem hattı düzenleyicisinin üst kısmındaki Giriş sekmesine geçin ve işlem hattınızı kaydetmek için kaydet düğmesini seçin. Doğrudan çalıştırmak için Çalıştır'ı veya belirli zamanlarda veya aralıklarda çalıştırmaları zamanlamak için Zamanla'yı seçin. İşlem hattı çalıştırmaları hakkında daha fazla bilgi için bkz. İşlem hattı çalıştırmalarını zamanlama.

İşlem hattı düzenleyicisinde Sekme adı, Kaydet, Çalıştır ve Zamanlama düğmeleri vurgulanmış şekilde Giriş sekmesini gösteren ekran görüntüsü.

Çalıştırdıktan sonra, tuvalin altındaki Çıkış sekmesinden işlem hattı yürütmesini izleyebilir ve çalıştırma geçmişini görüntüleyebilirsiniz.

Bilinen sorunlar