SuperAPI AI 工具集

tom-operations

通用与其它

查看项目

更新于 10-16 06:47

技能介绍

用途:为 Semantic Link Labs 中的 TOM(Tabular Object Model)封装提供使用指南,当需要以编程方式管理或修改语义模型时使用,例如读取或修改语义模型元数据、增删表/列/度量值/关系、处理计算组与计算项、管理分区和数据源、实现模型管理功能。

主要能力:TOMWrapper 提供面向 Analysis Services 语义模型的 Pythonic 接口。核心文件为 src/sempy_labs/tom/init.py 与 src/sempy_labs/tom/_model.py。支持通过 connect_semantic_model 连接模型,提供 all_columns、all_measures、all_partitions、all_calculation_groups、all_calculation_items、all_functions 等迭代方法,以及 list_measures、list_columns、list_relationships、list_partitions 等返回 DataFrame 的辅助方法,和 add_measure、add_calculated_column、update_measure 等增改方法。还可读取表、列、度量值、关系的属性,修改度量值/列/表属性,并通过 Microsoft.AnalysisServices.Tabular 添加度量值、计算列与关系。支持服务主体认证与 Azure Analysis Services。

使用方式:使用 with connect_semantic_model(dataset=..., readonly=..., workspace=...) as tom 上下文管理器,只读时用 readonly=True,修改需 XMLA 读写。退出上下文正常时保存更改,异常时不保存。

限制:读写操作要求容量启用 XMLA 读写;必须使用 with 语句;异常需处理;不宜长时间保持连接。