Aracılığıyla paylaş


Azure gizli kayıt defterinde kullanıcı tanımlı işlevler (önizleme)

Azure gizli kayıt defteri, kayıt defterinde özel mantık çalıştırmak için kullanıcı tanımlı işlevler (UDF) sağlar. Bu özellik, gizli bir ortamda yürütülebilen ve kayıt defterinin verileriyle etkileşim kurabilen özel kodlar yazarak kayıt defterinin işlevselliğini genişletmenizi sağlar.

Yeni programlama özellikleri, kullanıcıların farklı bir özelleştirme düzeyiyle çeşitli işlemler gerçekleştirmek için basit UDF'ler ve gelişmiş UDF'ler oluşturmasına olanak sağlar. Tanımlandıktan sonra UDF'ler azure gizli kayıt defteri istemcilerinden çağrılarak doğrudan kayıt defteri altyapısının içinde yürütülebilir.

Önemli

Kullanıcı tanımlı işlevler şu anda ÖNİzLEME aşamasındadır. Bu önizleme için bu kayıt formu aracılığıyla erişim isteyebilirsiniz. Beta, önizleme aşamasında olan veya henüz genel kullanıma sunulmamış Azure özellikleri için geçerli olan yasal koşullar için Bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları .

Basit ve gelişmiş UDF'ler

Azure gizli kayıt defteri iki tür UDF özelliği sunar:

  • Basit UDF'ler: Basit UDF'ler, kayıt defterinde tanımlanıp yürütülebilen basit özel işlevlerdir. JavaScript API'sini kullanarak basit işlemler gerçekleştirmenize olanak sağlar ve mevcut kayıt defteri yazma API'siyle tümleştirilebilir. Basit UDF'ler hakkında daha fazla bilgiyi burada bulabilirsiniz.

  • Gelişmiş UDF'ler: Gelişmiş UDF'ler, bir kayıt defteri uygulamasında tanımlanıp kullanıma sunulan özel uç noktalardır. Bu uç noktalar, özelleştirilebilir parametreler, veri biçimleri ve kimlik doğrulama mekanizmalarıyla daha gelişmiş API'leri kullanıma açmak için kullanılabilir. Gelişmiş UDF'ler hakkında daha fazla bilgiyi burada bulabilirsiniz.

Basit ve gelişmiş UDF'lerin ana özelliklerinin ve özelliklerinin karşılaştırması aşağıdadır:

Kapasite Basit UDF'ler Gelişmiş UDF'ler
Özel iş mantığı çalıştırma Evet Evet
Çalışma zamanı bağımsız değişkenlerinin / parametrelerinin özelleştirmesi Evet Evet
Yeni API/uç noktaları kullanıma sunma Hayı Evet
Tek tek işlevleri çalıştırma Evet Hayı
Kayıt defteri girişi yazma işleminden önce/ sonra kancaları çalıştırma Evet Hayı
Özel kod oluşturma ve güncelleştirme Evet (her işlevin ayrıntılı güncelleştirmesi/silinmesi) Evet (tüm uç noktalar için tek uygulama paketi güncelleştirmesi)
Özel JavaScript çalışma zamanı seçenekleri Evet (her yürütme başına) Evet (genel olarak)
Yedek düğümlerde yürütme Hayı Evet
Giriş ve çıkış için birden çok veri biçimi destekleme Hayı Evet
Özel kimlik doğrulaması ve yetkilendirme Hayı Evet
Hedef senaryolar Basit özel mantığı yürütme ve kayıt defteri API'siyle tümleştirme Özel API'ler gerektiren gelişmiş kullanım örnekleri ve gelişmiş JavaScript parametreleri üzerinde denetim

Basit ve gelişmiş UDF'ler arasında geçiş yapma

Basit ve gelişmiş UDF'ler birbirini dışlayan özelliklerdir. Gelişmiş UDF'ler tanımlanmışsa basit UDF'ler oluşturamaz veya çalıştıramazsınız. Aşağıdaki adımları kullanarak iki özellik arasında geçiş yapabilirsiniz.

Önemli

Basit ve gelişmiş UDF'ler arasında geçiş yapmak yıkıcı bir işlemdir. Diğer özelliğe geçilirken mevcut tüm basit veya gelişmiş UDF'ler silinir. Devam etmeden önce önemli verileri yedeklediğinden emin olun.

Basitten gelişmiş UDF'lere

Basit UDF'lerden gelişmiş UDF'lere geçmek için mevcut tüm UDF'leri silmeniz gerekir:

  1. API'yi kullanarak kayıt defterinde depolanan tüm UDF'leri listeleyinGET /app/userDefinedFunctions.

  2. API'yi kullanarak her UDF'yiDELETE /app/userDefinedFunctions/{functionId} birer birer silin.

Gelişmişten basit UDF'lere

Gelişmiş UDF'lerden basit UDF'lere geçmek için, boş modüller ve uç nokta tanımlarıyla gelişmiş UDF'ler tanımlamanız gerekir.

  1. Aşağıdaki yapıya sahip yeni bir uygulama paketi oluşturun:

    {
        "metadata": {
            "endpoints": {}
        }, 
       "modules": []
    }
    
  2. Api'yi kullanarak 1. adımda tanımlanan istek gövdesiyle uygulama paketini dağıtınPUT /app/userDefinedEndpoints.

Sonraki Adımlar

Azure gizli kayıt defterindeki UDF özelliklerini kullanmaya başlamak için aşağıdaki makalelere bakın: