Comando .alter function

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Modifica una función existente y la almacena dentro de los metadatos de la base de datos. Las reglas para los tipos de parámetro y las instrucciones CSL son las mismas que para let las instrucciones .

Permisos

Debe tener al menos permisos de administrador de funciones para ejecutar este comando. La entidad de seguridad que crea la función se convierte automáticamente en un administrador de funciones.

Sintaxis

.alterfunction [ with ( propertyName = propertyValue [, ...])] cuerpo de parámetros{) functionName( }

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Type	Obligatorio	Descripción
functionName	string	✔️	Nombre de la función que se va a modificar.
propertyName, propertyValue	string		Lista separada por comas de pares de propiedades clave-valor. Consulte las propiedades admitidas.
parameters	string		Lista separada por comas de parámetros requeridos por la función. El formato de cada parámetro debe ser ParameterName:ParameterDataType.
cuerpo	string	✔️	Cero o más let instrucciones seguidas de una expresión CSL válida que se evalúa tras la invocación de función.

Nota:

• Si la función no existe, se devuelve un error. Para crear una nueva función, consulte .create function
• No todos los tipos de Kusto se admiten en let instrucciones . Los tipos admitidos son: string, long, datetime, timespan y double.

Propiedades admitidas

Nombre	Escribir	Descripción
docstring	string	Descripción de la función con fines de interfaz de usuario.
folder	string	Nombre de una carpeta usada para la categorización de funciones de interfaz de usuario.
view	bool	Designa esta función como una vista almacenada. Las vistas almacenadas pueden participar en escenarios de búsqueda y unión * . Para obtener más información, vea Vistas.
skipvalidation	bool	Determina si se va a ejecutar la lógica de validación en la función y se produce un error en el proceso si la función no es válida. El valor predeterminado es false.

Ejemplo

En el ejemplo siguiente se modifica la función MyFunction2 con una descripción (docstring), una carpeta y se define el MyLimit parámetro .

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

Nombre	Parámetros	Cuerpo	Carpeta	DocString
MyFunction2	(myLimit: long)	{StormEvents | take myLimit}	MyFolder	Función de demostración con parámetro