batch Modul

DataFrame-orienterade omslutningar för batchpoståtgärder.

Tillhandahåller create, updateoch delete som accepterarpandas.Series / pandas.DataFrame indata och konverterar dem till standarddiktor innan de skickas i batchen. På så sätt kan datavetenskapsuppringare mata dataramar direkt till en batch utan manuell konvertering.

Nås via 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()

Namnområde för batchåtgärder (client.batch).

Nås via client.batch. Använd new för att skapa en BatchRequest byggare.

Example:

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

Frågeåtgärder på en BatchRequest.

client.query Speglar exakt: samma metodnamn, samma signaturer. Alla metoder returnerar None; resultaten anländer via BatchResult.

Instansiera inte direkt; använd batch.query.

Registrera åtgärder på en BatchRequest.

Speglar client.records: samma metodnamn, samma signaturer. Alla metoder returnerar None; resultaten är tillgängliga via BatchResult efter execute.

GA-metoder: retrieve (enkel post) och list (flera poster, en enda sida). get är inaktuell – använd retrieve i stället.

Instansiera inte direkt; använd batch.records.

Builder för att konstruera och köra en Dataverse OData-begäran $batch .

Hämta via new (client.batch.new()). Lägg till åtgärder via records, tables, queryoch dataframe, om du vill gruppera skrivningar i en changesetoch anropa executesedan .

Åtgärder körs sekventiellt i den ordning som läggs till. BatchResult Resultatet innehåller en BatchItemResponse per HTTP-begäran som skickas (vissa åtgärder expanderas till flera begäranden).

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

Tabellmetadataåtgärder på en BatchRequest.

client.tables Speglar exakt: samma metodnamn, samma signaturer. Alla metoder returnerar None; resultaten anländer via BatchResult.

Instansiera inte direkt; använd batch.tables.

En transaktionsgrupp med skrivåtgärder med en post.

Alla åtgärder lyckas eller återställs tillsammans igen. Använd som kontexthanterare eller anrop records för att lägga till åtgärder direkt.

Instansiera inte direkt; använd changeset.

Example:

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

Postskrivningsåtgärder som är tillgängliga i en ChangeSet.

Speglar men begränsas client.records till formulär med en post (ingen massgenerering/uppdatering/borttagning). Endast skrivåtgärder tillåts – GET tillåts inte i en ändringsuppsättning.

Instansiera inte direkt; använd ChangeSet.records.