batch Modul

Pembungkus berorientasi DataFrame untuk operasi rekaman batch.

Menyediakan create, update, dan delete yang menerima pandas.DataFrame / pandas.Series input dan mengonversinya ke dict standar sebelum mengantre pada batch. Ini memungkinkan pemanggil ilmu data memberi umpan DataFrames langsung ke dalam batch tanpa konversi manual.

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

Namespace untuk operasi batch (client.batch).

Diakses melalui client.batch. Gunakan new untuk membuat penyusun BatchRequest .

Example:

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

Operasi kueri pada BatchRequest.

client.query Cermin persis: nama metode yang sama, tanda tangan yang sama. Semua metode kembali None; hasil tiba melalui BatchResult.

Jangan membuat instans secara langsung; gunakan batch.query.

Rekam operasi pada BatchRequest.

client.recordsCermin : nama metode yang sama, tanda tangan yang sama. Semua metode kembali None; hasil tersedia melalui BatchResult setelah execute.

Metode GA: retrieve (rekaman tunggal) dan list (multi-rekaman, satu halaman). get tidak digunakan lagi — gunakan retrieve sebagai gantinya.

Jangan membuat instans secara langsung; gunakan batch.records.

Penyusun untuk membangun dan menjalankan permintaan Dataverse OData $batch .

Dapatkan melalui new (client.batch.new()). Tambahkan operasi melalui records, , tablesquery, dan dataframe, secara opsional mengelompokkan changesetpenulisan ke dalam , lalu panggil execute.

Operasi dijalankan secara berurutan dalam urutan yang ditambahkan. Hasilnya BatchResult berisi satu BatchItemResponse per permintaan HTTP yang dikirim (beberapa operasi diperluas ke beberapa permintaan).

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

Operasi metadata tabel pada BatchRequest.

client.tables Cermin persis: nama metode yang sama, tanda tangan yang sama. Semua metode kembali None; hasil tiba melalui BatchResult.

Jangan membuat instans secara langsung; gunakan batch.tables.

Grup transaksional operasi penulisan catatan tunggal.

Semua operasi berhasil atau digulung balik bersama-sama. Gunakan sebagai manajer konteks atau panggil records untuk menambahkan operasi secara langsung.

Jangan membuat instans secara langsung; gunakan changeset.

Example:

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

Catat operasi tulis yang tersedia di dalam ChangeSet.

client.records Cermin tetapi dibatasi untuk formulir rekaman tunggal (tidak ada pembuatan/pembaruan/penghapusan massal). Hanya operasi tulis yang diizinkan — GET tidak diizinkan di dalam set perubahan.

Jangan membuat instans secara langsung; gunakan ChangeSet.records.