SuperAPI AI 工具集

dv-python-sdk

编程与开发

查看项目

更新于 10-16 06:47

技能介绍

用途:使用微软官方 Power Platform Dataverse Client Python SDK,在脚本与自动化中完成 Dataverse 数据操作和基础表管理。官方仓库为 github.com/microsoft/PowerPlatform-DataverseClient-Python,PyPI 包名 PowerPlatform-Dataverse-Client,是唯一官方包,不应使用 dataverse-api 等非官方包。状态为预览,可能发生破坏性变更。安装命令:pip install --upgrade PowerPlatform-Dataverse-Client。

主要能力:记录 CRUD、带备用键的 Upsert、批量操作(CreateMultiple、UpdateMultiple、UpsertMultiple)、OData 查询(select、filter、orderby、expand、top、分页)、只读 SQL 查询、表创建删除与元数据、1:N 与 N:N 关系定义、备用键管理、文件列上传(大于 128MB 分块)、上下文管理器与 HTTP 连接池。

使用方式:先检查 MCP 工具是否可用;简单查询、单记录读取或不超过 10 条的小型 CRUD 直接用 MCP,无需写脚本。需要批量操作、多步逻辑、架构创建或分析时才写 Python 脚本。SDK 支持的操作必须用 SDK,不得用 urllib、requests 或原始 HTTP。脚本导入:from auth import get_credential, load_env 与 from PowerPlatform.Dataverse.client import DataverseClient。

限制:SDK 不支持表单、视图、全局选项集、N:N 记录关联($ref POST)、N:N $expand、$apply 聚合、Memo 列、非绑定操作、DeleteMultiple 及通用 OData 批处理,这些需用原始 Web API(get_token() 加 urllib/requests)。字段命名需注意:结构列用全小写逻辑名,导航属性区分大小写并须匹配 $metadata;@odata.bind 键保留导航属性大小写。查询 lookup 列时 $select 用 _<logicalname>_value 格式。批量导入 CSV 时 SDK 内部自动分批。错误处理可捕获 HttpError,按状态码区分 400、403、404、429 等情况。系统表批量创建前建议先建单条测试记录以发现必填字段。其余细节暂未提供。