.alter function 命令

适用于:✅Azure 数据资源管理器

更改现有函数并将其存储在数据库元数据中。 参数类型和 CSL 语句的规则与 let 语句的规则相同。

权限

你必须至少具有函数管理员权限才能运行此命令。 创建函数的主体会自动成为函数管理员。

语法

.alter function [ with ( propertyName = propertyValue [, ...])] functionName(parameters) { body }

详细了解语法约定

参数

客户 类型​​ 必需 说明
functionName string ✔️ 要更改的函数的名称。
propertyName, propertyValue string 键值属性对的逗号分隔列表。 请参阅支持的属性
参数 string 函数所需参数的逗号分隔列表。 每个参数的格式必须为 ParameterName:ParameterDataType。
正文 string ✔️ 零个或多个 let 语句,后跟有效的 CSL 表达式,该表达式在函数调用时求值。

注意

  • 如果该函数不存在,则返回错误。 若要创建新函数,请参阅 .create function
  • let 语句并不支持所有的 Kusto 类型。 支持的类型为:字符串、长整型、日期时间、时间跨度和双精度型。

支持的属性

名称 Type 描述
docstring string 用于 UI 目的的函数说明。
folder string 用于 UI 函数分类的文件夹的名称。
view bool 将此函数指定为存储视图。 存储视图可以参与搜索联合*方案。 有关详细信息,请参阅视图
skipvalidation bool 确定是否对函数运行验证逻辑,如果函数无效,则让进程失败。 默认为 false

示例

以下示例使用说明 (docstring)、文件夹修改 MyFunction2 函数,并定义 MyLimit 参数。

.alter function
with (docstring = 'Demo function with parameter', folder='MyFolder')
MyFunction2(myLimit: long)  
{StormEvents | take myLimit}
名称 parameters 正文 文件夹 DocString
MyFunction2 (myLimit: long) {StormEvents | take myLimit} MyFolder 带参数的演示函数