Delen via

.create-or-alter function command

Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer-

Hiermee maakt u een opgeslagen functie of wijzigt u een bestaande functie en slaat deze op in de metagegevens van de database.

Regels voor parametertypen en CSL-instructies zijn hetzelfde als voor let-instructies.

Machtigingen

Voor deze opdracht is databasegebruiker machtigingen vereist voor het maken van een nieuwe functie en functiebeheerder machtigingen voor het wijzigen van een bestaande functie.

Syntaxis

.create-or-alter function [ with(propertyName=propertyValue [, ...])] functionName(parameters){hoofdtekst}

Meer informatie over syntaxisconventies.

Parameters

Naam Type Vereist Beschrijving
functionName string ✔️ De naam van de functie die moet worden gemaakt of gewijzigd.
propertyName, propertyValue string Een door komma's gescheiden lijst met sleutel-waarde-eigenschapsparen. Zie ondersteunde eigenschappen.
parameters string Een door komma's gescheiden lijst met parameters die door de functie zijn vereist. De indeling voor elke parameter moet worden ParameterName:ParameterDataType.
hoofdtekst string ✔️ Nul of meer let instructies gevolgd door een geldige CSL-expressie die wordt geëvalueerd bij functie-aanroep.

Notitie

Als de functie met de opgegeven functionName niet bestaat in de metagegevens van de database, maakt de opdracht een nieuwe functie. Anders wordt die functie gewijzigd.

Ondersteunde eigenschappen

Naam Type Beschrijving
docstring string Een beschrijving van de functie voor gebruikersinterfacedoeleinden.
folder string De naam van een map die wordt gebruikt voor categorisatie van UI-functies.
view bool Hiermee wordt deze functie aangewezen als een opgeslagen weergave. Opgeslagen weergaven kunnen deelnemen aan zoek- en union * scenario's. Zie Weergavenvoor meer informatie.
skipvalidation bool Bepaalt of validatielogica moet worden uitgevoerd voor de functie en mislukt het proces als de functie niet geldig is. De standaardwaarde is false.

Voorbeeld

In het volgende voorbeeld wordt de functie TestFunction gemaakt met een beschrijving (docstring), en wordt de parameter MyLimit gedefinieerd.

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

uitvoer

Naam Parameters Lichaam Map DocString
TestFunction (myLimit:int) { StormEvents | take myLimit } MyFolder Demofunctie met parameter

Verwante inhoud

  • Last updated on