docs: add max_read_workers config documentation for DynamoDB online store

abhijeet-dhumal · abhijeet-dhumal · commit dbaf79980c45 · 2026-03-02T19:14:12.000+05:30
Add Configuration section documenting:
- Configuration options table with max_read_workers, batch_size, consistent_reads, etc.
- Performance tuning guidance for parallel batch reads
- Example feature_store.yaml with tuning options

Signed-off-by: abhijeet-dhumal &lt;abhijeetdhumal652@gmail.com&gt;
Made-with: Cursor
diff --git a/docs/reference/online-stores/dynamodb.md b/docs/reference/online-stores/dynamodb.md
@@ -22,6 +22,47 @@ online_store:
 
 The full set of configuration options is available in [DynamoDBOnlineStoreConfig](https://rtd.feast.dev/en/master/#feast.infra.online_stores.dynamodb.DynamoDBOnlineStoreConfig).
 
+## Configuration
+
+Below is a example with performance tuning options:
+
+{% code title="feature_store.yaml" %}
+```yaml
+project: my_feature_repo
+registry: data/registry.db
+provider: aws
+online_store:
+  type: dynamodb
+  region: us-west-2
+  batch_size: 100
+  max_read_workers: 10
+  consistent_reads: false
+```
+{% endcode %}
+
+### Configuration Options
+
+| Option | Type | Default | Description |
+| ------ | ---- | ------- | ----------- |
+| `region` | string | | AWS region for DynamoDB |
+| `table_name_template` | string | `{project}.{table_name}` | Template for table names |
+| `batch_size` | int | `40` | Number of items per BatchGetItem/BatchWriteItem request (max 100) |
+| `max_read_workers` | int | `10` | Maximum parallel threads for batch read operations. Higher values improve throughput for large batch reads but increase resource usage |
+| `consistent_reads` | bool | `false` | Whether to use strongly consistent reads (higher latency, guaranteed latest data) |
+| `tags` | dict | `null` | AWS resource tags added to each table |
+| `session_based_auth` | bool | `false` | Use AWS session-based client authentication |
+
+### Performance Tuning
+
+**Parallel Batch Reads**: When reading features for many entities, DynamoDB's BatchGetItem is limited to 100 items per request. For 500 entities, this requires 5 batch requests. The `max_read_workers` option controls how many of these batches execute in parallel:
+
+- **Sequential (old behavior)**: 5 batches × 10ms = 50ms total
+- **Parallel (with `max_read_workers: 10`)**: 5 batches in parallel ≈ 10ms total
+
+For high-throughput workloads with large entity counts, increase `max_read_workers` (up to 20-30) based on your DynamoDB capacity and network conditions.
+
+**Batch Size**: Increase `batch_size` up to 100 to reduce the number of API calls. However, larger batches may hit DynamoDB's 16MB response limit for tables with large feature values.
+
 ## Permissions
 
 Feast requires the following permissions in order to execute commands for DynamoDB online store:
