BatchDataFrameOperations Klass

DataFrame-orienterade omslutningar för batchpoståtgärder.

Tillhandahåller create, updateoch delete som accepterarpandas.Series / pandas.DataFrame indata och konverterar dem till standarddiktor innan de skickas i batchen. På så sätt kan datavetenskapsuppringare mata dataramar direkt till en batch utan manuell konvertering.

Nås via 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)

Parametrar

Name	Description
batch Obligatorisk

Metoder

create

Enqueue-post skapas från en Pandas DataFrame.

Varje rad blir en post. Alla rader paketeras i ett enda CreateMultiple batchobjekt (en HTTP-begäran i batchen).

Example:


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

delete

Enqueue-postborttagningar från en Pandas-serie med GUID:er.

Example:


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

update

Spara postuppdateringar från en Pandas DataFrame.

Varje rad representerar en uppdatering. id_column Anger vilken kolumn som innehåller postens GUID.

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-post skapas från en Pandas DataFrame.

Varje rad blir en post. Alla rader paketeras i ett enda CreateMultiple batchobjekt (en HTTP-begäran i batchen).

Example:


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

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

Parametrar

Name	Description
table Obligatorisk	str Tabellschemanamn (t.ex. `"account"`).
records Obligatorisk	Dataframe DataFrame där varje rad är en post att skapa.

Undantag

Typ	Description
TypeError	Om `records` inte är en Pandas DataFrame.
ValueError	Om `records` är tom eller om någon rad inte har några värden som inte är null.

delete

Enqueue-postborttagningar från en Pandas-serie med GUID:er.

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

Parametrar

Name	Description
table Obligatorisk	str Tabellschemanamn (t.ex. `"account"`).
ids Obligatorisk	Series Serie med post-GUID:er som ska tas bort.
use_bulk_delete	bool När `True` (standard) och `ids` har flera värden använder du åtgärden `BulkDelete` . Standardvärde: True

Undantag

Typ	Description
TypeError	Om `ids` inte är en Pandas-serie.
ValueError	Om `ids` innehåller ogiltiga värden.

update

Spara postuppdateringar från en Pandas DataFrame.

Varje rad representerar en uppdatering. id_column Anger vilken kolumn som innehåller postens GUID.

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

Parametrar

Name	Description
table Obligatorisk	str Tabellschemanamn (t.ex. `"account"`).
changes Obligatorisk	Dataframe DataFrame där varje rad innehåller ett post-GUID och fälten som ska uppdateras.
id_column Obligatorisk	str Namnet på den DataFrame-kolumn som innehåller post-GUID.
clear_nulls	bool När `False` (standard) hoppas NaN/None-värden över. När `True`skickar `null` NaN/None för att rensa fältet. Standardvärde: False

Undantag

Typ	Description
TypeError	Om `changes` inte är en Pandas DataFrame.
ValueError	Om `changes` är tomt, `id_column` saknas eller om ID:na är ogiltiga.