.alter function-Befehl

  • Artikel

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

Berechtigungen

Zum Ausführen dieses Befehls müssen Sie mindestens über die Berechtigungen "Function Admin" verfügen. Der Prinzipal, der die Funktion erstellt, wird automatisch zu einer Funktion Admin.

Syntax

.alterfunction [ with(propertyName=propertyValue [, ...])] Functionname(Parameter){Körper}

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich BESCHREIBUNG
Functionname string ✔️ Der Name der zu ändernden Funktion.
propertyName, propertyValue string Eine durch Trennzeichen getrennte Liste von Schlüssel-Wert-Eigenschaftspaaren. Weitere Informationen finden Sie unter unterstützte Eigenschaften.
parameters string Eine durch Trennzeichen getrennte Liste von Parametern, die für die Funktion erforderlich sind. 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 beim 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 und double.

Unterstützte Eigenschaften

Name Typ BESCHREIBUNG
docstring string Eine Beschreibung der Funktion für Benutzeroberflächenzwecke.
folder string Der Name eines Ordners, der für die Kategorisierung von UI-Funktionen verwendet wird.
skipvalidation bool Bestimmt, ob die semantische Validierung der Funktion übersprungen werden soll. Dies ist nützlich, wenn Funktionen in einer falschen Reihenfolge erstellt werden und F1, die F2 verwendet, früher erstellt wird.

Beispiel

.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 Demofunktion mit Parameter