batch Modul

A Dataverse SDK kötegművelet-névterei.

Osztályok

BatchDataFrameOperations

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

Névtér kötegműveletekhez (client.batch).

Elérhető ezen keresztül: client.batch. Szerkesztő létrehozásához BatchRequest használhatónew.

Example:


   batch = client.batch.new()
   batch.records.create("account", {"name": "Fabrikam"})
   result = batch.execute()
BatchQueryOperations

Lekérdezési műveletek egy BatchRequest.

Pontosan tükröz: client.query azonos metódusnevek, azonos aláírások. Minden metódus visszaad None; az eredmények a következőn keresztül BatchResultérkeznek:

Ne példányosíts közvetlenül; használja a ..a0

BatchRecordOperations

Műveletek rögzítése egy BatchRequest.

Tükrözések client.records: azonos metódusnevek, azonos aláírások. Minden metódus visszaadNone; az eredmények a következőn executekeresztül BatchResult érhetők el.

Ga metódusok: retrieve (egy rekord) és list (többrekordos, egyoldalas). get elavult – használja retrieve helyette.

Ne példányosíts közvetlenül; használja a ..a0

BatchRequest

Dataverse OData-kérés $batch létrehozására és végrehajtására szolgáló Builder.

Szerezze be a (client.batch.new()) segítségével new . Adjon hozzá műveleteket recordsa , tables, queryés dataframe, opcionálisan csoport írási egy changeset, majd hívás execute.

A műveletek végrehajtása sorrendben történik a hozzáadott sorrendben. Az eredményül kapott BatchResult HTTP-kérésenként egy BatchItemResponse van elküldve (egyes műveletek több kérelemre bonthatók ki).

Megjegyzés:

Kötegenként legfeljebb 1000 HTTP-művelet.

Example:


   batch = client.batch.new()
   batch.records.create("account", {"name": "Contoso"})
   batch.tables.get("account")
   with batch.changeset() as cs:
       ref = cs.records.create("contact", {"firstname": "Alice"})
       cs.records.update("account", account_id, {
           "primarycontactid@odata.bind": ref
       })
   result = batch.execute()
BatchTableOperations

Tábla metaadat-műveletei egy BatchRequest.

Pontosan tükröz: client.tables azonos metódusnevek, azonos aláírások. Minden metódus visszaad None; az eredmények a következőn keresztül BatchResultérkeznek:

Megjegyzés:

tables.delete, tables.add_columns és tables.remove_columns

metaadat-keresés (GET EntityDefinitions) megkövetelése:

execute a tábla metaadat-azonosítójának feloldásához.

Ez a keresés transzparens a hívó számára.

Megjegyzés:

tables.add_columns és tables.remove_columns mindegyik egy-egy

kötegelem oszloponként, így több bejegyzést is adnak hozzá

responses.

Ne példányosíts közvetlenül; használja a ..a0

ChangeSet

Egyrekordos írási műveletek tranzakciós csoportja.

Minden művelet sikeres vagy újra együtt lesz. Használja környezetkezelőként vagy hívásként records a műveletek közvetlen hozzáadásához.

Ne példányosíts közvetlenül; használja a ..a0

Example:


   with batch.changeset() as cs:
       ref = cs.records.create("contact", {"firstname": "Alice"})
       cs.records.update("account", account_id, {
           "primarycontactid@odata.bind": ref
       })
ChangeSetRecordOperations

Rekordírási műveletek egy adott fájlban ChangeSet.

Tükröz, client.records de egyrekordos űrlapokra korlátozódik (nincs tömeges létrehozás/frissítés/törlés). Csak írási műveletek engedélyezettek – a GET nem engedélyezett egy módosítási halmazon belül.

Ne példányosíts közvetlenül; használja a ..a0