Visual Studio Code'da Fabric Kullanıcı veri işlevleri öğesi oluşturma

Doku Kullanıcısı veri işlevleri, Doku yerel veri kaynaklarının üzerinde hızlı ve kolay bir şekilde uygulama geliştirmenizi sağlayan sunucusuz bir çözümdür. Bunun avantajları, Fabric'te sunucusuz bilgi işlemin artan esnekliği ve uygun maliyetliliğidir. Kullanıcı veri işlevleri, hizmet tarafından sağlanan bir uç noktaya HTTP istekleri olarak çağrılır ve Fabric-native veri kaynaklarınız üzerinde çalışır.

Bu hızlı başlangıçta, Visual Studio (VS) Code'da kullanıcı verileri işlevleri öğesi oluşturmayı öğreneceksiniz.

Önkoşullar

• Doku çalışma alanı
• Visual Studio Code
• Python
• Azure İşlevleri Çekirdek Araçları v4
• Microsoft Fabric uzantısı
• Kullanıcı verileri işlevleri uzantısı

Çalışma alanınızı seçin

1. VS Code'u açın ve Fabric'e oturum açın.

2. Fabric'de, çalışma alanınızı açın veya yeni bir çalışma alanı oluşturun.

3. + Yeni öğe seçeneklerini belirleyerek Yeni öğe panelini açın.

4. Yeni öğe bölmesinde, Veri geliştirin altında, Kullanıcı veri işlevleri öğe türünü seçin.

5. Yeni kullanıcı verileri işlevleri öğesi için bir ad sağlayın ve Oluştur seçeneğini tıklayın. Yeni kullanıcı verileri işlevleri öğesi oluşturulur.

6. Şeritte çalışma zamanı dili olarak Python'u seçin.

7. Bu kullanıcı verileri işlevleri öğesi için bir sanal ortam oluşturun.

8. Python çalışma zamanı sürümünü seçin. Kullanıcı verileri işlevleri için Python Sürüm 3.11 gerekir.

9. Klasör için sanal ortamı ayarlamak üzere Evet'i seçin.

10. Birden fazla işlev eklemek için function_app.py açın.

    

İlk işlevinizi yazma

İşlevin başlangıcını tanımlamak için dekoratörle @udf.function() bir kullanıcı veri işlevleri öğesi yazın. str, int, float gibi ilkel veri türleri gibi işlev için bir giriş geçirebilirsiniz. İşlevin içinde özel iş mantığınızı yazabilirsiniz.

İşte hello_fabric işlevine bir örnek.

@udf.function()
def hello_fabric(name: str) -> str:
    # Use logging to write custom logs to help trace and debug issues 
    logging.info('Python UDF trigger function processed a request.')
    logging.info('Executing hello fabric function.')
    
    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!" 

VS Code'da kullanıcı verileri işlevlerini yönetme

Şu anda açık olan çalışma alanının içindeki VS Code'daki Doku gezgininde kullanıcı verileri işlevleri öğesini görüntüleyebilirsiniz.

Düzenlemeye başlamak için Doku çalışma alanında bulunan tüm işlevler VS Code'daki Gezgin'de açılabilir. Açmak istediğiniz işlevi seçin ve ardından Explorer'da Aç'ı seçin. Kullanıcı verileri işlevleri öğesinde yazılan bağlantıları, kitaplıkları ve tüm işlevleri görebilirsiniz.

Bağlantıları ve kitaplıkları yönetme

• Bağlantılar: Kullanıcı verileri işleviniz için eklenen tüm veri bağlantıları Doku gezgininden görüntülenebilir. Sağ tıklayın ve Fabric'de bağlantıları yönet seçeneğini, kullanıcı veri işlevleri öğeleri için seçin.

• Kitaplıklar: Kullanıcı verileri işlevleri öğeniz için eklenen tüm kitaplıklar Doku gezgininden görüntülenebilir. Sağ tıklayıp Fabric'te kitaplıkları yönet'i seçerek kullanıcı veri fonksiyonları için yeni kitaplıklar ekleyin.

• İşlevler: Yayımlanan tüm işlevleri burada görüntüleyebilirsiniz. Bir işlev seçin ve şu eylemleri gerçekleştirin:

  • Çalıştırın ve test edin ile API test araçlarını kullanmak zorunda kalmadan VS Code'da işlevi test edin.
  • Bu işlev dış uygulamadan genel olarak erişilebilir durumdaysa genel URL'yi kopyalayın.

Kullanıcı verileri işlevlerinizi yönetmek için yerel klasör

VS Code gezgininde açılan kullanıcı verileri işlevleri öğesi Yerel klasör görünümünde görünür. Yerel klasör, kullanıcı verileri işlev öğesinde yapılan yerel değişiklikleri test etmenizi ve görmenizi sağlar.

• İşlevler: Yerel function_app.py dosyanızdaki tüm işlevleri görüntüleyebilirsiniz. Örnekle başlamak için İşlevler'e sağ tıklayın ve örnek işlev eklemek için İşlev ekle'yi seçin.

  

  İşlevinizi yerel olarak test etmek için F5 tuşuna basarak hata ayıklamayı başlatın. Ayrıca işlevi seçip Çalıştır ve hata ayıklama seçeneğini belirleyebilirsiniz.

• Yerel işlev için bağlantıları ve kitaplıkları görüntüle: Yerel ortamınızdaki local.settings.json içindeki tüm bağlantıları ve requirements.txt dosyasındaki kitaplıkları görüntüleyebilirsiniz.

  • Yerel ortamınızdaki geçerli bağlantı listesini göstermek için local.settings ayarlarından bağlantıları eşitleyin.
  • Yerel ortamınızdaki geçerli kitaplık listesini göstermek için requirements.txt dosyasını senkronize edin.

Kullanıcı verileri işlevini yayımlama

Değişikliklerinizi test ettikten sonra kullanıcı verileri işlevini Doku'da yayımlayın. Değişiklikleri yayımlamak birkaç dakika sürebilir.

Yerel geliştirme için değişikliklerinizi veya yeni eklenen işlevlerinizi bir kullanıcı verisi işlevleri öğesinde nasıl yayımlayacağınızı gösteren ekran görüntüsü.

Kesme noktalarıyla yerel hata ayıklama

Fabric işlevlerinizi hata ayıklamak için F5 seçin. Kodunuzun herhangi bir yerine kesme noktası ekleyebilirsiniz. Hata ayıklama modunda kesme noktalarınız beklendiği gibi çalışır ve uygulamaya alınmış bir işlevi test eder gibi kodunuzu test edersiniz.

Ekran görüntüsü, kesme noktaları ile yerel olarak nasıl hata ayıklanacağını gösteriyor.

Sonraki adımlar

• Kullanıcı veri işlevleri programlama modeli hakkında bilgi edinin
• Eğitici Kılavuz: Bir Python uygulamasından kullanıcı verisi fonksiyonlarını çağırma