Команда alter function

Статья
11/23/2024

Область применения: ✅Microsoft Fabric ✅Azure Data Explorer

Изменяет существующую функцию и сохраняет ее в метаданных базы данных. Правила для типов параметров и инструкций CSL совпадают с let правилами инструкций.

Разрешения

Для выполнения этой команды необходимо иметь по крайней мере разрешения администратора функций. Субъект, создающий функцию, автоматически создается администратором функции.

Синтаксис

.alterfunction [ with ( propertyName = propertyValue [, ...])] Текст параметров {) functionName( }

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название)	Type	Обязательно	Описание
functionName	`string`	✔️	Имя функции для изменения.
propertyName, propertyValue	`string`		Разделенный запятыми список пар свойств "ключ-значение". См . поддерживаемые свойства.
parameters	`string`		Разделенный запятыми список параметров, необходимых функции. Формат каждого параметра должен иметь значение ParameterName`:`ParameterDataType.
текст	`string`	✔️	Ноль или больше `let` инструкций, за которым следует допустимое выражение CSL, которое вычисляется при вызове функции.

Примечание.

Если функция не существует, возвращается ошибка. Сведения о создании новой функции см. в разделе .create function
Не все типы Kusto поддерживаются в let инструкциях. Поддерживаемые типы: string, long, datetime, timepan и double.

Поддерживаемые свойства

Имя.	Тип	Описание
`docstring`	`string`	Описание функции для целей пользовательского интерфейса.
`folder`	`string`	Имя папки, используемой для классификации функций пользовательского интерфейса.
`view`	`bool`	Назначает эту функцию в качестве сохраненного представления. Сохраненные представления могут участвовать в сценариях поиска и объединения * . Дополнительные сведения см. в разделе "Представления".
`skipvalidation`	`bool`	Определяет, следует ли выполнять логику проверки в функции и завершать сбой процесса, если функция не является допустимой. Значение по умолчанию — `false`.

Пример

Следующий пример изменяет функцию MyFunction2 с описанием (docstring), папкой и определяет MyLimit параметр.

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

Имя.	Параметры	Текст	Папка	DocString
MyFunction2	(myLimit: long)	{StormEvents \| take myLimit}	MyFolder	Демонстрация функции с параметром

Поделиться через