.alter function.alter function

Modifica una funzione esistente e la archivia all'interno dei metadati del database.Alters an existing function and stores it inside the database metadata. Le regole per i tipi di parametro e le istruzioni CSI sono le stesse delle let istruzioni.Rules for parameter types and CSL statements are the same as for let statements.

SintassiSyntax

.alter function [with (docstring = '<description>', folder='<name>', skipvalidation='true')] [FunctionName] ([paramName:paramType], ...) { CSL-statement }
Parametro di outputOutput parameter TypeType DescrizioneDescription
NomeName stringString Nome della funzione.The name of the function.
ParametriParameters stringString Parametri richiesti dalla funzione.The parameters required by the function.
CorpoBody stringString (Zero o più) let istruzioni seguite da un'espressione CSI valida valutata alla chiamata di funzione.(Zero or more) let statements followed by a valid CSL expression that is evaluated upon function invocation.
CartellaFolder stringString Cartella utilizzata per la categorizzazione delle funzioni dell'interfaccia utente.A folder used for UI functions categorization. Questo parametro non modifica il modo in cui viene richiamata la funzione.This parameter does not change the way function is invoked.
DocStringDocString stringString Descrizione della funzione per gli scopi dell'interfaccia utente.A description of the function for UI purposes.

Nota

  • Se la funzione non esiste, viene restituito un errore.If the function doesn't exist, an error is returned. Per la creazione di una nuova funzione, vedere . create functionFor creating a new function, see .create function
  • Richiede l' autorizzazione di amministratore del databaseRequires database admin permission
  • L' utente del database che ha originariamente creato la funzione può modificare la funzione.The database user who originally created the function is allowed to modify the function.
  • Non tutti i tipi kusto sono supportati let nelle istruzioni.Not all Kusto types are supported in let statements. I tipi supportati sono: String, Long, DateTime, TimeSpan e Double.Supported types are: string, long, datetime, timespan, and double.
  • Usare skipvalidation per ignorare la convalida semantica della funzione.Use skipvalidation to skip semantic validation of the function. Questa operazione è utile quando le funzioni vengono create in un ordine errato e F1 che usa F2 viene creato in precedenza.This is useful when functions are created in an incorrect order and F1 that uses F2 is created earlier.

EsempioExample

.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
 MyFunction2(myLimit: long)  {StormEvents | limit myLimit}
NomeName ParametriParameters CorpoBody CartellaFolder DocStringDocString
MyFunction2MyFunction2 (limite: Long)(myLimit: long) {StormEvents | limite massimo}{StormEvents | limit myLimit} MyFolderMyFolder Funzione demo con parametroDemo function with parameter