Comando con estensione create-or-alter function

Crea una funzione archiviata o 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 le istruzioni let.

Autorizzazioni

Questo comando richiede autorizzazioni utente database per la creazione di una nuova funzione e le autorizzazioni di funzione Amministrazione per modificare una funzione esistente.

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
Functionname string ✔️ Nome della funzione da creare o 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 con il nome funzione specificato non esiste nei metadati del database, il comando crea una nuova funzione. In caso contrario, tale funzione verrà modificata.

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.

Esempio

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

Output

Nome Parametri Corpo Cartella DocString
TestFunction (myLimit:int) { StormEvents | take myLimit } MyFolder Funzione demo con parametro