Polecenie .create-or-alter function

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Tworzy przechowywaną funkcję lub 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 instrukcji let.

Uprawnienia

To polecenie wymaga uprawnień użytkownika bazy danych do tworzenia nowej funkcji i uprawnień administratora funkcji do zmiany istniejącej funkcji.

Składnia

.create-or-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 utworzenia lub 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 z podaną funkcją FunctionName nie istnieje w metadanych bazy danych, polecenie tworzy nową funkcję. W przeciwnym razie ta funkcja zostanie zmieniona.

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 tworzy funkcję TestFunction z opisem (docstring), folderem i definiuje MyLimit parametr .

.create-or-alter function with (docstring = 'Demo function with parameter', folder='MyFolder')
TestFunction(myLimit:int)
{ StormEvents | take myLimit} 

Wyjście

Nazwisko	Parametry	Treść	Folder	DocString
Funkcja testowa	(myLimit:int)	{ StormEvents | take myLimit }	Mójfolder	Funkcja demonstracyjna z parametrem