Skip to content

Commit b726eeb

Browse files
committed
Align terminology: change 'Batch Operations' to 'Bulk Operations' to match Microsoft Dataverse Web API documentation
1 parent c1e1991 commit b726eeb

1 file changed

Lines changed: 8 additions & 8 deletions

File tree

README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ A Python client library for Microsoft Dataverse that provides a unified interfac
2222
- [Examples](#examples)
2323
- [Quick start](#quick-start)
2424
- [Basic CRUD operations](#basic-crud-operations)
25-
- [Batch operations](#batch-operations)
25+
- [Bulk operations](#bulk-operations)
2626
- [Query data](#query-data)
2727
- [Table management](#table-management)
2828
- [File operations](#file-operations)
@@ -32,7 +32,7 @@ A Python client library for Microsoft Dataverse that provides a unified interfac
3232

3333
## Key features
3434

35-
- **🔄 CRUD Operations**: Create, read, update, and delete records with support for batch operations and automatic retry
35+
- **🔄 CRUD Operations**: Create, read, update, and delete records with support for bulk operations and automatic retry
3636
- **⚡ True Bulk Operations**: Automatically uses Dataverse's native `CreateMultiple`, `UpdateMultiple`, and `BulkDelete` Web API operations for maximum performance and transactional integrity
3737
- **📊 SQL Queries**: Execute read-only SQL queries via the Dataverse Web API `?sql=` parameter
3838
- **🏗️ Table Management**: Create, inspect, and delete custom tables and columns programmatically
@@ -101,7 +101,7 @@ The SDK provides a simple, pythonic interface for Dataverse operations:
101101
| **DataverseClient** | Main entry point for all operations with environment connection |
102102
| **Records** | Dataverse records represented as Python dictionaries with logical field names |
103103
| **Logical Names** | Use table logical names (`"account"`) and column logical names (`"name"`) |
104-
| **Batch Operations** | Efficient batch processing for multiple records with automatic optimization |
104+
| **Bulk Operations** | Efficient bulk processing for multiple records with automatic optimization |
105105
| **Paging** | Automatic handling of large result sets with iterators |
106106
| **Structured Errors** | Detailed exception hierarchy with retry guidance and diagnostic information |
107107

@@ -146,21 +146,21 @@ client.update("account", account_id, {"telephone1": "555-0199"})
146146
client.delete("account", account_id)
147147
```
148148

149-
### Batch operations
149+
### Bulk operations
150150

151151
```python
152-
# Batch create
152+
# Bulk create
153153
payloads = [
154154
{"name": "Company A"},
155155
{"name": "Company B"},
156156
{"name": "Company C"}
157157
]
158158
ids = client.create("account", payloads)
159159

160-
# Batch update (broadcast same change to all)
160+
# Bulk update (broadcast same change to all)
161161
client.update("account", ids, {"industry": "Technology"})
162162

163-
# Batch delete
163+
# Bulk delete
164164
client.delete("account", ids, use_bulk_delete=True)
165165
```
166166

@@ -279,7 +279,7 @@ For optimal performance in production environments:
279279

280280
| Best Practice | Description |
281281
|---------------|-------------|
282-
| **Batch Operations** | Pass lists to `create()`, `update()`, and `delete()` for automatic bulk processing |
282+
| **Bulk Operations** | Pass lists to `create()`, `update()`, and `delete()` for automatic bulk processing |
283283
| **Select Fields** | Specify `select` parameter to limit returned columns and reduce payload size |
284284
| **Page Size Control** | Use `top` and `page_size` parameters to control memory usage |
285285
| **Connection Reuse** | Reuse `DataverseClient` instances across operations |

0 commit comments

Comments
 (0)