SuperAPI AI 工具集

dv-data

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:dv-data 负责 Dataverse 的记录级 CRUD 与批量数据操作,包括创建、更新、删除、upsert、CSV 导入、多表外键依赖加载,以及 AI 生成示例数据。查询读取请用 dv-query,建表建列用 dv-metadata,解决方案导出部署用 dv-solution,ERP 写入需先加载 dv-overview 并阅读 references/erp-writes.md。

主要能力:官方 SDK 支持记录创建、更新、删除、带备用键的 upsert、批量操作(CreateMultiple、UpdateMultiple、UpsertMultiple、服务端 BulkDelete、client.batch 批处理)、文件列上传(大于 128MB 分块)、连接池上下文管理器。SDK 不支持表单/视图、全局选项集、N:N 关联、$apply 聚合、非绑定操作,这些应使用 dataverse api 逃生通道或 CLI。

使用方式:脚本必须用 Python,禁止 Node.js/JavaScript。CLI 快速路径在 dataverse auth who 显示活动配置后可直接使用 data create/update/delete/upsert/associate/upload。MCP 工具适合 25 条以内交互式写入;CLI 适合单条写入、关联/取消关联和文件上传;SDK 适合超过 25 条的批量写入、数据转换、重试、CSV 导入及仅 SDK 支持的操作。脚本中应使用 from auth import get_client,并先执行 sys.path.insert。

关键规则:结构列名用 LogicalName 全小写,导航属性名大小写敏感并匹配 $metadata;@odata.bind 键为导航属性名,值为 /<EntitySetName>(<guid>);选项列用整数值;新建查找列后等待 5–10 秒再插入。Upsert 的备用键列不得同时出现在记录正文中,否则 UpsertMultiple 会失败。批量创建不会自动分块,需自行分块,建议从 1000 开始自适应调整。多表导入按依赖层级执行,同层表可并行,表内分块串行。

限制:资料未提供收费、价格、平台支持范围等细节;部分内容在原文中被截断,错误处理仅列出 400/403/404 的简要说明。