awswrangler.dynamodb.put_items

awswrangler.dynamodb.put_items(items: list[dict[str, Any]] | list[Mapping[str, Any]], table_name: str, boto3_session: Session | None = None, use_threads: bool | int = True) None

Insert all items to the specified DynamoDB table.

Note

Following arguments are not supported in distributed mode with engine EngineEnum.RAY:

  • boto3_session

Note

This function has arguments which can be configured globally through wr.config or environment variables:

Check out the Global Configurations Tutorial for details.

Parameters:
  • items (Union[List[Dict[str, Any]], List[Mapping[str, Any]]]) – List which contains the items that will be inserted.

  • table_name (str) – Name of the Amazon DynamoDB table.

  • boto3_session (boto3.Session(), optional) – Boto3 Session. The default boto3 Session will be used if boto3_session receive None.

  • use_threads (Union[bool, int]) – Used for Parallel Write requests. True (default) to enable concurrency, False to disable multiple threads. If enabled os.cpu_count() is used as the max number of threads. If integer is provided, specified number is used.

Returns:

None.

Return type:

None

Examples

Writing items

>>> import awswrangler as wr
>>> wr.dynamodb.put_items(
...     items=[{'key': 1}, {'key': 2, 'value': 'Hello'}],
...     table_name='table'
... )