在 Microsoft Dataverse 中使用代码处理数据

可通过多种不同的方法来使用代码访问 Dataverse 数据。

• 使用 用于 .NET 的 Dataverse SDK、 用于 Python 的 SDK 或 Web API 检索、添加和修改数据。
• 使用 Dataverse 搜索 Dataverse 数据。
• 使用 Dataverse 表格数据流（TDS）终结点 通过 SQL 查询数据。

本文介绍使用代码处理 Dataverse 数据所需的选项。

检索、添加和修改数据

Dataverse 提供了两种方法来检索、添加和修改数据：SDK for .NET 和 Web API。 选择最符合您要求、技能和偏好的选项。

用于 .NET 的 SDK

如果使用 .NET，建议使用 适用于 .NET 的 SDK。

• 如果有客户端应用程序，请使用 DataverseServiceClient NuGet 包中的 ServiceClient 类。
• 编写插件或自定义工作流活动时，请使用 Microsoft.CrmSdk.CoreAssemblies NuGet 包 。

用于 .NET 的 Dataverse SDK 支持 .NET Framework 和 .NET 6+ 的生成目标。 但是，插件和自定义工作流活动必须使用 .NET Framework。

如果使用 PowerShell 模块 或使用 Windows 客户端应用程序的 自定义登录控件 ，请使用 Xrm.Tooling

• 使用 .NET 的 SDK
• 快速入门：执行用于 .NET 请求的 SDK （C#）

用于 Python 的 SDK

如果使用 Python，建议使用 适用于 Python 的 SDK。 SDK 使数据科学家和开发人员能够使用 Python 编程创建、访问和管理 Dataverse 业务数据。 Python 版 Dataverse SDK 实现了常见的 Python 编程范式和最佳实践，为 Dataverse 提供更自然的 Python 接口，并支持社区贡献。

详细信息： 入门

网络应用程序接口

Dataverse Web API 是 OData v4 RESTful 接口。 将 Web API 用于支持使用 OAuth 2.0（包括 .NET）的 HTTP 请求和身份验证的任何编程语言。

• 了解如何使用 Dataverse Web API
• 快速入门：使用 PowerShell 和 Visual Studio Code 的 Web API
• 快速入门：Web API 示例 （C#）

搜索 Dataverse 数据

Dataverse 搜索跨多个表提供快速且全面的搜索结果，在单个列表中按相关性排序。 它还提供功能来支持应用中的建议和自动完成体验。

搜索功能拥有原生接口，您可通过 Web API 或 .NET SDK 调用 Dataverse 消息。

了解如何搜索 Dataverse 记录

使用 SQL 查询数据

Power Query Dataverse 连接器使用 Dataverse 表格数据流（TDS）终结点来使用 Transact-SQL 子集 Dataverse SQL 检索数据。

使用 SQL Management Studio（SSMS）检索数据 是一项预览功能。

了解如何使用 SQL 查询数据

请求和响应有效负载大小限制

发送到 Dataverse 的任何请求的最大有效负载大小为 128 MB。 超过此限制的有效负载的请求在响应中收到 413 负载过大 HTTP 状态代码。

Dataverse 返回的响应大小存在 1 GB 大小限制。 很少有 API 或查询能够返回这么多数据。 如果遇到此限制，应考虑哪些其他选项可用于获取多个较小的请求中的数据。

弃用的 SOAP 终结点有效负载使用序列化的 XML 数据，该数据比 Web API 使用的序列化 JSON 数据有效负载更详细。 使用 Web API 时，不太可能遇到请求或响应有效负载过大的错误。 了解旧版 SOAP 终结点