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 Example:
|
| 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 |
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 |
|
|
På HTTP-nivåfel (autentisering, serverfel osv.) som hindrar batchen från att köras. |