メニュー
Amazon DynamoDB
開発者ガイド (API Version 2012-08-10)

DynamoDB ローカル (ダウンロード可能バージョン) のセットアップ

ダウンロード可能なバージョンの DynamoDB では、DynamoDB ウェブサービスにアクセスせずに、アプリケーションを記述してテストすることができます。代わりに、データベースはコンピュータ上で自己完結型となります。ただし、本稼働環境でアプリケーションをデプロイする場合、DynamoDB ウェブサービスを使用できるようにコードに微調整を加えることができます。

このローカルバージョンを使用することで、プロビジョニングされたスループットやデータストレージ、データ転送料金を節約しやすくなります。また、アプリケーションを開発している間インターネットに接続しておく必要はありません。

コンピュータに DynamoDB をダウンロードして実行する

ダウンロード可能なバージョンの DynamoDB は、実行可能な .jar ファイルとして提供されます。 アプリケーションは、Windows、Linux、macOS X、および Java をサポートする他のプラットフォームで動作します。

以下のステップに従って DynamoDB をコンピュータにセットアップして実行します。

  1. 以下のリンクから無料で DynamoDB をダウンロードします。

    サービス対象 ダウンロードリンク チェックサム

    アジアパシフィック (ムンバイ) リージョン

    .tar.gz | .zip

    .tar.gz.sha256 | .zip.sha256

    アジアパシフィック (シンガポール) リージョン

    .tar.gz | .zip

    .tar.gz.sha256 | .zip.sha256

    アジアパシフィック (東京) リージョン

    .tar.gz | .zip

    .tar.gz.sha256 | .zip.sha256

    欧州 (フランクフルト) リージョン

    .tar.gz | .zip

    .tar.gz.sha256 | .zip.sha256

    南米 (サンパウロ) リージョン

    .tar.gz | .zip

    .tar.gz.sha256 | .zip.sha256

    米国西部 (オレゴン) リージョン

    .tar.gz | .zip

    .tar.gz.sha256 | .zip.sha256

    ダウンロード可能な DynamoDB は、Apache Maven で使用できます。詳細については、このトピックで後述する「DynamoDB (ダウンロード可能バージョン) と Apache Maven」を参照してください。DynamoDB は、AWS Toolkit for Eclipse の一部としても入手できます。詳細については、「AWS Toolkit for Eclipse」を参照してください。

    重要

    コンピュータで DynamoDB を実行するには、Java Runtime Environment (JRE) 6.x 以降のバージョンが必要です。アプリケーションは、旧バージョンの JRE では動作しません。

  2. アーカイブをダウンロードしたら、内容を抽出し、抽出されたディレクトリを任意の場所にコピーします。

  3. コンピュータで DynamoDB を開始するには、コマンドプロンプトウィンドウを開き、DynamoDBLocal.jar を抽出したディレクトリに移動し、次のコマンドを入力します。

    Copy
    java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb

    注記

    DynamoDB は、停止するまで受信リクエストを処理します。DynamoDB を停止するには、コマンドプロンプトに Ctrl+C と入力します。

    DynamoDB は、デフォルトではポート 8000 を使用します。ポート 8000 を使用できない場合、このコマンドにより例外がスローされます。DynamoDB ランタイムオプション (-port) の詳細なリストを表示するには、次のコマンドを入力します。

    java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help

これらの手順が完了したら、アプリケーションの書き込みを開始できます。

DynamoDB (ダウンロード可能バージョン) と Apache Maven

DynamoDB をアプリケーション内で依存関係として使用するには:

  1. Apache Maven をダウンロードし、インストールします。詳細については、「Apache Maven のダウンロード」および「Apache Maven のインストール」を参照してください。

  2. DynamoDB の Maven リポジトリをアプリケーションのプロジェクトオブジェクトモデル (POM) ファイルに追加します。

    Copy
    <!--Dependency:--> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>DynamoDBLocal</artifactId> <version>[1.11,2.0)</version> </dependency> </dependencies> <!--Custom repository:--> <repositories> <repository> <id>dynamodb-local-oregon</id> <name>DynamoDB Local Release Repository</name> <url>https://s3-us-west-2.amazonaws.com/dynamodb-local/release</url> </repository> </repositories>

    注記

    または、リージョンに応じて、次のいずれかのリポジトリ URL を使用することもできます。

    id Repository URL

    dynamodb-local-mumbai

    https://s3.ap-south-1.amazonaws.com/dynamodb-local-mumbai/release

    dynamodb-local-signapore

    https://s3-ap-southeast-1.amazonaws.com/dynamodb-local-singapore/release

    dynamodb-local-tokyo

    https://s3-ap-northeast-1.amazonaws.com/dynamodb-local-tokyo/release

    dynamodb-local-frankfurt

    https://s3.eu-central-1.amazonaws.com/dynamodb-local-frankfurt/release

    dynamodb-local-sao-paulo

    https://s3-sa-east-1.amazonaws.com/dynamodb-local-sao-paulo/release

GitHub の aws-dynamodb-examples リポジトリには、Java プログラム内の「DynamoDB Local の開始と停止」および「JUnit テストにおける DynamoDB Local の使用」の例がいくつかあります。

コマンドラインオプション

次のいずれかのオプションコマンドは、ダウンロード可能なバージョンの DynamoDB で使用できます。

  • -cors value - JavaScript で Cross-Origin Resource Sharing (CORS) のサポートを有効にします。特定のドメインのカンマ区切りの "許可" リストを指定する必要があります。-cors のデフォルト設定は、パブリックアクセスを許可するアスタリスク(*)です。

  • -dbPath value – DynamoDB がそのデータベースファイルを書き込むディレクトリ。このオプションを指定しない場合、ファイルは現在のディレクトリに書き込まれます。-dbPath-inMemory の両方を同時に指定することはできません。

  • -delayTransientStatuses - DynamoDB で特定のオペレーションの遅延を発生させます。DynamoDB (ダウンロード可能バージョン) では、テーブルやインデックスの作成/更新/削除オペレーションなどの一部のタスクを瞬時に行うことができます。ただし、DynamoDB サービスでこれらのタスクを行うには従来よりも時間がかかります。このパラメータを設定すると、コンピュータ上で実行されている DynamoDB で DynamoDB ウェブサービスの動作をより正確にシミュレートしやすくなります。(現在、このパラメータではステータスが CREATING または DELETING のグローバルセカンダリインデックスに対してのみ遅延が発生します)。

  • -help — 使用方法の概要とオプションを出力します。

  • -inMemory – DynamoDB は、データベースファイルを使用する代わりにメモリで実行されます。DynamoDB を停止すると、データは一切保存されません。-dbPath-inMemory の両方を同時に指定することはできません。

  • -optimizeDbBeforeStartup – コンピュータで DynamoDB を開始する前に、基になるデータベーステーブルを最適化します。このパラメータを使用するときは、-dbPath も指定する必要があります。

  • -port value – DynamoDB がアプリケーションと通信するために使用するポート番号。このオプションを指定しない場合、デフォルトポートは 8000 になります。

    注記

    DynamoDB は、デフォルトではポート 8000 を使用します。ポート 8000 を使用できない場合、このコマンドにより例外がスローされます。-port オプションを使用すると、異なるポート番号を指定できます。DynamoDB ランタイムオプション (-port) の詳細なリストを表示するには、次のコマンドを入力します。

    java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help

  • -sharedDb – DynamoDB では、認証情報とリージョンごとに別のファイルを使用する代わりに、単一のデータベースファイルを使用します。-sharedDb を指定すると、DynamoDB クライアントはすべて、リージョンと認証情報の設定にかかわらず、同じセットのテーブルを操作します。