BatchDataFrameOperations Sınıf

Toplu kayıt işlemleri için DataFrame odaklı sarmalayıcılar.

createGirişleri kabul / pandas.DataFramepandas.Series eden ve delete toplu iş üzerinde sıralamadan önce bunları standart diktelere dönüştüren , updateve sağlar. Bu, veri bilimi çağıranların DataFrame'leri el ile dönüştürme olmadan doğrudan bir toplu iş olarak beslemesine olanak tanır.

batch.dataframe aracılığıyla erişilir.

Example:


   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()

Oluşturucu

BatchDataFrameOperations(batch: _BatchContext)

Parametreler

Name	Description
batch Gerekli

Yöntemler

create

Enqueue kaydı bir pandas DataFrame'den oluşturur.

Her satır bir kayıt olur. Tüm satırlar tek CreateMultiple bir toplu iş öğesinde (toplu işte bir HTTP isteği) paketlenir.

Example:


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

delete

Kayıt sıralama, pandas Guid Serisinden silinir.

Example:


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

update

Pandas DataFrame'den kayıt güncelleştirmelerini sıraya alın.

Her satır bir güncelleştirmeyi temsil eder. kayıt GUID'lerini id_column içeren sütunu belirtir.

Example:


   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 kaydı bir pandas DataFrame'den oluşturur.

Her satır bir kayıt olur. Tüm satırlar tek CreateMultiple bir toplu iş öğesinde (toplu işte bir HTTP isteği) paketlenir.

Example:


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

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

Parametreler

Name	Description
table Gerekli	str Tablo şeması adı (örn. `"account"`).
records Gerekli	Dataframe Her satırın oluşturulacak bir kayıt olduğu DataFrame.

Özel durumlar

Tür	Description
TypeError	Pandas `records` DataFrame değilse.
ValueError	Boşsa veya herhangi bir satır null olmayan değerlere sahip değilse `records` .

delete

Kayıt sıralama, pandas Guid Serisinden silinir.

Example:


   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

Parametreler

Name	Description
table Gerekli	str Tablo şeması adı (örn. `"account"`).
ids Gerekli	Series Silinecek kayıt GUID'leri serisi.
use_bulk_delete	bool (varsayılan) ve `ids` birden çok değere sahip olduğunda `True` eylemi kullanın`BulkDelete`. Default value: True

Özel durumlar

Tür	Description
TypeError	Pandas `ids` Serisi değilse.
ValueError	`ids` Geçersiz değerler içeriyorsa.

update

Pandas DataFrame'den kayıt güncelleştirmelerini sıraya alın.

Her satır bir güncelleştirmeyi temsil eder. kayıt GUID'lerini id_column içeren sütunu belirtir.

Example:


   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

Parametreler

Name	Description
table Gerekli	str Tablo şeması adı (örn. `"account"`).
changes Gerekli	Dataframe Her satırın bir kayıt GUID'sini ve güncelleştirilecek alanları içerdiği DataFrame.
id_column Gerekli	str Kayıt GUID'lerini içeren DataFrame sütununun adı.
clear_nulls	bool Ne zaman `False` (varsayılan), NaN/None değerleri atlanır. alanı temizlemek için NaN/None gönderildiğinde`Truenull`. Default value: False

Özel durumlar

Tür	Description
TypeError	Pandas `changes` DataFrame değilse.
ValueError	Boşsa, `id_column` eksikse `changes` veya kimlikler geçersizse.