batch Modül

Toplu kayıt işlemleri için DataFrame odaklı sarmalayıcılar.

createGirişleri kabul / pandas.DataFramepandas.Series eden ve delete toplu iş üzerinde sıralamadan önce bunları standart diktelere dönüştüren , updateve sağlar. Bu, veri bilimi çağıranların DataFrame'leri el ile dönüştürme olmadan doğrudan bir toplu iş olarak beslemesine olanak tanır.

batch.dataframe aracılığıyla erişilir.

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

Toplu işlem (client.batch) için ad alanı.

client.batch aracılığıyla erişilir. Oluşturucu oluşturmak BatchRequest için kullanınnew.

Example:

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

üzerinde BatchRequestsorgu işlemleri.

Tam olarak yansıtmalar client.query : aynı yöntem adları, aynı imzalar. Tüm yöntemler döndürür None; sonuçlar aracılığıyla BatchResultulaşır.

Doğrudan örnek oluşturmayın; kullanın batch.query.

üzerinde işlemleri BatchRequestkaydedin.

Yansıtmalar client.records: aynı yöntem adları, aynı imzalar. Tüm yöntemler döndürürNone; sonuçlar ile sonra executekullanılabilirBatchResult.

GA yöntemleri: retrieve (tek kayıt) ve list (çoklu kayıt, tek sayfa). get kullanım dışı bırakıldı; bunun yerine kullanın retrieve .

Doğrudan örnek oluşturmayın; kullanın batch.records.

Dataverse OData $batch isteği oluşturmak ve yürütmek için oluşturucu.

(client.batch.new()) aracılığıyla new alın. , , querytables, ve aracılığıyla recordsişlemler ekleyin, dataframeisteğe bağlı olarak yazma işlemlerini bir changesetiçine gruplandırıp çağrısı yapınexecute.

İşlemler eklenen sırayla sıralı olarak yürütülür. BatchResult Sonuçta gönderilen HTTP isteği başına bir tane BatchItemResponse bulunur (bazı işlemler birden çok isteğe genişletilir).

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

Üzerinde BatchRequesttablo meta veri işlemleri.

Tam olarak yansıtmalar client.tables : aynı yöntem adları, aynı imzalar. Tüm yöntemler döndürür None; sonuçlar aracılığıyla BatchResultulaşır.

Doğrudan örnek oluşturmayın; kullanın batch.tables.

Tek kayıtlı yazma işlemlerinin işlem grubu.

Tüm işlemler başarılı olur veya birlikte geri alınır. İşlemleri doğrudan eklemek için bağlam yöneticisi veya çağrı records olarak kullanın.

Doğrudan örnek oluşturmayın; kullanın changeset.

Example:

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

içinde ChangeSetkullanılabilen kayıt yazma işlemleri.

Yansıtmalar client.records ancak tek kayıtlı formlarla sınırlıdır (toplu oluşturma/güncelleştirme/silme işlemi yapılmaz). Yalnızca yazma işlemlerine izin verilir— Değişiklik kümesi içinde GET'e izin verilmez.

Doğrudan örnek oluşturmayın; kullanın ChangeSet.records.