Azure Confidential Ledger'da sunucu tarafı programlama

Azure gizli defteri, defter içinde özel mantık çalıştırmak için sunucu tarafı programlama özellikleri sağlar. Bu özellikleri kullanarak, gizli bir ortamda çalışan ve kayıt defterinin verileriyle etkileşim kuran özel kodlar yazarak kayıt defterinin işlevselliğini genişletebilirsiniz.

Farklı özelleştirme düzeyleriyle çeşitli işlemler gerçekleştirmek için kullanıcı tanımlı işlevler (UDF) ve kullanıcı tanımlı uç noktalar (UDE) oluşturabilirsiniz. UDF'ler ve UDE'ler daha önce sırasıyla basit kullanıcı tanımlı işlevler ve gelişmiş kullanıcı tanımlı işlevler olarak adlandırılıyordu. UDF'leri ve UDE'leri tanımladıktan sonra, bunları Azure gizli kayıt defteri istemcilerinden çağırarak doğrudan kayıt defteri altyapısının içinde çalıştırabilirsiniz.

UDF'ler ve UDE'ler

Azure Confidential Ledger iki sunucu tarafı programlama özelliği sunar:

  • Kullanıcı tanımlı işlevler (UDF'ler): UDF'ler, kayıt defterinde tanımladığınız ve yürüttüğünüz basit özel işlevlerdir. Bunlar, JavaScript API’si kullanarak basit işlemler gerçekleştirmenize olanak sağlar ve mevcut kayıt defteri yazma API'siyle tümleştirilebilir. Daha fazla bilgi için bkz. Gizli Azure kayıt defterinde kullanıcı tanımlı işlevler.

  • Kullanıcı tanımlı uç noktalar (UDE'ler): UDE'ler, bir kayıt defteri uygulamasında tanımladığınız ve erişime açtığınız özel uç noktalardır. Özelleştirilebilir parametreler, veri biçimleri ve kimlik doğrulama mekanizmalarıyla daha gelişmiş API'leri kullanıma açmak için bu uç noktaları kullanın. Daha fazla bilgi için bkz. Azure gizli kayıt defterindeki kullanıcı tanımlı uç noktalar.

UDF'ler ve UDE'ler için ana özelliklerin ve yeteneklerin karşılaştırması aşağıdadır:

Kapasite UDFs UDEs
Ö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

UDF'ler ve UDE'ler arasında geçiş yapma

UDF'ler ve UDE'ler birbirini dışlayan özelliklerdir. UDE'ler tanımlıysa UDF'leri oluşturamaz veya çalıştıramazsınız, bunun tersi de geçerlidir. İki özellik arasında geçiş yapmak için aşağıdaki adımları kullanın.

Önemli

UDF'ler ve UDE'ler arasında geçiş yapmak yıkıcı bir işlemdir. Diğer özelliğe geçilirken tüm mevcut UDF'ler veya UDE'ler silinir. Devam etmeden önce önemli verileri yedekleyin.

UDF'lerden UDE'lere

UDF'lerden UDE'lere geçmek için mevcut tüm UDF'leri silin:

  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.

UDE'lerden UDF'lere

UDE'lerden UDF'lere geçmek için, boş modüller ve uç nokta tanımları ile UDE'ler tanımlayın.

  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 Confidential Ledger’da sunucu tarafı programlamaya başlamak için aşağıdaki makalelere bakın: