BatchRequest Klass

Builder för att konstruera och köra en Dataverse OData-begäran $batch .

Hämta via new (client.batch.new()). Lägg till åtgärder via records, tables, queryoch dataframe, om du vill gruppera skrivningar i en changesetoch anropa executesedan .

Åtgärder körs sekventiellt i den ordning som läggs till. BatchResult Resultatet innehåller en BatchItemResponse per HTTP-begäran som skickas (vissa åtgärder expanderas till flera begäranden).

Note

Maximalt 1 000 HTTP-åtgärder per batch.

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

Konstruktor

BatchRequest(client: DataverseClient)

Parametrar

Name Description
client
Obligatorisk

Metoder

changeset

Skapa en ny ChangeSet som är kopplad till den här batchen.

Ändringsuppsättningen läggs till i batchen omedelbart. Åtgärder som lagts till i returnerade ChangeSet via cs.records.* körs atomiskt.

Example:


   with batch.changeset() as cs:
       cs.records.create("account", {"name": "ACME"})
       cs.records.create("contact", {"firstname": "Bob"})
execute

Skicka batchen till Dataverse och returnera alla svar.

changeset

Skapa en ny ChangeSet som är kopplad till den här batchen.

Ändringsuppsättningen läggs till i batchen omedelbart. Åtgärder som lagts till i returnerade ChangeSet via cs.records.* körs atomiskt.

Example:


   with batch.changeset() as cs:
       cs.records.create("account", {"name": "ACME"})
       cs.records.create("contact", {"firstname": "Bob"})
changeset() -> ChangeSet

Returer

Typ Description

En ny ChangeSet redo att ta emot åtgärder.

execute

Skicka batchen till Dataverse och returnera alla svar.

execute(*, continue_on_error: bool = False) -> BatchResult

Parametrar

Name Description
continue_on_error
Obligatorisk

När false (standard) stoppas Dataverse vid det första felet och returnerar åtgärdens fel som ett 4xx-svar. När Sant Prefer: odata.continue-on-error skickas och alla åtgärder görs.

Keyword-Only parametrar

Name Description
continue_on_error
Standardvärde: False

Returer

Typ Description

BatchResult med en post per HTTP-åtgärd i sändningsordning.

Undantag

Typ Description

Om batchen överskrider 1 000 åtgärder eller om en kolumntyp som inte stöds anges.

Om förmatchningen av metadata misslyckas (tabellen eller kolumnen hittades inte) för tables.deletetables.add_columnstables.remove_columns

På HTTP-nivåfel (autentisering, serverfel osv.) som hindrar batchen från att köras.