はじめに

この記事では、AWSのDynamoDBをローカル環境で再現する方法について紹介します。

本番環境と同じようなAPIで開発・テストを行える「DynamoDB Local」を使うことで、インターネット接続やAWSアカウントが不要になります。

参考文献

個人のまとめ記事となっておりますが、温かい目で見守っていただければ幸いです。

書こうと思ったきっかけ

個人的な開発の一環で、DynamoDBをローカルで試したい場面がありました。

本番環境への影響を避けつつ、スムーズに開発を進めるために、ローカル環境でのDynamoDB構築手順を記事にまとめておこうと思いました。

DynamoDB Localとは？

AWS公式のDynamoDBエミュレーター（ローカル実行）
本番と同じAPI（boto3など）で操作可能
インターネット不要、無料で利用可能

参考文献

実際にやってみた（おすすめはDocker）

最小構成（とりあえず動かすだけ）

docker run -d -p 8000:8000 amazon/dynamodb-local

-d：バックグラウンド実行
-p 8000:8000：ホスト → コンテナのポート転送

起動後の画面

DynamoDB Local が正しく起動しているか確認するために実行した docker ps コマンドの出力ログです。

データ永続化付き（再起動しても保持）

docker run -d -p 8000:8000 \
  -v $PWD/dynamodb_data:/home/dynamodblocal/data \
  amazon/dynamodb-local \
  -jar DynamoDBLocal.jar -sharedDb -dbPath /home/dynamodblocal/data

-v：永続化ディレクトリマウント
-sharedDb：単一DBファイルで共有
-dbPath：データ保存パス指定

docker-composeを使う場合

version: '3.8'

services:
  dynamodb:
    image: amazon/dynamodb-local
    container_name: macbookpro-dynamodb-1
    ports:
      - "8000:8000"
    volumes:
      - ./dynamodb_data:/home/dynamodblocal/data
    command: ["-jar", "DynamoDBLocal.jar", "-sharedDb", "-dbPath", "/home/dynamodblocal/data"]

起動：

docker compose up -d

確認コマンド（もちろんデータは空）：

aws dynamodb list-tables --endpoint-url http://localhost:8000

レスポンス例：

{"TableNames":[]}

データを入れて確認してみた

1. boto3 のインストール

まずは AWS SDK for Python（boto3）をインストールします。

pip install boto3

※ すでにインストールされている場合はこのステップは不要です。

こんな感じで問題なくインストールできました

2. テーブル作成用Pythonスクリプト

以下のコードを create_table.py という名前で保存します。

# create_table.py
import boto3

# DynamoDBローカルに接続（endpoint_url を忘れずに）
dynamodb = boto3.client('dynamodb', endpoint_url='http://localhost:8000')

# "Users" テーブルを作成
dynamodb.create_table(
    TableName='Users',
    KeySchema=[
        {'AttributeName': 'id', 'KeyType': 'HASH'}  # パーティションキー
    ],
    AttributeDefinitions=[
        {'AttributeName': 'id', 'AttributeType': 'S'}  # 文字列型
    ],
    ProvisionedThroughput={
        'ReadCapacityUnits': 5,
        'WriteCapacityUnits': 5
    }
)

print("作成しました！")

3. スクリプトの実行

ターミナルで以下のコマンドを実行します：

python create_table.py

成功すれば以下のように表示されます：

作成しました！

確認コマンド（"Users" テーブルが作成されている）：

aws dynamodb list-tables --endpoint-url http://localhost:8000

レスポンス例：

{
    "TableNames": [
        "Users"
    ]
}

実際のターミナル画面

まとめ

ここまで読んでいただき、ありがとうございました！ローカルでDynamoDBの挙動を検証したい場合、DynamoDB Localがとても簡単で便利だと感じました！

今後の開発でも役立つので、手元に環境を整えておくと安心だと思いました...！