Commande .alter function

Article
11/23/2024

S’applique à : ✅Microsoft Fabric ✅Azure Data Explorer

Modifie une fonction existante et la stocke dans les 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 let instructions.

autorisations

Vous devez disposer au moins des autorisations d’administrateur de fonction pour exécuter cette commande. Le principal qui crée la fonction est automatiquement créé comme administrateur de fonction.

Syntaxe

.alterfunction [ with ( propertyName = propertyValue [, ...])] corps des paramètres{ ) functionName( }

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
Nom de fonction	`string`	✔️	Nom de la fonction à modifier.
propertyName, propertyValue	`string`		Liste séparée par des virgules de paires de propriétés clé-valeur. Consultez les 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.
corps	`string`	✔️	Zéro ou plusieurs `let` instructions suivies d’une expression CSL valide évaluée lors de l’appel de fonction.

Remarque

Si la fonction n’existe pas, une erreur est retournée. Pour créer une fonction, consultez .create function
Tous les types Kusto ne sont pas pris en charge dans let les instructions. Les types pris en charge sont : chaîne, long, datetime, timespan et double.

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.
`view`	`bool`	Désigne cette fonction en tant qu’affichage stocké. Les vues stockées peuvent participer à des scénarios de recherche et d’union * . Pour plus d’informations, consultez Vues.
`skipvalidation`	`bool`	Détermine s’il faut exécuter la logique de validation sur la fonction et échouer le processus si la fonction n’est pas valide. Par défaut, il s’agit de `false`.

Exemple

L’exemple suivant modifie la fonction MyFunction2 avec une description (docstring), un dossier et définit le MyLimit paramètre.

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

Nom	Paramètres	Corps	Dossier	DocString
MyFunction2	(myLimit: long)	{StormEvents \| take myLimit}	MyFolder	Demo function with parameter

Partager via