batch Módulo

Wrappers orientados DataFrame para operações de registo em lote.

Fornece create, , e delete que aceitam pandas.DataFrame / pandas.Series entradas e as convertem em ditados padrão antes de entrar em fila updateno lote. Isto permite que os chamadores de ciência de dados alimentem DataFrames diretamente para um lote sem conversão manual.

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

Namespace para operações em lote (client.batch).

Acedido via client.batch. Use new para criar um BatchRequest construtor.

Example:

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

Operações de consulta sobre um BatchRequest.

Espelhos client.query exatamente: mesmos nomes de métodos, mesmas assinaturas. Todos os métodos retornam None; os resultados chegam via BatchResult.

Não instanciar diretamente; usar batch.query.

Operações de registo num BatchRequest.

Espelhos client.records: mesmos nomes de métodos, mesmas assinaturas. Todos os métodos retornam None; os resultados estão disponíveis via BatchResult after execute.

Métodos GA: retrieve (disco único) e list (multi-disco, página única). get está obsoleto — use retrieve em vez disso.

Não instanciar diretamente; usar batch.records.

Builder para construir e executar um pedido Dataverse OData $batch .

Obtém via new (client.batch.new()). Adicionar operações através de records, tables, query, e dataframe, opcionalmente agrupar escritas num changeset, e depois chamar execute.

As operações são executadas sequencialmente na ordem adicionada. O resultado BatchResult contém um BatchItemResponse por cada pedido HTTP despachado (algumas operações expandem-se para múltiplos pedidos).

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

Operações de metadados de tabela num BatchRequest.

Espelhos client.tables exatamente: mesmos nomes de métodos, mesmas assinaturas. Todos os métodos retornam None; os resultados chegam via BatchResult.

Não instanciar diretamente; usar batch.tables.

Um grupo transacional de operações de escrita de registo único.

Todas as operações têm sucesso ou são reunidas novamente. Use como gestor de contexto ou chamada records para adicionar operações diretamente.

Não instanciar diretamente; usar changeset.

Example:

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

Operações de escrita de registo disponíveis dentro de um ChangeSet.

Espelhos client.records , mas restritos a formulários de registo único (sem criar/atualizar/eliminar em massa). Apenas operações de escrita são permitidas — o GET não é permitido dentro de um conjunto de alterações.

Não instanciar diretamente; usar ChangeSet.records.