BatchDataFrameOperations クラス

バッチレコード操作用の DataFrame 指向ラッパー。

バッチにエンキューする前に、pandas.DataFrame / pandas.Series入力を受け入れ、標準のディクテーションに変換するcreate、update、およびdeleteを提供します。これにより、データサイエンスの呼び出し元は、データフレームを手動で変換せずにバッチに直接フィードできます。

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

Pandas DataFrame からエンキューレコードが作成されます。

各行がレコードになります。すべての行は、単一の CreateMultiple バッチ項目 (バッチ内の 1 つの HTTP 要求) にバンドルされます。

例:


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

delete

Pandas 一連の GUID からレコードをエンキュー削除します。

例:


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

update

pandas DataFrame からレコードの更新をエンキューします。

各行は更新を表します。 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

Pandas DataFrame からエンキューレコードが作成されます。

各行がレコードになります。すべての行は、単一の CreateMultiple バッチ項目 (バッチ内の 1 つの HTTP 要求) にバンドルされます。

例:


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

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

パラメーター

名前	説明
table 必須	str テーブルスキーマ名 (例: `"account"`)。
records 必須	Dataframe 各行が作成するレコードである DataFrame。

例外

型	説明
TypeError	`records`が pandas DataFrame でない場合。
ValueError	`records`が空であるか、行に null 以外の値がない場合。

delete

Pandas 一連の GUID からレコードをエンキュー削除します。

例:


   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 削除する一連のレコード GUID。
use_bulk_delete	bool `True` (既定値) と`ids`に複数の値がある場合は、`BulkDelete` アクションを使用します。規定値: True

例外

型	説明
TypeError	`ids`が pandas シリーズでない場合。
ValueError	`ids`に無効な値が含まれている場合。

update

pandas DataFrame からレコードの更新をエンキューします。

各行は更新を表します。 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 と更新するフィールドが含まれている DataFrame。
id_column 必須	str レコード GUID を含む DataFrame 列の名前。
clear_nulls	bool `False` (既定値) の場合、NaN/None 値はスキップされます。 `True`すると、NaN/None はフィールドをクリアするために`null`を送信します。規定値: False

例外

型	説明
TypeError	`changes`が pandas DataFrame でない場合。
ValueError	`changes`が空の場合、`id_column`が見つからないか、ID が無効です。