batch Moduł

Otoki zorientowane na ramki danych na potrzeby operacji rekordów wsadowych.

Udostępnia createelement , updatei , który delete akceptuje pandas.DataFrame / pandas.Series dane wejściowe i konwertuje je na standardowe dykty przed kolejkowaniem w partii. Dzięki temu osoby wywołujące dane są przekazywane bezpośrednio do partii bez ręcznej konwersji.

Dostęp jest uzyskiwany za pośrednictwem 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()

Przestrzeń nazw dla operacji wsadowych (client.batch).

Dostęp jest uzyskiwany za pośrednictwem client.batch. Użyj new polecenia , aby utworzyć konstruktora BatchRequest .

Example:

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

Operacje zapytań na obiekcie BatchRequest.

Dublowania client.query dokładnie: te same nazwy metod, te same podpisy. Wszystkie metody zwracają None; wyniki docierają za pośrednictwem metody BatchResult.

Nie twórz wystąpień bezpośrednio; użyj polecenia batch.query.

Rejestrowanie operacji na obiekcie BatchRequest.

Dublowania client.records: te same nazwy metod, te same podpisy. Wszystkie metody zwracają None; wyniki są dostępne za pośrednictwem BatchResult polecenia po execute.

Metody ga: retrieve (pojedynczy rekord) i list (wiele rekordów, pojedyncza strona). get jest przestarzały — zamiast tego użyj polecenia retrieve .

Nie twórz wystąpień bezpośrednio; użyj polecenia batch.records.

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ń).

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

Operacje metadanych tabeli na obiekcie BatchRequest.

Dublowania client.tables dokładnie: te same nazwy metod, te same podpisy. Wszystkie metody zwracają None; wyniki docierają za pośrednictwem metody BatchResult.

Nie twórz wystąpień bezpośrednio; użyj polecenia batch.tables.

Transakcyjna grupa operacji zapisu z jednym rekordem.

Wszystkie operacje kończą się powodzeniem lub są przywracane razem. Użyj jako menedżera kontekstu lub wywołania records , aby dodać operacje bezpośrednio.

Nie twórz wystąpień bezpośrednio; użyj polecenia changeset.

Example:

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

Rejestruj operacje zapisu dostępne wewnątrz elementu ChangeSet.

Dublowania, ale ograniczone do formularzy client.records z pojedynczym rekordem (nie można tworzyć/aktualizować/usuwać zbiorczo). Dozwolone są tylko operacje zapisu — funkcja GET nie jest dozwolona wewnątrz zestawu zmian.

Nie twórz wystąpień bezpośrednio; użyj polecenia ChangeSet.records.