TM1py 开源项目教程
项目介绍
TM1py 是一个 Python 包,用于封装 IBM Planning Analytics (TM1) 的 REST API,使其成为一个易于使用的库。通过 TM1py,开发者可以轻松地使用 Python 与 TM1 进行交互,实现数据读取、写入、执行流程和任务等功能。
项目快速启动
安装 TM1py
首先,确保你已经安装了 Python 3.6 或更高版本。然后使用以下命令安装 TM1py:
pip install tm1py
连接到 TM1 服务器
以下是一个简单的示例,展示如何连接到 TM1 服务器并获取产品版本:
from TM1py.Services import TM1Service
with TM1Service(address='localhost', port=8001, user='admin', password='apple', ssl=True) as tm1:
print(tm1.server.get_product_version())
应用案例和最佳实践
数据读取
使用 TM1py 从 TM1 立方体中读取数据:
from TM1py.Services import TM1Service
with TM1Service(address='localhost', port=8001, user='admin', password='apple', ssl=True) as tm1:
data = tm1.cubes.cells.execute_mdx("MDX QUERY")
print(data)
数据写入
将数据写入 TM1 立方体:
from TM1py.Services import TM1Service
from TM1py.Utils import Utils
with TM1Service(address='localhost', port=8001, user='admin', password='apple', ssl=True) as tm1:
cellset = {
('CubeName', ('Dim1', 'Member1'), ('Dim2', 'Member2')): 100
}
tm1.cubes.cells.write_values('CubeName', cellset)
典型生态项目
TM1py 可以与其他 Python 库和工具结合使用,例如:
- Pandas: 用于数据分析和处理。
- Jupyter Notebook: 用于交互式数据探索和可视化。
- Flask/Django: 用于构建 Web 应用程序,将 TM1 数据展示给用户。
通过这些工具和库的结合,可以构建强大的数据分析和报告系统,进一步提升 TM1 的应用价值。