Příkaz .alter function

Článek
11/23/2024

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Změní existující funkci a uloží ji do metadat databáze. Pravidla pro typy parametrů a příkazy CSL jsou stejná jako pro let příkazy.

Oprávnění

Ke spuštění tohoto příkazu musíte mít alespoň oprávnění správce funkce. Objekt zabezpečení, který funkci vytvoří, se automaticky vytvoří jako správce funkce.

Syntaxe

.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á 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 neexistuje, vrátí se chyba. Informace o vytvoření nové funkce najdete v tématu .create function
Příkazy nepodporují let všechny typy Kusto. Podporované typy jsou: řetězec, dlouhý, datum a čas, časový rozsah a double.

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 upraví funkci MyFunction2 popisem (docstring), složkou a definuje MyLimit parametr.

.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
MyFunction2(myLimit: long)  
{StormEvents | take myLimit}

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

Sdílet prostřednictvím