client Module

Classes

DataverseClient

High-level client for Microsoft Dataverse operations.

This client provides a simple, stable interface for interacting with Dataverse environments through the Web API. It handles authentication via Azure Identity and delegates HTTP operations to an internal PowerPlatform.Dataverse.data._odata._ODataClient.

Key capabilities:

  • OData CRUD operations: create, read, update, delete records

  • SQL queries: execute read-only SQL via Web API ?sql parameter

  • Table metadata: create, inspect, and delete custom tables; create and delete columns

  • File uploads: upload files to file columns with chunking support

Note

The client lazily initializes its internal OData client on first use, allowing lightweight construction without immediate network calls.

Note

All methods that communicate with the Dataverse Web API may raise

HttpError on non-successful

HTTP responses (e.g. 401, 403, 404, 429, 500). Individual method

docstrings document only domain-specific exceptions.

Operations are organized into namespaces:

  • client.records – create, update, delete, and get records (single or paginated queries)

  • client.query – query and search operations

  • client.tables – table and column metadata management

  • client.files – file upload operations