通过

入门（预览版）

[本文是预发行文档，可能会有所更改。]

本文介绍如何设置 Python 环境，以便通过用于 Python 的 Dataverse SDK 访问 Dataverse。 然后，我们演示了一些简单的编码示例来帮助你入门。

先决条件

  • 对 Dataverse 环境的读/写访问权限。 可以使用 试用环境 。
  • 激活的 Python 3.10+ 环境。
  • 对 pypi.org 的网络访问以获取 SDK 包。

安装 SDK 和依赖项

在终端窗口中，执行以下命令。 这会从 pypi.org 安装 SDK。

pip install PowerPlatform-Dataverse-Client

连接到 Dataverse

此代码示例从 SDK 包导入客户端和配置类型，并建立与 Dataverse 环境的连接。 请务必将 URL 中的“myorg”更改为环境的正确名称。

from azure.identity import InteractiveBrowserCredential
from PowerPlatform.Dataverse.client import DataverseClient
from PowerPlatform.Dataverse.core.config import DataverseConfig

cfg = DataverseConfig()  # defaults to language_code=1033
client = DataverseClient(base_url="https://<myorg>.crm.dynamics.com", 
    InteractiveBrowserCredential(), config=cfg)

可以使用可选的 HTTP 可调节设置来自定义连接，以便处理连接超时、重试等问题。通过 cfg.http_retries、cfg.http_backoff 和 cfg.http_timeout 访问这些设置。

现已建立到 Dataverse 环境的客户端连接，接下来可以使用 SDK 来处理业务数据、表元数据等。 下一篇文章将介绍一些这些操作的示例。

离开此页面之前，请注意，除非你对 Dataverse 有一些了解，否则无法有效地使用 Dataverse。 我们提供了一篇快速指南文章，指导你了解基础知识。

后续步骤

  • Last updated on