@aws-sdk/util-dynamodb

What is @aws-sdk/util-dynamodb?

The @aws-sdk/util-dynamodb package is part of the AWS SDK for JavaScript v3. It provides utility functions to serialize JavaScript objects into the DynamoDB record format and deserialize DynamoDB records into JavaScript objects. This is particularly useful when working with AWS DynamoDB, allowing developers to easily convert data between the formats used by their applications and the database.

What are @aws-sdk/util-dynamodb's main functionalities?

Marshall

Converts a JavaScript object into a DynamoDB record format. Useful for preparing data to be sent to DynamoDB.

const { marshall } = require('@aws-sdk/util-dynamodb');
const item = { id: 1, content: 'Hello World' };
const marshalledItem = marshall(item);
console.log(marshalledItem);

Unmarshall

Converts a DynamoDB record into a JavaScript object. This is useful when retrieving data from DynamoDB and using it within a JavaScript application.

const { unmarshall } = require('@aws-sdk/util-dynamodb');
const dynamoRecord = { id: { N: '1' }, content: { S: 'Hello World' } };
const item = unmarshall(dynamoRecord);
console.log(item);

ConvertEmptyValues

Allows the conversion of empty values (like null) to a specific DynamoDB type when marshalling. This helps in maintaining data consistency when storing in DynamoDB.

const { marshall } = require('@aws-sdk/util-dynamodb');
const item = { id: 1, content: null };
const options = { convertEmptyValues: true };
const marshalledItem = marshall(item, options);
console.log(marshalledItem);

Other packages similar to @aws-sdk/util-dynamodb

dynamodb-data-types

This package offers similar functionalities for attribute value wrapping and unwrapping for DynamoDB. It differs from @aws-sdk/util-dynamodb by being less integrated with the AWS SDK, potentially offering more flexibility in non-AWS SDK contexts.

README

@aws-sdk/util-dynamodb

This package provides utilities to be used with @aws-sdk/client-dynamodb

Convert JavaScript object into DynamoDB Record

const { DynamoDB } = require("@aws-sdk/client-dynamodb");
const { marshall } = require("@aws-sdk/util-dynamodb");

const client = new DynamoDB(clientParams);
const params = {
  TableName: "Table",
  Item: marshall({
    HashKey: "hashKey",
    NumAttribute: 1,
    BoolAttribute: true,
    ListAttribute: [1, "two", false],
    MapAttribute: { foo: "bar" },
    NullAttribute: null,
  }),
};

await client.putItem(params);

Convert DynamoDB Record into JavaScript object

const { DynamoDB } = require("@aws-sdk/client-dynamodb");
const { marshall, unmarshall } = require("@aws-sdk/util-dynamodb");

const client = new DynamoDB(clientParams);
const params = {
  TableName: "Table",
  Key: marshall({
    HashKey: "hashKey",
  }),
};

const { Item } = await client.getItem(params);
unmarshall(Item);

Changelog

1.0.0-rc.8 (2020-12-05)

Bug Fixes

• client-s3: fix union serialization (#1730) (6437e24)
• client-sts: disable auth for public assumeRole commands (#1706) (891eae2)
• codegen: checkstyle errors in AddBuiltinPlugins.java (#1731) (48c02f4)
• middleware-sdk-sqs: Fix MD5 verification on SendMessageBatch. (#1666) (049f45e)
• s3-request-presigner: skip hoisting SSE headers (#1701) (1ec70ff)

Features

• update clients as of 11/20/2020 (#1711) (e932876)
• update clients as of 11/30/2020 (#1734) (a1e8036)
• update clients as of 12/3/2020 (#1741) (58383dc)
• invalid-dependency: add invalidAsyncFunction which rejects with an Error (#1719) (c4c046e)