BatchDataFrameOperations Osztály

DataFrame-orientált burkoló kötegrekord-műveletekhez.

Megadja create, updateés delete fogadja el pandas.DataFrame / pandas.Series a bemeneteket, és szabványos diktálásokká alakítja őket, mielőtt a kötegbe lépne. Ez lehetővé teszi, hogy az adatelemzési hívók manuális átalakítás nélkül közvetlenül egy kötegbe táplálják a DataFrame-eket.

Elérhető ezen keresztül: 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)

Paraméterek

Name	Description
batch Kötelező

Metódusok

create

Az enqueue rekord egy pandas DataFrame-ből jön létre.

Minden sor rekord lesz. Minden sor egyetlen CreateMultiple kötegelembe van csomagolva (a kötegben egy HTTP-kérés).

Example:


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

delete

Az enqueue rekord töröl egy pandas-sorozat grafikus felhasználói felületéről.

Example:


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

update

Rekordfrissítések leküldése pandas DataFrame-ből.

Minden sor egy frissítést jelöl. Megadja id_column , hogy melyik oszlop tartalmazza a rekord GUID-jait.

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

Az enqueue rekord egy pandas DataFrame-ből jön létre.

Minden sor rekord lesz. Minden sor egyetlen CreateMultiple kötegelembe van csomagolva (a kötegben egy HTTP-kérés).

Example:


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

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

Paraméterek

Name	Description
table Kötelező	str Táblaséma neve (pl. `"account"`).
records Kötelező	Dataframe DataFrame, ahol minden sor létrehozandó rekord.

Kivételek

Típus	Description
TypeError	Ha `records` nem pandas DataFrame.
ValueError	Ha `records` üres, vagy bármely sor nem null értékű.

delete

Az enqueue rekord töröl egy pandas-sorozat grafikus felhasználói felületéről.

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

Paraméterek

Name	Description
table Kötelező	str Táblaséma neve (pl. `"account"`).
ids Kötelező	Series Törölni kívánt rekordGUID-k sorozata.
use_bulk_delete	bool Ha `True` (alapértelmezett) és `ids` több értékkel rendelkezik, használja a `BulkDelete` műveletet. Alapértelmezett érték: True

Kivételek

Típus	Description
TypeError	Ha `ids` nem pandas Series.
ValueError	Ha `ids` érvénytelen értékeket tartalmaz.

update

Rekordfrissítések leküldése pandas DataFrame-ből.

Minden sor egy frissítést jelöl. Megadja id_column , hogy melyik oszlop tartalmazza a rekord GUID-jait.

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

Paraméterek

Name	Description
table Kötelező	str Táblaséma neve (pl. `"account"`).
changes Kötelező	Dataframe DataFrame, ahol minden sor tartalmaz egy rekord GUID azonosítóját és a frissíteni kívánt mezőket.
id_column Kötelező	str A rekordGUID-ket tartalmazó DataFrame oszlop neve.
clear_nulls	bool Ha `False` (alapértelmezett) a NaN/None érték, a rendszer kihagyja a naN/None értéket. Amikor `True`a NaN/None parancs törli `null` a mezőt. Alapértelmezett érték: False

Kivételek

Típus	Description
TypeError	Ha `changes` nem pandas DataFrame.
ValueError	Ha `changes` üres, `id_column` hiányzik, vagy az azonosítók érvénytelenek.