用途:通过 pbi-cli 命令行管理 Power BI 表分区、命名表达式(M/Power Query 数据源)和日历表配置。
准备工作:运行 pipx install pbi-cli-tool 安装,再执行 pbi-cli skills install,并用 pbi connect 连接。
主要能力:分区方面可列出、创建(支持 Import 与 DirectQuery 模式及 M 表达式)、删除、单独刷新指定分区;命名表达式方面可列出、获取、创建、删除共享 M 查询与连接参数;日历表方面可列出日期表并标记日期列(pbi calendar mark 或 pbi table mark-date)。所有列表命令支持 --json 输出,便于脚本化处理。
使用方式示例:pbi partition list --table Sales;pbi partition create "Sales_2024" --table Sales --expression "..." --mode Import;pbi partition refresh "Sales_2024" --table Sales;pbi expression create "ServerURL" --expression '"https://api.example.com/data"';pbi calendar mark Calendar --date-column Date。可用 pbi database export-tmdl ./model/ 导出模型做版本控制。
限制与注意事项:增量刷新需正确命名并声明 DateTime 类型的 RangeStart/RangeEnd 参数,否则服务会静默退回全量刷新;分区刷新只作用于指定分区,但表级计算列会重建,可能需 --type Calculate;命名表达式作为数据源须按名称引用而非内联,否则会产生独立数据源记录;同一表混用 DirectQuery 与 Import 分区非法;expression create 单引号字符串需保留外层引号;日历表标记后无法通过 CLI 取消,只能改 TMDL dataCategory 或用 Desktop。收费、平台限制等未在资料中提供。