Udostępnij przez

Polecenie .alter function

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Zmienia istniejącą funkcję i przechowuje ją wewnątrz metadanych bazy danych. Reguły dla typów parametrów i instrukcji CSL są takie same jak w przypadku let instrukcji.

Uprawnienia

Aby uruchomić to polecenie, musisz mieć co najmniej uprawnienia administratora funkcji. Podmiot zabezpieczeń tworzący funkcję jest automatycznie tworzony jako administrator funkcji.

Składnia

.alterfunction [ with ( propertyName = propertyValue [, ...])] Treść parametrów) { functionName( }

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
functionName string ✔️ Nazwa funkcji do zmiany.
propertyName, propertyValue string Rozdzielona przecinkami lista par właściwości klucz-wartość. Zobacz obsługiwane właściwości.
parameters string Rozdzielana przecinkami lista parametrów wymaganych przez funkcję. Format dla każdego parametru musi mieć wartość ParameterName:ParameterDataType.
treść string ✔️ Co najmniej let zero instrukcji, po których następuje prawidłowe wyrażenie CSL, które jest oceniane przy wywołaniu funkcji.

Uwaga

  • Jeśli funkcja nie istnieje, zostanie zwrócony błąd. Aby utworzyć nową funkcję, zobacz .create function
  • Nie wszystkie typy kusto są obsługiwane w let instrukcjach. Obsługiwane typy to: ciąg, długi, data/godzina, przedział czasu i podwójne.

Obsługiwane właściwości

Nazwisko Pisz Opis
docstring string Opis funkcji dla celów interfejsu użytkownika.
folder string Nazwa folderu używanego do kategoryzacji funkcji interfejsu użytkownika.
view bool Wyznacza tę funkcję jako przechowywany widok. Przechowywane widoki mogą uczestniczyć w scenariuszach wyszukiwania i unii * . Aby uzyskać więcej informacji, zobacz Widoki.
skipvalidation bool Określa, czy należy uruchomić logikę walidacji w funkcji i zakończy się niepowodzeniem procesu, jeśli funkcja nie jest prawidłowa. Wartość domyślna to false.

Przykład

Poniższy przykład modyfikuje funkcję MyFunction2 z opisem (docstring), folderem i definiuje MyLimit parametr .

.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
MyFunction2(myLimit: long)  
{StormEvents | take myLimit}
Nazwisko Parametry Treść Folder DocString
MyFunction2 (myLimit: long) {StormEvents | take myLimit} Mójfolder Funkcja demonstracyjna z parametrem
  • Last updated on