batch Modulo

Wrapper orientati ai dataframe per le operazioni di record batch.

Fornisce create, updatee delete che accettano pandas.DataFrame / pandas.Series gli input e li convertono inct standard prima di accodare il batch. In questo modo i chiamanti di data science inseriscono i dataframe direttamente in un batch senza conversione manuale.

Accesso tramite batch.dataframe.

Esempio:

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

Spazio dei nomi per le operazioni batch (client.batch).

Accesso tramite client.batch. Usare new per creare un BatchRequest generatore.

Esempio:

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

Operazioni di query su un oggetto BatchRequest.

Rispecchia client.query esattamente: gli stessi nomi di metodo, le stesse firme. Tutti i metodi restituiscono None; i risultati arrivano tramite BatchResult.

Non creare un'istanza direttamente; usare batch.query.

Registrare le operazioni su un oggetto BatchRequest.

Mirror client.records: stessi nomi di metodo, stesse firme. Tutti i metodi restituiscono None. I risultati sono disponibili tramite BatchResult dopo execute.

Metodi GA: retrieve (singolo record) e list (multi-record, singola pagina). get è deprecato: usare retrieve invece.

Non creare un'istanza direttamente; usare batch.records.

Generatore per la costruzione e l'esecuzione di una richiesta OData $batch dataverse.

Ottenere tramite new (client.batch.new()). Aggiungere operazioni tramite records, tablesquery, e dataframe, facoltativamente raggruppare le scritture in un changesetoggetto , quindi chiamare execute.

Le operazioni vengono eseguite in sequenza nell'ordine aggiunto. Il risultato BatchResult contiene uno BatchItemResponse per ogni richiesta HTTP inviata (alcune operazioni si espandono a più richieste).

Esempio:

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

Operazioni sui metadati della tabella in un oggetto BatchRequest.

Rispecchia client.tables esattamente: gli stessi nomi di metodo, le stesse firme. Tutti i metodi restituiscono None; i risultati arrivano tramite BatchResult.

Non creare un'istanza direttamente; usare batch.tables.

Gruppo transazionale di operazioni di scrittura a record singolo.

Tutte le operazioni hanno esito positivo o vengono eseguito il rollback insieme. Usare come gestore del contesto o chiamare records direttamente per aggiungere operazioni.

Non creare un'istanza direttamente; usare changeset.

Esempio:

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

Registrare le operazioni di scrittura disponibili all'interno di un oggetto ChangeSet.

Mirror client.records ma limitato ai moduli a record singolo (nessuna creazione/aggiornamento/eliminazione in blocco). Sono consentite solo operazioni di scrittura: GET non è consentito all'interno di un insieme di modifiche.

Non creare un'istanza direttamente; usare ChangeSet.records.