Comando .create-or-alter function

Articolo
11/23/2024

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

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

Autorizzazioni

Questo comando richiede autorizzazioni utente database per la creazione di una nuova funzione e autorizzazioni di amministratore delle funzioni per la modifica di una funzione esistente.

Sintassi

.create-or-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 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`	✔️	Zero o più `let` istruzioni seguite da un'espressione CSL valida valutata alla chiamata della funzione.

Nota

Se la funzione con functionName 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 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 creata la funzione TestFunction con una descrizione (docstring), una cartella e viene definito il MyLimit parametro .

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

Output

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

Condividi tramite