如何创建删除表数据的Azure Data Explorer函数及报错解决

• 该报错的核心原因是Azure Data Explorer（又称Kusto）的自定义函数存在语法限制：函数体内仅允许编写查询类语句，不支持直接写入以.开头的管理控制命令，你代码中写的.clear table batchwise_last_processed_record data属于管理类命令，解析器读到函数体内不符合查询语法规则的.令牌时，就会抛出该识别错误。
• 从产品设计层面，ADX默认也不允许普通自定义函数直接承载数据删除、表结构修改这类高风险操作，从语法层就做了拦截，避免越权操作风险。

你无法直接将.clear类管理命令写在函数体中，需要通过内置的execute_admin_command插件在函数内调用管理命令，具体操作如下：

1. 执行如下语句创建函数，注意调用该函数的账号必须提前拥有目标表的数据删除权限，否则执行时会触发权限拦截：

.create-or-alter function batchwise_last_processed_record_delete() {
    print execute_admin_command(".clear table batchwise_last_processed_record data")
}

2. 调用该清理函数时，必须搭配evaluate关键字触发，不能直接写函数名执行，调用示例：

evaluate batchwise_last_processed_record_delete()

• .clear table data是全表清空操作，属于重量级集群管理任务，不要高频调用，否则会占用集群后台资源，影响正常查询性能。
• 如果你的需求是按指定条件删除部分表数据，更推荐使用ADX原生提供的软删除、批量删除策略，不要封装全表清空函数做常规数据清理使用。

内容的提问来源于stack exchange，提问作者FlashBang