Comando della funzione .alter

  • Articolo

Modifica una funzione esistente e la archivia all'interno dei metadati del database. Le regole per i tipi di parametri e le istruzioni CSL sono uguali a per let le istruzioni.

Autorizzazioni

Per eseguire questo comando è necessario disporre almeno delle autorizzazioni di Amministrazione funzione. L'entità che crea la funzione viene creata automaticamente una funzione Amministrazione.

Sintassi

.alterfunction [ with(propertyName=propertyValue [, ...])] Functionname(Parametri){Corpo}

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
Functionname string ✔️ Nome della funzione da modificare.
propertyName, propertyValue string Elenco delimitato da virgole di coppie di proprietà chiave-valore. Vedere le proprietà supportate.
parameters string Elenco delimitato da virgole dei parametri richiesti dalla funzione. Il formato per ogni parametro deve essere ParameterName:ParameterDataType.
body string ✔️ Zero o più let istruzioni seguite da un'espressione CSL valida valutata alla chiamata alla funzione.

Nota

  • Se la funzione non esiste, viene restituito un errore. Per la creazione di una nuova funzione, vedere .create function
  • Non tutti i tipi Kusto sono supportati nelle let istruzioni. I tipi supportati sono: string, long, datetime, timepan e double.

Proprietà supportate

Nome Tipo Descrizione
docstring string Descrizione della funzione a scopo dell'interfaccia utente.
folder string Nome di una cartella usata per le funzioni dell'interfaccia utente categorizzazione.
skipvalidation bool Determina se ignorare la convalida semantica della funzione. Questa operazione è utile quando le funzioni vengono create in un ordine non corretto e F1 che usa F2 viene creato in precedenza.

Esempio

.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
 MyFunction2(myLimit: long)  {StormEvents | take myLimit}
Nome Parametri Corpo Cartella DocString
MyFunction2 (myLimit: long) {StormEvents | take myLimit} MyFolder Funzione demo con parametro