client 模块

类

DataverseClient

用于Microsoft Dataverse作的高级客户端。

此客户端提供一个简单的稳定接口，用于通过 Web API 与 Dataverse 环境交互。 它通过Azure标识处理身份验证，并将 HTTP 操作委托给内部 OData 客户端。

关键功能：

  • OData CRUD作：创建、读取、更新、删除记录

  • SQL 查询：通过 Web API ?sql 参数执行只读 SQL

  • 表元数据：创建、检查和删除自定义表;创建和删除列

  • 文件上传：将文件上传到支持分块的文件列

注释

客户端在首次使用时延迟初始化其内部 OData 客户端，从而允许轻量级构造，而无需立即进行网络调用。

注释

与 Dataverse Web API 通信的所有方法都可能会引发

HttpError 非成功时

HTTP 响应（例如 401、403、404、429、500）。 单个方法

docstrings 仅记录特定于域的异常。

操作组织为命名空间：

  • client.records – 创建、更新、删除和获取记录（单一查询或分页查询）

  • client.query – 查询和搜索操作

  • client.tables – 表和列元数据管理

  • client.files – 文件上传操作

  • client.dataframe – 用于记录 CRUD 的 pandas 数据帧包装器

  • client.batch – 将多个操作批处理到单个 HTTP 请求中

1.0 GA 中删除了 v0 beta 方法（client.create等 client.query_sql）。 现在调用一个调用时会引发 AttributeError 一个消息，其中命名了 GA 替换和 codemod 命令 - 以前，这些调用只引发一个没有 AttributeError 迁移提示，因此调试半迁移的代码很痛苦。 请参阅_REMOVED_BETA_METHODS。

客户端支持Python的上下文管理器协议进行自动资源清理和 HTTP 连接池：