Kumaş Kullanıcı veri işlevleri öğesi oluşturma

Bu kılavuzda yeni bir Kullanıcı Verileri İşlevleri öğesi oluşturacak ve içinde yeni işlevler yazacağız. Her Kullanıcı Veri İşlevleri öğesi, tek tek çalıştırabileceğiniz bir veya birden çok işlevi tanımlayan kod içerir.

Özellikle şunların nasıl yapılacağını öğrenirsiniz:

• Kullanıcı verileri işlevleri öğesi oluşturun.
• Yeni bir işlev yazın.
• İşlevleri yönetme.
• İşlevinizi çalıştırın.

Önkoşullar

• Desteklenen bölgelerden birinde bulunan bir Microsoft Fabric kapasitesi. Kapasiteniz yoksa, ücretsiz deneme kapasitesi oluşturabilirsiniz.
• Bu kapasiteye bağlı bir Fabric Çalışma Alanı

Yeni İskelet Kullanıcı Verileri Fonksiyonları öğesi oluşturma

1. Çalışma alanınızı seçin ve + Yeni öğe seçeneğini belirleyin.
2. Öğe türü olarak Tüm öğeler'i seçin. Kullanıcı veri fonksiyonlarını arayın ve seçin.

Yeni kullanıcı verileri işlevleri öğesi oluşturma

1. Çalışma alanınızda + Yeni öğe seçin.

2. Açılan bölmede user data functions aramasını açın ve kutucuğu seçin.

   Yeni öğe bölmesindeki kullanıcı verisi işlevleri kutucuğunu gösteren ekran görüntüsü.

3. Kullanıcı verileri işlevleri öğesi için bir Ad sağlayın.

4. Python işlev şablonu oluşturmak hello_fabric için Yeni işlev'i seçin. İşlevler gezgini yayımlanan ve çağrılmaya hazır olan tüm işlevleri gösterir.

   

5. hello_fabric işlevi yayımlandıktan sonra, Fonksiyonlar gezginindeki işlev listesinden çalıştırabilirsiniz.

   hello-fabric işlevinin kodunu gösteren ekran görüntüsü.

Örnekten yeni işlev ekleme

Bu, menüden yeni bir işlevin nasıl ekleneceğini gösteren bir örnektir Insert sample . Bu durumda, pandas kütüphanesi ile veri işleme adlı bir fonksiyon ekleyeceğiz ki bu fonksiyonun gereksinimi olarak kütüphanesini kullanır. Bu örnek işlevi eklemek için adımları izleyin:

1. Geliştirme modunda olduğunuzdan emin olun. Kitaplık yönetimi'ni seçerek işlevinizin gerektirdiği kitaplıkları ekleyin.

   

   Uyarı

   fabric_user_data_functions kitaplığı varsayılan olarak eklenir ve kaldırılamaz. Bu kitaplık, Kullanıcı verileri işlevlerinin işlevselliği için gereklidir. Bu SDK'nın gelecekteki sürümleri için bu kitaplığın sürümünü güncelleştirmeniz gerekir.

2. pandas kütüphanesini seçin ve sürümü seçin. Kitaplık eklendikten sonra otomatik olarak Kullanıcı Verileri İşlevleri öğenize kaydedilir.

   pandas kütüphanesinin nasıl ekleneceğini gösteren ekran görüntüsü.

3. Örnek ekleyi seçin ve Pandas kütüphanesi ile verileri işleyi seçin. Bu eylem, kodunuzun en altına diğer işlevlerin arkasına örnek kod ekler.

   pandas kütüphanesini kullanan bir örneğin nasıl ekleneceğini gösteren ekran görüntüsü.

4. Örnek düzenleyiciye eklendikten sonra Geliştirme modunda Test özelliğini kullanarak test edebilirsiniz.

5. Hazır olduğunuzda, değişikliklerinizi kaydetmek ve işlevlerinizi güncelleştirmek için Yayımla'yı seçebilirsiniz. Yayımlama birkaç dakika sürebilir.

   

6. Yayımlama tamamlandıktan sonra yeni işlevi İşlevler gezgini listesinde görürsünüz. Bu işlev artık portaldan çalıştırılmaya veya başka bir uygulamadan ya da Fabric öğesinden, örneğin bir işlem hattından çağrılmaya hazır.

   

İşlevinizi çalıştırma

1. İşlevinizi çalıştırmak için önce mod değiştiriciye tıklayarak Yalnızca çalıştır moduna geçmeniz gerekir.

   

2. İşlevler gezgini listesinde bir işlevin üzerine geldiğinizde görüntülenen çalıştır simgesini seçin.

   

3. İşlevler gezgininde form olarak sunulan gerekli parametreleri girin. Bu durumda, parametre olarak bir JSON dizesi gerektiren manipulate_data işlevini çalıştıracağız.

   [
    {
     "Name": "John",
     "Age": 22,
     "Gender": "male"
    }
   ]
   

4. İşlevi çalıştırmak için Çalıştır'ı seçin.

   İşlev başarıyla yürütüldüğünde, çıkışı gösteren ekran görüntüsü.

5. İşlevin başarıyla çalıştırılıp çalıştırılamadığını doğrulamak için canlı günlükleri ve çıkışı görebilirsiniz. Alternatif olarak, işlev çağrınıza ait bir hata iletisi ve günlükler görürsünüz.

Yeni işlev yazma

Çalıştırılabilir her işlev, işlev tanımından önce bir @udf.function() dekoratörüyle başlar. Python Programlama modelimiz hakkında daha fazla bilgi edinin. Yeni bir işlev yazmak için, onu çalıştırılabilir bir işlev olarak tanımlamak üzere başındaki dekoratör @udf.function() kullanın. Aşağıda örnek bir işlev verilmişti:

# This sample allows you to pass a credit card number as an integer and mask it, leaving the last 4 digits. 

@udf.function()
def maskCreditCard(cardNumber: int)-> str:
    # Convert the card number to a string
    cardNumberStr = str(cardNumber)
    
    # Check if the card number is valid
    if not cardNumberStr.isdigit() or not (13 <= len(cardNumberStr) <= 19):
        raise ValueError("Invalid credit card number")
    
    # Mask all but the last four digits
    maskedNumber = '*' * (len(cardNumberStr) - 4) + cardNumberStr[-4:]
    
    return str(maskedNumber)

İşlev hazır olduğunda, çalıştırmak için işlevi yayımlayın.

Programlama modeli temel kavramları

Kullanıcı Verileri İşlevleriniz, tek tek işlevleri oluşturmak, çalıştırmak, hatalarını ayıklamak ve değiştirmek için Kullanıcı Verileri İşlevleri Python Programlama modelini kullanır. Bu, Fabric'deki işlevlerinizi çağırmak ve tümleştirmelerden yararlanmak için gereken işlevselliği sağlayan birinci taraf bir kitaplıktır.

İlk işlevinizi oluşturduktan sonra, kodun ilk satırlarında şablonunuzu çalıştırmak için gerekli kütüphaneleri içeren import ifadeleri yer alacaktır.

import datetime
import fabric.functions as fn
import logging

udf = fn.UserDataFunctions()

Uyarı

kitaplığını fabric.functions içeren içeri aktarma deyimi ve bu deyimi udf = fn.UserDataFunctions() içeren satır, işlevlerinizi düzgün çalıştırmak için gereklidir. Bu satırlar eksikse işlevleriniz düzgün çalışmaz .

• İşlevleri oluşturmak, çalıştırmak ve yönetmek için fabric.functions SDK'sı ve logging gibi bazı önemli kitaplıklara ihtiyacınız vardır; bu kitaplıklar, özel günlükler yazmanıza olanak tanır.
• #D0, kullanıcı veri işlevleri öğesi içinde işlevleri tanımlamak için kullanılan yapıdır.

Veri işlevlerini yönetme

İşlevi yeniden adlandırma

1. Geliştirme modunda kod düzenleyicisini seçin ve işlevin adını güncelleştirin. Örneğin, olarak hello_fabricyeniden adlandırınhello_fabric1:

   @udf.function()
   def hello_fabric1(name: str) -> str:
      logging.info('Python UDF trigger function processed a request.')
   
      return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"
   

2. Adı değiştirdikten sonra Yayımla'yı seçerek değişikliklerinizi kaydedin.

3. Değişiklikler yayımlandıktan sonra İşlevler gezgininde işlevin yeni adını görüntüleyebilirsiniz.

İşlevi silme

Bir işlevi silmek için kod düzenleyicisinde işlev kodunu seçin ve kod bölümünün tamamını kaldırın. Tamamen kullanıcı verileri işlevleri öğesinden silmek için değişiklikleri yayımlayın.

Örneğin, hello_fabric işlevini silmek için aşağıdaki kod bloğunu kaldırın:

@udf.function()
def hello_fabric(name: str) -> str:
    logging.info('Python UDF trigger function processed a request.')

    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

Kod kaldırıldıktan sonra değişikliklerinizi kaydetmek amacıyla Yayımla seçebilirsiniz. Yayımlama tamamlandıktan sonra İşlevler gezgininde kullanılabilir işlevlerin güncelleştirilmiş bir listesini görürsünüz.

Sonraki adımlar

• Visual Studio Code'da Fabric Kullanıcı veri fonksiyonları öğesi oluşturma
• Kullanıcı veri işlevleri programlama modeli hakkında bilgi edinin