Commande .create-or-alter function

Crée une fonction stockée ou modifie une fonction existante et la stocke à l’intérieur des métadonnées de la base de données.

Les règles pour les types de paramètres et les instructions CSL sont les mêmes que pour les instructions let.

Autorisations

Cette commande nécessite des autorisations d’utilisateur de base de données pour créer une fonction, et function Administration autorisations pour modifier une fonction existante.

Syntax

.create-or-alterfunction [ with(propertyName=propertyValue [, ...])] Functionname(Paramètres){Corps}

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
Functionname	string	✔️	Nom de la fonction à créer ou à modifier.
propertyName, propertyValue	string		Liste séparée par des virgules de paires de propriétés clé-valeur. Consultez propriétés prises en charge.
parameters	string		Liste séparée par des virgules des paramètres requis par la fonction. Le format de chaque paramètre doit être ParameterName:ParameterDataType.
body	string	✔️	Zéro ou plusieurs let instructions suivies d’une expression CSL valide qui est évaluée lors de l’appel de fonction.

Notes

Si la fonction avec le functionName fourni n'existe pas dans les métadonnées de la base de données, la commande crée une nouvelle fonction. Sinon, cette fonction sera modifiée.

Propriétés prises en charge

Nom	Type	Description
docstring	string	Description de la fonction à des fins d’interface utilisateur.
folder	string	Nom d’un dossier utilisé pour la catégorisation des fonctions d’interface utilisateur.

Exemple

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

Sortie

Nom	Paramètres	Corps	Dossier	DocString
TestFunction	(myLimit :int)	{ StormEvents | take myLimit }	MyFolder	Fonction de démonstration avec paramètre