Příkaz .create-or-alter function

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Vytvoří uloženou funkci nebo změní existující funkci a uloží ji do metadat databáze.

Pravidla pro typy parametrů a příkazy CSL jsou stejná jako pro příkazy let.

Oprávnění

Tento příkaz vyžaduje oprávnění uživatele databáze k vytvoření nové funkce a oprávnění správce funkce ke změně existující funkce.

Syntaxe

.create-or-alterfunction [ with(propertyName = propertyValue [, ...])] text parametrů {) functionName ( }

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Type	Požadováno	Popis
functionName	string	✔️	Název funkce, která se má vytvořit nebo změnit.
propertyName, propertyValue	string		Čárkami oddělený seznam párů vlastností klíč-hodnota. Viz podporované vlastnosti.
parameters	string		Čárkami oddělený seznam parametrů vyžadovaných funkcí. Formát každého parametru musí být ParameterName:ParameterDataType.
tělo	string	✔️	Nula nebo více let příkazů následovaných platným výrazem CSL, který se vyhodnocuje při vyvolání funkce.

Poznámka:

Pokud funkce se zadaným názvem funkce v metadatech databáze neexistuje, příkaz vytvoří novou funkci. Jinak se tato funkce změní.

Podporované vlastnosti

Name	Typ	Popis
docstring	string	Popis funkce pro účely uživatelského rozhraní.
folder	string	Název složky používané pro kategorizaci funkcí uživatelského rozhraní.
view	bool	Určuje tuto funkci jako uložené zobrazení. Uložená zobrazení se můžou účastnit scénářů hledání a sjednocení * . Další informace naleznete v tématu Zobrazení.
skipvalidation	bool	Určuje, zda má funkce spustit logiku ověření a proces selže, pokud funkce není platná. Výchozí hodnota je false.

Příklad

Následující příklad vytvoří funkci TestFunction s popisem (docstring), složkou a definuje MyLimit parametr.

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

Výstup

Název	Parametry	Text	Složka	DocString
TestFunction	(myLimit:int)	{ StormEvents | take myLimit }	MyFolder	Demo funkce s parametrem