Команда .create-or-alter function

Статья
11/23/2024

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

Создает хранимую функцию или изменяет существующую функцию и сохраняет ее в метаданных базы данных.

Правила для типов параметров и инструкций CSL совпадают с правилами let.

Разрешения

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

Синтаксис

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

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

Параметры

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

Примечание.

Если функция с предоставленным именем функции не существует в метаданных базы данных, команда создает новую функцию. Кроме того, эта функция будет изменена.

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

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

Пример

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

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

Выходные данные

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

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