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 Example:
|
| 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, |
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 |
|
|
W przypadku błędów na poziomie HTTP (uwierzytelnianie, błąd serwera itp.), które uniemożliwiają wykonywanie partii. |