BatchDataFrameOperations Класс

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

Предоставляет createи update delete принимает 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()

Конструктор

BatchDataFrameOperations(batch: _BatchContext)

Параметры

Имя	Описание
batch Обязательно

Методы

create

Запись enqueue создает из кадра данных Pandas.

Каждая строка становится записью. Все строки упаковываются в один CreateMultiple пакетный элемент (один HTTP-запрос в пакете).

Пример:


   df = pd.DataFrame([{"name": "Contoso"}, {"name": "Fabrikam"}])
   batch.dataframe.create("account", df)

delete

Запись enqueue удаляется из серии графических идентификаторов pandas.

Пример:


   ids_series = pd.Series(["guid-1", "guid-2", "guid-3"])
   batch.dataframe.delete("account", ids_series)

update

Запишите обновления записей из кадра данных Pandas.

Каждая строка представляет обновление. Указывает id_column , какой столбец содержит идентификаторы GUID записей.

Пример:


   df = pd.DataFrame([
       {"accountid": "guid-1", "telephone1": "555-0100"},
       {"accountid": "guid-2", "telephone1": "555-0200"},
   ])
   batch.dataframe.update("account", df, id_column="accountid")

create

Запись enqueue создает из кадра данных Pandas.

Пример:


   df = pd.DataFrame([{"name": "Contoso"}, {"name": "Fabrikam"}])
   batch.dataframe.create("account", df)

create(table: str, records: DataFrame) -> None

Параметры

Имя	Описание
table Обязательно	str Имя схемы таблицы (например, `"account"`).
records Обязательно	Dataframe Кадр данных, в котором каждая строка является записью для создания.

Исключения

Тип	Описание
TypeError	Если `records` это не кадр данных Pandas.
ValueError	Если `records` строка пуста или любая строка не имеет значений, отличных от NULL.

delete

Запись enqueue удаляется из серии графических идентификаторов pandas.

Пример:


   ids_series = pd.Series(["guid-1", "guid-2", "guid-3"])
   batch.dataframe.delete("account", ids_series)

delete(table: str, ids: Series, use_bulk_delete: bool = True) -> None

Параметры

Имя	Описание
table Обязательно	str Имя схемы таблицы (например, `"account"`).
ids Обязательно	Series Ряд идентификаторов ИДЕНТИФИКАТОРов записей для удаления.
use_bulk_delete	bool Если `True` (по умолчанию) и `ids` имеет несколько значений `BulkDelete` , используйте действие. Default value: True

Исключения

Тип	Описание
TypeError	Если `ids` это не серия pandas.
ValueError	Если `ids` содержит недопустимые значения.

update

Запишите обновления записей из кадра данных Pandas.

Каждая строка представляет обновление. Указывает id_column , какой столбец содержит идентификаторы GUID записей.

Пример:


   df = pd.DataFrame([
       {"accountid": "guid-1", "telephone1": "555-0100"},
       {"accountid": "guid-2", "telephone1": "555-0200"},
   ])
   batch.dataframe.update("account", df, id_column="accountid")

update(table: str, changes: DataFrame, id_column: str, clear_nulls: bool = False) -> None

Параметры

Имя	Описание
table Обязательно	str Имя схемы таблицы (например, `"account"`).
changes Обязательно	Dataframe Кадр данных, в котором каждая строка содержит GUID записи и поля для обновления.
id_column Обязательно	str Имя столбца DataFrame, содержащего идентификаторы GUID записей.
clear_nulls	bool Если `False` (по умолчанию) значения NaN/None пропускаются. Когда `True`naN/None отправляется `null` для очистки поля. Default value: False

Исключения

Тип	Описание
TypeError	Если `changes` это не кадр данных Pandas.
ValueError	Если `changes` идентификаторы пусты, `id_column` отсутствуют или идентификаторы недопустимы.