Amazon DynamoDB
开发人员指南 (API Version 2012-08-10)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

设置 DynamoDB Local (可下载版本)

利用 DynamoDB 的可下载版本,您可以在不访问实际的 Amazon DynamoDB Web 服务的情况下编写应用程序。相反,数据库可在计算机上独立使用。

此本地版本的 DynamoDB 可帮助您节省预配置的吞吐量、数据存储和数据传输费用。此外,在开发应用程序时无需 Internet 连接。当您准备好在生产中部署应用程序时,可以对代码进行少量更改,使之使用 Amazon DynamoDB Web 服务。

下载和运行 DynamoDB

可下载版本的 DynamoDB 作为可执行 .jar 文件提供。它将在 Windows、Linux、Mac OS 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 还在 Maven 上提供,或作为 AWS Toolkit for Eclipse 的一部分提供。有关更多信息,请分别参阅 DynamoDB Local (可下载版本) 和 MavenAWS Toolkit For Eclipse

    重要

    您计算机上的 DynamoDB 需要 Java 运行时环境 (JRE) 版本 6.x 或更新版本;它在较旧的 JRE 版本上无法运行。

  2. 下载该档案后,提取内容,并将提取的目录复制到您选择的某个位置。

  3. 要在计算机上启动 DynamoDB,请打开命令提示符窗口,导航到您提取 DynamoDBLocal.jar 的目录,并输入以下命令:

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

    您将在 DynamoDB 的运行窗口中看到不时弹出的诊断消息。

    DynamoDB 将处理传入请求,直到您将其停止为止。要停止 DynamoDB,请在命令提示符窗口中键入 Ctrl+C。

DynamoDB Local (可下载版本) 和 Maven

在您的应用程序中将 DynamoDB 用作依赖项:

  1. 下载并安装 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 的 CORS 支持(跨源资源共享)。您必须提供特定域的逗号分隔“允许”列表。-cors 的默认设置是星号 (*),这将允许公开访问。

  • -dbPath value - DynamoDB 将用于写入其数据库文件的目录。如果不指定此选项,则文件将写入当前目录。请注意,不能同时指定 -dbPath-inMemory

  • -delayTransientStatuses - 使 DynamoDB 为某些操作引入延迟。DynamoDB 几乎可以即时执行某些任务,例如,对表和索引执行创建/更新/删除操作;但是,实际 DynamoDB 服务需要更多时间才能完成这些任务。设置此参数有助于 DynamoDB 更逼真地模拟 Amazon DynamoDB Web 服务的行为。(目前,此参数仅为处于 CREATINGDELETING 状态的全局二级索引引入延迟。)

  • -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 客户端都将与同一组表交互,无论其区域和证书配置如何。

本页内容: