|
Высокоуровневый клиент для операций Microsoft Dataverse.
Этот клиент предоставляет простой стабильный интерфейс для взаимодействия с средами Dataverse через веб-API. Он обрабатывает проверку подлинности с помощью Azure identity и делегирует операции HTTP на внутренний клиент OData.
Ключевые возможности:
Операции OData CRUD: создание, чтение, обновление, удаление записей
SQL-запросы: выполнение SQL только для чтения с помощью параметра веб-API ?sql
Метаданные таблицы: создание, проверка и удаление пользовательских таблиц; создание и удаление столбцов
Отправка файлов: отправка файлов в столбцы файлов с поддержкой блокирования
Замечание
Клиент лениво инициализирует внутренний клиент OData при первом использовании, позволяя упрощенное строительство без немедленных сетевых вызовов.
Замечание
Все методы, взаимодействующие с веб-API Dataverse, могут вызываться
HttpError в случае успешного выполнения
HTTP-ответы (например, 401, 403, 404, 429, 500). Отдельный метод
Docstrings документирует только исключения, относящиеся к домену.
Операции организованы в пространства имен:
client.records — создание, обновление, удаление и получение записей (одиночные или разбиенные на страницы запросы)
client.query — операции запроса и поиска
client.tables — управление метаданными таблиц и столбцов
client.files — операции отправки файлов
client.dataframe — оболочки dataFrame pandas для записи CRUD
client.batch — пакетное несколько операций в один HTTP-запрос
Методы бета-версии (client.create, client.query_sqlи т. д.) были удалены в общедоступной версии 1.0. Вызов одного теперь вызывает AttributeError сообщение с именем замены общедоступной версии и команды codemod. Ранее эти вызовы вызвали ошибку AttributeError без указания миграции, поэтому отладка полумигрированного кода была болезненным. См. _REMOVED_BETA_METHODS.
Клиент поддерживает протокол диспетчера контекстов Python для автоматической очистки ресурсов и пула подключений HTTP:
|