.alter function-Befehl

Artikel
11/23/2024

Gilt für: ✅Microsoft Fabric ✅Azure Data Explorer

Ändert eine vorhandene Funktion und speichert sie in den Datenbankmetadaten. Regeln für Parametertypen und CSL-Anweisungen sind identisch mit let Anweisungen.

Berechtigungen

Sie müssen mindestens über Funktionsadministratorberechtigungen verfügen, um diesen Befehl auszuführen. Der Prinzipal, der die Funktion erstellt, wird automatisch zu einem Funktionsadministrator.

Syntax

.alterfunction [ propertyName = propertyValue [, ( with ...]] )functionName-Parametertext() { }

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
functionName	`string`	✔️	Der Name der zu ändernden Funktion.
propertyName, propertyValue	`string`		Eine durch Trennzeichen getrennte Liste von Schlüsselwert-Eigenschaftspaaren. Siehe unterstützte Eigenschaften.
parameters	`string`		Eine durch Trennzeichen getrennte Liste von Parametern, die von der Funktion benötigt werden. Das Format für jeden Parameter muss ParameterName`:`ParameterDataType sein.
body	`string`	✔️	Null oder mehr `let` Anweisungen gefolgt von einem gültigen CSL-Ausdruck, der bei Funktionsaufruf ausgewertet wird.

Hinweis

Wenn die Funktion nicht vorhanden ist, wird ein Fehler zurückgegeben. Informationen zum Erstellen einer neuen Funktion finden Sie unter .create function
Nicht alle Kusto-Typen werden in let Anweisungen unterstützt. Unterstützte Typen sind: string, long, datetime, timespan, and double.

Unterstützte Eigenschaften

Name	Typ	Beschreibung
`docstring`	`string`	Eine Beschreibung der Funktion für UI-Zwecke.
`folder`	`string`	Der Name eines Ordners, der für die Kategorisierung von UI-Funktionen verwendet wird.
`view`	`bool`	Legt diese Funktion als gespeicherte Ansicht fest. Gespeicherte Ansichten können an Such- und Union*-Szenarien teilnehmen. Weitere Informationen finden Sie unter Ansichten.
`skipvalidation`	`bool`	Bestimmt, ob Die Überprüfungslogik für die Funktion ausgeführt werden soll, und schlägt den Prozess fehl, wenn die Funktion ungültig ist. Der Standardwert ist `false`.

Beispiel

Im folgenden Beispiel wird die MyFunction2-Funktion mit einer Beschreibung (docstring), einem Ordner geändert und der MyLimit Parameter definiert.

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

Name	Parameter	Text	Ordner	DocString
MyFunction2	(myLimit: long)	{StormEvents \| take myLimit}	MyFolder	Demo-Funktion mit Parameter

Freigeben über