中級読了 5 分

ExtendDB: 自分のデータベースで DynamoDB API を動かす

ExtendDB は、DynamoDB のワイヤプロトコルを話しながら、データを あなたが運用するデータベースに格納する、AWS 製のオープンソースアダプターです。DynamoDB API に対して書かれたコードを、マネージドの DynamoDB が届かない場所で動かすためにあります。オンプレミスのネットワーク、エアギャップされた拠点、インターネットのないノート PC などです。

ExtendDB とは?

ExtendDB は、自分で運用する PostgreSQL などのデータベースの上に DynamoDB JSON ワイヤプロトコルを実装した、AWS のオープンソースアダプター(Rust 製)です。既存の AWS SDK と AWS CLI はそのまま動き続け、変わるのはエンドポイントの URL と認証情報だけです。つまり、マネージドのクラウドサービスにデータを送らずに DynamoDB API を手に入れられます。

AWS の DynamoDB エンジニアによって書かれ、 AWS Database Blog で発表されました。

API の背後には プラガブルなストレージレイヤー があります。PostgreSQL がデフォルトのバックエンドで、リポジトリは SQLite と MongoDB のバックエンドもビルドします。バイナリごとに 1 つで、ビルド時に選択します(DynamoDB との違い)。発表記事は、"without modifying the core" に追加できるバックエンドとして Apache Cassandra を挙げています。

リクエストはこう流れます。

DynamoDB JSONワイヤプロトコル読み取り / 書き込みあなたのアプリ(AWS SDKは変更なし)ExtendDB(Rust アダプター)PostgreSQL(あなたのデータ、あなたのディスク)

何をサポートし、何をサポートしないか

リポジトリと発表記事によれば、ExtendDB(v0.1)は、ほとんどのアプリケーションが呼び出す操作をカバーしています。

  • テーブル:Create、Delete、Describe、List、Update。
  • アイテム:Put、Get、Delete、Update(SET / REMOVE / ADD / DELETE の更新アクションを含む)。
  • Query と Scan:キー条件、、射影、ページネーション、セカンダリインデックス。
  • バッチ:BatchGetItem と BatchWriteItem。
  • :TransactGetItems と TransactWriteItems。
  • 、、タグ。
  • インポート/エクスポート:S3 ではなく、ローカルファイルシステムのパスとの間で行います。

実装していない ものは UnknownOperationException を返します。

  • Global Tables とクロスリージョンレプリケーション。AWS はこれらを "DynamoDB-specific managed features" と呼んでいます。
  • PartiQL(ExecuteStatement、BatchExecuteStatement、ExecuteTransaction)。それらの読み書きは、代わりに式 API で書きます。

DynamoDB Local との違い

オフライン開発のために、すでに DynamoDB Local を使っているかもしれません。あちらは 1 台のマシンでのテストを想定した単一の JAR(または amazon/dynamodb-local の Docker イメージ)で、認証もスロットリングもありません。

ExtendDB の README は、ローカル開発、CI、セルフホストのデプロイ(オンプレミス、プライベートクラウド、エッジ)、マルチクラウド、エアギャップ環境をユースケースとして挙げています。AWS は現在のリリースの範囲をもっと狭く定めています: "This is a v0.1 release for development, testing, and experimentation."

マネージドの DynamoDB との違い

AWS は発表記事でこう線を引いています。

ExtendDB は DynamoDB ではありません。互換実装であって、マネージドサービスの置き換えではありません。パフォーマンス特性、スケーリングの挙動、運用上の性質は異なります。

具体的に、ExtendDB を運用するとこうなります。

  • データベースの可用性とバックアップはあなたの責任です。 マネージドのマルチ AZ 耐久性やポイントインタイムリカバリはありません。それはあなたの PostgreSQL 運用の仕事です。
  • TLS は必須です。 extenddb init が自己署名証明書を生成し、クライアントはそれを信頼する必要があります。
  • アクセス制御は ExtendDB 独自のものです。 SigV4 署名を検証し、IAM 互換のユーザー、グループ、ロール、ポリシーを評価しますが、それらは ExtendDB の中にあり、AWS アカウントの IAM とは "cannot be shared" です。
  • キャパシティは強制されます。 スロットリングはデフォルトで有効で(テーブル/パーティションごとのトークンバケット、throttling_enabled 設定)、オンデマンドのテーブルには 4,000 WCU / 12,000 RCU の固定バーストが与えられ、オートスケーリングはありません。

これは v0.1 で、ライセンスは Apache 2.0 です。依存する前に、自分のワークロードでベンチマークを取りましょう。

クラウドと比べると、同じ呼び出しはマネージドのオンデマンド DynamoDB では、1 KB の PutItem に 1 書き込みリクエストユニット、最大 4 KB の結果整合性の GetItem に 0.5 読み取りリクエストユニットが課金されます。同じアクセスパターンのクラウドでの料金は料金計算ツールで見積もってください。

セットアップ

ExtendDB は Linux と macOS で動作し、必要なのは Rust 1.88+ と PostgreSQL 14+ です。ビルドし、初期化してから、サーバーを起動します(README)。

cargo build --release
./target/release/extenddb init      # databases, admin credentials, TLS cert, config file
./target/release/extenddb serve --config extenddb.toml

serve はデフォルトでデーモン化します。コンテナ内やプロセススーパーバイザーの下では --foreground を付けます。リポジトリには scripts/install-linux.sh と scripts/install-macos.sh も含まれています。サーバーは https://127.0.0.1:18443 で待ち受けます。

すべてのリクエストは ExtendDB 独自のストアのキーで署名する必要があるため、ユーザーを作成し、 DynamoDB へのアクセスを付与して、キーを発行します。init が表示する管理者パスワードとアカウント ID を使います(入門ガイド)。

./target/release/extenddb manage --user admin --password <admin-pw> \
    create-user --account-id <account-id> --user-name alice --user-password secret
./target/release/extenddb manage --user admin --password <admin-pw> \
    put-user-policy --account-id <account-id> --user-name alice --policy-name FullAccess \
    --policy-document '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":"dynamodb:*","Resource":"*"}]}'
./target/release/extenddb manage --user <account-id>/alice --password secret create-access-key

次に証明書を信頼し、そのキーで SDK をエンドポイントに向けます。AWS CLI とほとんどの SDK では AWS_CA_BUNDLE=~/.extenddb/tls/cert.pem を設定し、Node では NODE_EXTRA_CA_CERTS="$HOME/.extenddb/tls/cert.pem" を付けて実行します。

import {DynamoDBClient} from '@aws-sdk/client-dynamodb';

const client = new DynamoDBClient({
  endpoint: 'https://127.0.0.1:18443',
  region: 'us-east-1',
  credentials: {accessKeyId: '<access-key-id>', secretAccessKey: '<secret-access-key>'}
});

クライアントの設定から先(PutItem、Query、TransactWriteItems)は、マネージド DynamoDB に対して書くコードと同一です。シングルテーブルのアイテムレイアウトも、クラウドとまったく同じように機能します。

PKSKtypebackendcreatedAt
TENANT#acmeAUDIT#2026-06-24eventpostgres2026-06-24T09:00:00Z
TENANT#acmeAUDIT#2026-06-24beventpostgres2026-06-24T09:01:12Z
TENANT#betaAUDIT#2026-06-24eventpostgres2026-06-24T09:02:40Z

ExtendDB のデータを閲覧する

ExtendDB の Web コンソール(https://127.0.0.1:18443/console/)が管理するのはアカウント、ユーザー、ポリシー、アクセスキーで、アイテムではありません。データを見るには、セットアップで用意した環境変数で AWS CLI を使います。

export AWS_CA_BUNDLE=~/.extenddb/tls/cert.pem
export AWS_ENDPOINT_URL_DYNAMODB=https://127.0.0.1:18443
export AWS_ACCESS_KEY_ID=<access-key-id> AWS_SECRET_ACCESS_KEY=<secret-access-key>
aws dynamodb scan --table-name AppData --region us-east-1 --max-items 25

DynoTable は現時点では ExtendDB に接続できません。DynoTable のオフラインプロファイルは平文の http://localhost:<port> と通信し、固定の使い捨てキーで署名しますが、ExtendDB が受け付けるのは独自のストアのキーで署名された HTTPS リクエストだけです。また、DynoTable の PartiQL エディタは、実装されていない ExecuteStatement に突き当たります。

落とし穴

  • v0.1 を本番 DynamoDB として扱わない。 スケーリング、レイテンシ、耐久性は AWS のものではなくあなたの PostgreSQL のものです。依存する前に、自分のワークロードでベンチマークを取りましょう。
  • Global Tables もクロスリージョンレプリケーションもない。 別拠点にコピーを置くには、README が勧めるとおり PostgreSQL の標準的なレプリケーションと HA のツールを使います(たとえばスタンバイへのストリーミングレプリケーション)。それで得られるのは単一のライターで、アクティブ・アクティブではありません。マルチリージョンのアクティブ・アクティブな書き込みが必要なら、それはマネージド DynamoDB のグローバルテーブルです。
  • 裏側のデータベースは自分でバックアップする。 マネージドの PITR はありません。PostgreSQL のボリュームを落としたら終わりです。他の PostgreSQL と同じように pg_dump や WAL アーカイブを組んでおきましょう。
  • ポリシーは ExtendDB のもので、AWS アカウントのものではない。 ポリシーは extenddb manage … put-user-policy で書きます。AWS IAM のロールやポリシーは適用されません。

次のステップ

  • まずアクセスパターンをモデリングしましょう。バックエンドが DynamoDB でも PostgreSQL 経由の ExtendDB でも、同じシングルテーブル設計の作法が当てはまります。
  • 読み書きを DynamoDB 式ビルダーで組み立てて確認し、 DynamoDB JSON コンバータで素の JSON とワイヤ形式のあいだでフィクスチャを変換しましょう。
  • DynamoDB Local とマネージドのテーブルについては、 DynoTable で閲覧、クエリ、編集のための GUI が使えます。

著者: Dmitriy · 更新日