.create-or-alter function-Befehl

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

Erstellt eine gespeicherte Funktion oder ändert eine vorhandene Funktion und speichert sie in den Datenbankmetadaten.

Regeln für Parametertypen und CSL-Anweisungen sind identisch mit let-Anweisungen.

Berechtigungen

Dieser Befehl erfordert Datenbankbenutzerberechtigungen zum Erstellen einer neuen Funktion und Berechtigungen des Funktionsadministrators zum Ändern einer vorhandenen Funktion.

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
functionName	string	✔️	Der Name der funktion, die erstellt oder geändert werden soll.
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 mit dem angegebenen functionName nicht in den Datenbankmetadaten vorhanden ist, wird mit dem Befehl eine neue Funktion erstellt. Andernfalls wird diese Funktion geändert.

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 TestFunction-Funktion mit einer Beschreibung (docstring), einem Ordner erstellt und der MyLimit Parameter definiert.

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

Output

Name	Parameter	Text	Ordner	DocString
TestFunction	(myLimit:int)	{ StormEvents | take myLimit }	MyFolder	Demo-Funktion mit Parameter