如何在ADF Lookup中执行KQL控制命令清除ADX表内容？

问题描述 #

我计划在Azure数据工厂（ADF）的Lookup活动中使用KQL，先清除ADX表内容再插入新数据。执行TableName查询表内容时可正常运行，但执行.clear table log-table data这类控制命令时，出现如下报错：

Request is invalid and cannot be processed: {
"error": {
"code": "Bad request",
"message": "Control commands (starting with a dot '.') cannot be served from the query endpoint unless they are .show control commands.",
}
}

解决方案 #

• 不要用Lookup活动执行控制命令：Lookup活动默认调用ADX的查询端点，而.clear、.insert这类带点前缀的控制命令必须通过ADX的管理端点执行，Lookup不支持该端点调用。
• 改用ADF的「Azure Data Explorer命令」活动：这是ADF专门为执行ADX控制命令设计的组件，会自动对接管理端点，操作步骤：
  1. 在ADF管道中添加「Azure Data Explorer命令」活动
  2. 配置该活动连接到目标ADX集群
  3. 在「命令」输入框中直接填写控制命令，比如.clear table log-table data或.insert into log-table <| 你的查询语句>
• 拆分流程适配现有逻辑：如果需要保留Lookup查询数据的环节，可以将流程拆分为三步：Lookup查询数据 → 「Azure Data Explorer命令」清除表数据 → 「Azure Data Explorer命令」插入新数据，按顺序串联这三个活动即可。

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