Comando .create function

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

Crea una funzione archiviata, ovvero una query KQL riutilizzabile, con il nome specificato. La definizione della funzione viene mantenuta con i metadati del database.

Le funzioni possono chiamare altre funzioni (la ricorsione non è supportata). Inoltre, let le istruzioni sono consentite come parte del corpo della funzione. Vedere let le istruzioni.

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 utente del database.

Sintassi

.create function [ ifnotexists ] [ with(propertyName=propertyValue [, ...]) ] corpo dei parametri{}

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
ifnotexists	string		Se specificato, la funzione verrà creata solo se la funzione non esiste ancora.
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 di parametri richiesti dalla funzione . Il formato per ogni parametro deve essere ParameterName:ParameterDataType.
body	string	✔️	Espressione di funzione definita dall'utente.

Proprietà supportate

Nome	Digita	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 o meno la logica di convalida nella funzione e non eseguire il processo se la funzione non è valida. Il valore predefinito è false.

Suggerimento

Se una funzione include true

Valori restituiti

Parametro di output	Digita	Descrizione
Nome	string	Nome della funzione.
Parametri	string	Parametri richiesti dalla funzione .
Testo	string	(Zero o più) let istruzioni seguite da un'espressione CSL valida valutata al momento della chiamata di funzione.
Cartella	string	Cartella usata per la categorizzazione delle funzioni dell'interfaccia utente. Questo parametro non modifica il modo in cui viene richiamata la funzione.
DocString	string	Descrizione della funzione per scopi dell'interfaccia utente.

Nota

• Se la funzione esiste già:
  • Se ifnotexists viene specificato il flag, il comando viene ignorato (nessuna modifica applicata).
  • Se ifnotexists il flag NON è specificato, viene restituito un errore.
  • Per la modifica di una funzione esistente, vedere .alter function
• Non tutti i tipi di dati sono supportati nelle let istruzioni . I tipi supportati sono: booleano, string, long, datetime, timespan, double e dynamic.
• Usare skipvalidation per ignorare la convalida semantica della funzione. Ciò è utile quando le funzioni vengono create in un ordine non corretto e F1 che usa F2 viene creato in precedenza.

Esempi

Funzione semplice

L'esempio seguente crea la MyFunction1 funzione con una descrizione (docstring), una cartella denominata Demoe definisce la funzione .

.create function 
with (docstring = 'Simple demo function', folder='Demo')
MyFunction1()
{StormEvents | take 100}

Nome	Parametri	Testo	Cartella	DocString
MyFunction1	()	{StormEvents | take 100}	Demo	Funzione demo semplice

Funzione con un parametro

Nell'esempio seguente viene creata la funzione MyFunction2 con una descrizione (docstring), la cartella denominata Demoe definisce il parametro Mytimestamp.

.create function with (docstring = "Demo function with date parameter",folder = "Demo") 
 MyFunction2(Mytimestamp:datetime) {
    StormEvents
    | where EndTime <= Mytimestamp
 }

Nome	Parametri	Testo	Cartella	DocString
MyFunction2	(Mytimestamp:datetime)	{StormEvents | where EndTime <= Mytimestamp}	Demo	Funzione demo con il parametro date