Udostępnij przez

Funkcje zdefiniowane przez użytkownika w poufnym rejestrze platformy Azure (wersja zapoznawcza)

Poufny rejestr platformy Azure udostępnia funkcje zdefiniowane przez użytkownika (UDF) do uruchamiania logiki niestandardowej wewnątrz rejestru. Ta funkcja umożliwia rozszerzenie funkcjonalności rejestru przez napisanie niestandardowego kodu, który można wykonać w środowisku poufnym i wchodzić w interakcje z danymi rejestru.

Nowe funkcje programowania umożliwiają użytkownikom tworzenie prostych funkcji zdefiniowanych przez użytkownika i zaawansowanych funkcji zdefiniowanych przez użytkownika w celu wykonywania różnych operacji na różnym poziomie dostosowywania. Po zdefiniowaniu UDF, można je wywoływać z klientów rejestru poufnego platformy Azure, aby wykonać je bezpośrednio wewnątrz silnika rejestru.

Ważne

Funkcje zdefiniowane przez użytkownika są obecnie dostępne w wersji zapoznawczej. Możesz zażądać dostępu do tej wersji zapoznawczej za pośrednictwem tego formularza rejestracji. Zapoznaj się z dodatkowymi warunkami użytkowania dla wersji zapoznawczych platformy Microsoft Azure , aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta, wersji zapoznawczej lub w inny sposób nie zostały jeszcze wydane w wersji ogólnodostępnej.

Proste i zaawansowane funkcje zdefiniowane przez użytkownika

Rejestr poufny platformy Azure oferuje dwa typy funkcji zdefiniowanej przez użytkownika:

  • Proste funkcje zdefiniowane przez użytkownika: proste funkcje zdefiniowane przez użytkownika to proste funkcje niestandardowe, które można zdefiniować i wykonać wewnątrz rejestru. Umożliwiają one wykonywanie prostych operacji przy użyciu interfejsu API języka JavaScript i można je zintegrować z istniejącym interfejsem API zapisu rejestru. Dowiedz się więcej na temat prostych funkcji użytkownika tutaj.

  • Zaawansowane UDF: Zaawansowane UDF to niestandardowe punkty końcowe, które można zdefiniować i uwidocznić w aplikacji rejestru. Te punkty końcowe mogą służyć do uwidaczniania bardziej zaawansowanych interfejsów API z dostosowywalnymi parametrami, formatami danych i mechanizmami uwierzytelniania. Dowiedz się więcej o zaawansowanych funkcjach zdefiniowanych przez użytkownika tutaj.

Poniżej przedstawiono porównanie głównych funkcji i możliwości prostych i zaawansowanych funkcji zdefiniowanych przez użytkownika:

Zdolność Proste funkcje zdefiniowane przez użytkownika Zaawansowane funkcje zdefiniowane przez użytkownika
Uruchamianie niestandardowej logiki biznesowej Tak Tak
Dostosowywanie argumentów/parametrów środowiska uruchomieniowego Tak Tak
Udostępnianie nowych interfejsów API/punktów końcowych Nie. Tak
Uruchamianie poszczególnych funkcji Tak Nie.
Uruchamianie punktów zaczepienia przed /po operacji zapisu wpisu rejestru Tak Nie.
Tworzenie i aktualizowanie kodu niestandardowego Tak (szczegółowa aktualizacja/usuwanie każdej funkcji) Tak (aktualizacja pakietu pojedynczej aplikacji dla wszystkich punktów końcowych)
Niestandardowe opcje środowiska uruchomieniowego języka JavaScript Tak (na każde wykonanie) Tak (globalnie)
Wykonywanie na węzłach zapasowych Nie. Tak
Obsługa wielu formatów danych dla danych wejściowych i wyjściowych Nie. Tak
Uwierzytelnianie niestandardowe i autoryzacja Nie. Tak
Scenariusze docelowe Wykonywanie niestandardowej prostej logiki oraz integracja z API księgi rachunkowej. Zaawansowane przypadki użycia wymagające niestandardowych interfejsów API i kontroli nad zaawansowanymi parametrami języka JavaScript

Przełączanie między prostymi i zaawansowanymi funkcjami użytkownika

Proste i zaawansowane funkcje zdefiniowane przez użytkownika są wzajemnie wykluczające się funkcje. Nie można tworzyć ani uruchamiać prostych UDF, jeśli zdefiniowano zaawansowane UDF, i odwrotnie. Można przełączać się między dwiema funkcjami, wykonując następujące kroki.

Ważne

Przełączanie się między prostymi i zaawansowanymi funkcjami zdefiniowanymi przez użytkownika jest operacją destrukcyjną. Wszystkie istniejące proste lub zaawansowane funkcje zdefiniowane przez użytkownika są usuwane podczas przełączania na inną funkcję. Przed kontynuowaniem wykonaj kopię zapasową wszystkich ważnych danych.

Od prostych do zaawansowanych funkcji zdefiniowanych przez użytkownika

Aby przełączyć się z prostych do zaawansowanych funkcji zdefiniowanych przez użytkownika, należy usunąć wszystkie istniejące funkcje zdefiniowane przez użytkownika:

  1. Lista wszystkich funkcji zdefiniowanych przez użytkownika, przechowywanych w rejestrze za pomocą GET /app/userDefinedFunctions API.

  2. Usuń każdy UDF, jeden po drugim przy użyciu interfejsu DELETE /app/userDefinedFunctions/{functionId} API.

Od zaawansowanych do prostych funkcji zdefiniowanych przez użytkownika

Aby przełączyć się z zaawansowanych do prostych funkcji zdefiniowanych przez użytkownika, należy zdefiniować zaawansowane funkcje zdefiniowane przez użytkownika z pustymi modułami i definicjami punktów końcowych.

  1. Utwórz nowy pakiet aplikacji z następującą strukturą:

    {
    "metadata": {
        "endpoints": {}
    }, 
   "modules": []
}

  2. Wdróż pakiet aplikacji z treścią żądania zdefiniowaną w kroku 1 przy użyciu interfejsu PUT /app/userDefinedEndpoints API.

Dalsze kroki

Zapoznaj się z następującymi artykułami, aby rozpocząć pracę z funkcjami zdefiniowanymi przez użytkownika w poufnym rejestrze platformy Azure:

Treści powiązane

  • Last updated on