Comando .alter function

Articolo
11/23/2024

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

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

Autorizzazioni

Per eseguire questo comando, è necessario disporre almeno delle autorizzazioni di amministratore delle funzioni. L'entità che crea la funzione viene automaticamente resa amministratore di funzioni.

Sintassi

.alterfunction [ with ( propertyName = propertyValue [, ...])] corpo dei parametri{) functionName( }

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	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 di 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 della 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, timespan e double.

Proprietà supportate

Nome	Tipo	Descrizione
`docstring`	`string`	Descrizione della funzione per scopi dell'interfaccia utente.
`folder`	`string`	Nome di una cartella usata per la categorizzazione delle funzioni dell'interfaccia utente.
`view`	`bool`	Designa questa funzione come vista archiviata. Le visualizzazioni archiviate possono partecipare a scenari di ricerca e unione * . Per altre informazioni, vedere Visualizzazioni.
`skipvalidation`	`bool`	Determina se eseguire la logica di convalida sulla funzione e non riesce il processo se la funzione non è valida. Il valore predefinito è `false`.

Esempio

Nell'esempio seguente viene modificata la funzione MyFunction2 con una descrizione (docstring), una cartella e viene definito il MyLimit parametro .

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

Nome	Parametri	Testo	Cartella	DocString
MyFunction2	(myLimit: long)	{StormEvents \| take myLimit}	MyFolder	Funzione demo con parametro

Condividi tramite