BatchDataFrameOperations Kelas

Pembungkus berorientasi DataFrame untuk operasi rekaman batch.

Menyediakan create, update, dan delete yang menerima pandas.DataFrame / pandas.Series input dan mengonversinya ke dict standar sebelum mengantre pada batch. Ini memungkinkan pemanggil ilmu data memberi umpan DataFrames langsung ke dalam batch tanpa konversi manual.

Diakses melalui batch.dataframe.

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

Konstruktor

BatchDataFrameOperations(batch: _BatchContext)

Parameter

Nama	Deskripsi
batch Diperlukan

Metode

create

Catatan antrean dibuat dari Pandas DataFrame.

Setiap baris menjadi rekaman. Semua baris dibundel dalam satu CreateMultiple item batch (satu permintaan HTTP dalam batch).

Example:


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

delete

Rekaman antrean dihapus dari Seri GUID pandas.

Example:


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

update

Antrean merekam pembaruan dari Pandas DataFrame.

Setiap baris mewakili pembaruan. Menentukan id_column kolom mana yang berisi GUID rekaman.

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

Catatan antrean dibuat dari Pandas DataFrame.

Setiap baris menjadi rekaman. Semua baris dibundel dalam satu CreateMultiple item batch (satu permintaan HTTP dalam batch).

Example:


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

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

Parameter

Nama	Deskripsi
table Diperlukan	str Nama skema tabel (misalnya `"account"`).
records Diperlukan	Dataframe DataFrame tempat setiap baris adalah rekaman yang akan dibuat.

Pengecualian

Jenis	Deskripsi
TypeError	Jika `records` bukan Pandas DataFrame.
ValueError	Jika `records` kosong atau baris apa pun tidak memiliki nilai non-null.

delete

Rekaman antrean dihapus dari Seri GUID pandas.

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

Parameter

Nama	Deskripsi
table Diperlukan	str Nama skema tabel (misalnya `"account"`).
ids Diperlukan	Series Serangkaian GUID rekaman yang akan dihapus.
use_bulk_delete	bool Ketika `True` (default) dan `ids` memiliki beberapa nilai, gunakan `BulkDelete` tindakan . Nilai default: True

Pengecualian

Jenis	Deskripsi
TypeError	Jika `ids` bukan Seri panda.
ValueError	Jika `ids` berisi nilai yang tidak valid.

update

Antrean merekam pembaruan dari Pandas DataFrame.

Setiap baris mewakili pembaruan. Menentukan id_column kolom mana yang berisi GUID rekaman.

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

Parameter

Nama	Deskripsi
table Diperlukan	str Nama skema tabel (misalnya `"account"`).
changes Diperlukan	Dataframe DataFrame di mana setiap baris berisi GUID rekaman dan bidang yang akan diperbarui.
id_column Diperlukan	str Nama kolom DataFrame yang berisi GUID rekaman.
clear_nulls	bool Ketika `False` (default), nilai NaN/None dilewati. Ketika `True`, NaN/None mengirim `null` untuk menghapus bidang. Nilai default: False

Pengecualian

Jenis	Deskripsi
TypeError	Jika `changes` bukan Pandas DataFrame.
ValueError	Jika `changes` kosong, `id_column` hilang, atau ID tidak valid.