SuperAPI AI 工具集

eventhouse-authoring-cli

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:该技能用于通过命令行对 Microsoft Fabric 的 Eventhouse 和 KQL 数据库执行 KQL 管理命令,属于 Fabric 技能集的一部分。

主要能力:涵盖表管理(创建、加列、删除、模式演进)、数据摄取(内联、从存储、从 OneLake、set-or-append)、策略(保留、缓存、流式摄取、更新策略)、物化视图、存储函数、外部表与权限模型。

使用方式:依赖 az cli 与 jq(安装命令:winget install Microsoft.AzureCLI、winget install jqlang.jq)。先通过 az rest 发现工作区与 KQL 数据库查询 URI,再设置 CLUSTER_URI 与 DB_NAME,将 KQL 管理命令写入 /tmp/kql_body.json,然后执行:az rest --method POST --url "${CLUSTER_URI}/v1/rest/mgmt" --resource "https://kusto.kusto.windows.net" --headers "Content-Type=application/json" --body @/tmp/kql_body.json。KQL 受众为 kusto.kusto.windows.net,Fabric 控制面需 --resource https://api.fabric.microsoft.com。

适用场景:表与模式部署、批量摄取、策略配置、物化视图与函数创建、模式导出用于 CI/CD。

限制:需 Admin 或 Ingestor 角色;不可逆操作需用户明确意图;建议使用幂等命令(.create-merge table、.create-or-alter function);从 OneLake 或 Blob 摄取需带 impersonate;CSV/JSON 摄取应配置映射。首次使用需先运行 check-updates 技能。具体收费与平台细节暂未提供。