BatchRequest Klasa

Konstruktor do konstruowania i wykonywania żądania dataverse OData $batch .

Uzyskaj za pośrednictwem new (client.batch.new()). Dodaj operacje za pomocą recordspoleceń , , querytablesi dataframe, opcjonalnie grupuj zapisy do elementu , a następnie wywołaj metodę changesetexecute.

Operacje są wykonywane sekwencyjnie w kolejności dodanej. BatchResult Wynikowy zawiera jeden BatchItemResponse na żądanie HTTP wysłane (niektóre operacje rozszerzają się na wiele żądań).

Note

Maksymalna liczba operacji HTTP na partię wynosi 1000.

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)

Parametry

Nazwa Opis
client
Wymagane

Metody

changeset

Utwórz nową ChangeSet dołączoną do tej partii.

Zestaw zmian jest natychmiast dodawany do partii. Operacje dodane do zwróconych ChangeSet za pośrednictwem cs.records.* wykonywania niepodzielnego.

Example:


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

Prześlij partię do usługi Dataverse i zwróć wszystkie odpowiedzi.

changeset

Utwórz nową ChangeSet dołączoną do tej partii.

Zestaw zmian jest natychmiast dodawany do partii. Operacje dodane do zwróconych ChangeSet za pośrednictwem cs.records.* wykonywania niepodzielnego.

Example:


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

Zwraca

Typ Opis

Nowa ChangeSet gotowa do odbierania operacji.

execute

Prześlij partię do usługi Dataverse i zwróć wszystkie odpowiedzi.

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

Parametry

Nazwa Opis
continue_on_error
Wymagane

Gdy wartość false (wartość domyślna), usługa Dataverse zatrzymuje się na pierwszym błędzie i zwraca błąd tej operacji jako odpowiedź 4xx. Gdy wartość True jest wysyłana, Prefer: odata.continue-on-error a wszystkie operacje są podejmowane.

Parametry Tylko słowo kluczowe

Nazwa Opis
continue_on_error
Domyślna wartość: False

Zwraca

Typ Opis

BatchResult z jednym wpisem na operację HTTP w kolejności przesyłania.

Wyjątki

Typ Opis

Jeśli partia przekroczy 1000 operacji lub określono nieobsługiwany typ kolumny.

Jeśli wstępne rozwiązanie metadanych nie powiedzie się (nie znaleziono tabeli lub kolumny) dla polecenia tables.deletetables.add_columnstables.remove_columns

W przypadku błędów na poziomie HTTP (uwierzytelnianie, błąd serwera itp.), które uniemożliwiają wykonywanie partii.