Amazon DynamoDB
开发人员指南 (API 版本 2012-08-10)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

Java 和 DAX

要在 Amazon EC2 实例上运行用于 DynamoDB Accelerator (DAX) 的 Java 示例应用程序,请执行以下过程:

  1. 安装 Java 开发工具包 (JDK):

    sudo yum install -y java-devel
  2. 下载 AWS SDK for Java (.zip 文件),然后解压缩此文件:

    wget http://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip unzip aws-java-sdk.zip
  3. 下载最新版本的 DAX Java 客户端 (.jar 文件):

    wget http://dax-sdk.s3-website-us-west-2.amazonaws.com/java/DaxJavaClient-latest.jar

    注意

    适用于 Java 的 DAX 开发工具包的客户端在 Apache Maven 中可用。有关更多信息,请参阅本主题后面的 使用客户端作为 Apache Maven 依赖项

  4. 设置您的 CLASSPATH 变量:

    export SDKVERSION=sdkVersion export CLASSPATH=.:./DaxJavaClient-latest.jar:aws-java-sdk-$SDKVERSION/lib/aws-java-sdk-$SDKVERSION.jar:aws-java-sdk-$SDKVERSION/third-party/lib/*

    sdkVersion 替换为 AWS 适用于 Java 的开发工具包 的实际版本号,例如:1.11.112

  5. 下载示例程序源代码 (.zip 文件):

    wget http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/samples/TryDax.zip

    下载完成后,解压缩源文件:

    unzip TryDax.zip
  6. 按如下所示编译代码:

    javac TryDax*.java
  7. 运行程序:

    java TryDax

    您应该可以看到类似于如下所示的输出内容:

    Creating a DynamoDB client Attempting to create table; please wait... Successfully created table. Table status: ACTIVE Writing data to the table... Writing 10 items for partition key: 1 Writing 10 items for partition key: 2 Writing 10 items for partition key: 3 Writing 10 items for partition key: 4 Writing 10 items for partition key: 5 Writing 10 items for partition key: 6 Writing 10 items for partition key: 7 Writing 10 items for partition key: 8 Writing 10 items for partition key: 9 Writing 10 items for partition key: 10 Running GetItem, Scan, and Query tests... First iteration of each test will result in cache misses Next iterations are cache hits GetItem test - partition key 1 and sort keys 1-10 Total time: 136.681 ms - Avg time: 13.668 ms Total time: 122.632 ms - Avg time: 12.263 ms Total time: 167.762 ms - Avg time: 16.776 ms Total time: 108.130 ms - Avg time: 10.813 ms Total time: 137.890 ms - Avg time: 13.789 ms Query test - partition key 5 and sort keys between 2 and 9 Total time: 13.560 ms - Avg time: 2.712 ms Total time: 11.339 ms - Avg time: 2.268 ms Total time: 7.809 ms - Avg time: 1.562 ms Total time: 10.736 ms - Avg time: 2.147 ms Total time: 12.122 ms - Avg time: 2.424 ms Scan test - all items in the table Total time: 58.952 ms - Avg time: 11.790 ms Total time: 25.507 ms - Avg time: 5.101 ms Total time: 37.660 ms - Avg time: 7.532 ms Total time: 26.781 ms - Avg time: 5.356 ms Total time: 46.076 ms - Avg time: 9.215 ms Attempting to delete table; please wait... Successfully deleted table.

    记下计时信息 - GetItemQueryScan 测试所需的时间(以毫秒为单位)。

  8. 在上一步中,您已针对 Amazon DynamoDB 终端节点运行程序。现在,重新运行这些程序,但这一次,GetItemQueryScan 操作将由 DAX 集群处理。

    要确定 DAX 集群的终端节点,请选择下列选项之一:

    • 使用 DynamoDB 控制台 - 选择您的 DAX 集群。集群终端节点将显示在控制台中,例如:

      mycluster.frfx8h.clustercfg.dax.usw2.amazonaws.com:8111
    • 使用 AWS CLI - 键入以下命令:

      aws dax describe-clusters --query "Clusters[*].ClusterDiscoveryEndpoint"

      集群终端节点端口和地址显示在输出中,例如:

      { "Port": 8111, "Address":"mycluster.frfx8h.clustercfg.dax.usw2.amazonaws.com" }

    现在重新运行程序 - 但这一次,将集群终端节点指定为命令行参数:

    java TryDax mycluster.frfx8h.clustercfg.dax.usw2.amazonaws.com:8111

    查看输出的其余内容,并记下计时信息。使用 DAX 时 GetItemQueryScan 的运行时间应明显少于使用 DynamoDB 时的运行时间。

有关此程序的更多信息,请参阅以下各节:

使用客户端作为 Apache Maven 依赖项

在应用程序中将适用于 Java 的 DAX 开发工具包的客户端用作依赖项:

  1. 下载并安装 Apache Maven。有关更多信息,请参阅下载 Apache Maven安装 Apache Maven

  2. 将客户端 Maven 依赖项添加到您的应用程序的项目对象模型 (POM) 文件:

    <!--Dependency:--> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>amazon-dax-client</artifactId> <version>x.x.x.x</version> </dependency> </dependencies>

    将 x.x.x.x 替换为客户端的实际版本号。例如:1.0.200704.0。