Settings

Settings reference

Here is a complete list of settings which control default PynamoDB behavior.

connect_timeout_seconds

Default: 15

The time in seconds till a ConnectTimeoutError is thrown when attempting to make a connection.

read_timeout_seconds

Default: 30

The time in seconds till a ReadTimeoutError is thrown when attempting to read from a connection.

max_retry_attempts

Default: 3

The number of times to retry certain failed DynamoDB API calls. The most common cases eligible for retries include ProvisionedThroughputExceededException and 5xx errors.

base_backoff_ms

Default: 25

The base number of milliseconds used for exponential backoff and jitter on retries.

region

Default: "us-east-1"

The default AWS region to connect to.

max_pool_connections

Default: 10

The maximum number of connections to keep in a connection pool.

extra_headers

Default: None

A dictionary of headers that should be added to every request. This is only useful when interfacing with DynamoDB through a proxy, where headers are stripped by the proxy before forwarding along. Failure to strip these headers before sending to AWS will result in an InvalidSignatureException due to request signing.

host

Default: automatically constructed by boto to account for region

The URL endpoint for DynamoDB. This can be used to use a local implementation of DynamoDB such as DynamoDB Local or dynalite.

Overriding settings

Default settings may be overridden by providing a Python module which exports the desired new values. Set the PYNAMODB_CONFIG environment variable to an absolute path to this module or write it to /etc/pynamodb/global_default_settings.py to have it automatically discovered.