batch Модуль

Оболочки, ориентированные на кадры данных для операций пакетной записи.

Предоставляет createи updatedelete принимает pandas.DataFrame / pandas.Series входные данные и преобразует их в стандартные дикты перед вводом в пакет. Это позволяет вызывающим данным передавать кадры данных непосредственно в пакет без ручного преобразования.

Доступ к ней осуществляется через batch.dataframe.

Пример:

   import pandas as pd

   batch = client.batch.new()
   df = pd.DataFrame([
       {"name": "Contoso", "telephone1": "555-0100"},
       {"name": "Fabrikam", "telephone1": "555-0200"},
   ])
   batch.dataframe.create("account", df)
   result = batch.execute()

Пространство имен для пакетных операций (client.batch).

Доступ к ней осуществляется через client.batch. Используется new для создания построителя BatchRequest .

Пример:

   batch = client.batch.new()
   batch.records.create("account", {"name": "Fabrikam"})
   result = batch.execute()

Операции запроса в объекте BatchRequest.

Зеркально client.query : те же имена методов, одни и те же сигнатуры. Все методы возвращаются None; результаты поступают через BatchResult.

Не создавайте экземпляр непосредственно; use batch.query.

Запись операций BatchRequestс .

Зеркальные отображения client.records: те же имена методов, одни и те же сигнатуры. Все методы возвращаются None; результаты доступны через BatchResult после execute.

Методы общедоступной версии: retrieve (одна запись) и list (многозаписная, одна страница). get не рекомендуется — используйте retrieve вместо этого.

Не создавайте экземпляр непосредственно; use batch.records.

Построитель для создания и выполнения запроса OData $batch Dataverse.

Получите через new (client.batch.new()). Добавление операций с помощью records, tablesqueryиdataframe, при необходимости, группирование записываются в changeset, а затем вызываетсяexecute.

Операции выполняются последовательно в добавленном порядке. Результирующий BatchResult запрос содержит один по протоколу BatchItemResponse HTTP-запроса (некоторые операции расширяются до нескольких запросов).

Пример:

   batch = client.batch.new()
   batch.records.create("account", {"name": "Contoso"})
   batch.tables.get("account")
   with batch.changeset() as cs:
       ref = cs.records.create("contact", {"firstname": "Alice"})
       cs.records.update("account", account_id, {
           "primarycontactid@odata.bind": ref
       })
   result = batch.execute()

Операции метаданных таблицы в объекте BatchRequest.

Зеркально client.tables : те же имена методов, одни и те же сигнатуры. Все методы возвращаются None; результаты поступают через BatchResult.

Не создавайте экземпляр непосредственно; use batch.tables.

Транзакционная группа операций записи с одной записью.

Все операции выполняются успешно или откатываются вместе. Используйте в качестве диспетчера контекста или вызова records для непосредственного добавления операций.

Не создавайте экземпляр непосредственно; use changeset.

Пример:

   with batch.changeset() as cs:
       ref = cs.records.create("contact", {"firstname": "Alice"})
       cs.records.update("account", account_id, {
           "primarycontactid@odata.bind": ref
       })

Запись операций записи, доступных ChangeSetвнутри .

Зеркальные отображения, но ограниченные одними формами client.records записей (без массового создания и обновления и удаления). Разрешены только операции записи. GET не допускается внутри набора изменений.

Не создавайте экземпляр непосредственно; use ChangeSet.records.