noq-dax-client 2.1.1

安装

使用pip安装Amazon DAX客户端

$ pip install amazon-dax-client

快速入门

Boto3有两个不同的接口，即资源接口和botocore客户端接口。这两个接口都由Amazon DAX客户端支持，客户端初始化略有不同。

对于资源API，从

ddb = boto3.resource('dynamodb')

更改为

dax = AmazonDaxClient.resource(
    endpoint_url=<cluster_discovery_endpoint_url>)

接受所有其他boto3.resource()参数。

对于botocore客户端API，从

session = botocore.session.get_session()
ddb = session.create_client('dynamodb', ...)

更改为

session = botocore.session.get_session()
dax = AmazonDaxClient(session, ...)

对于Boto3客户端API，从

ddb = boto3.client('dynamodb')

更改为

dax = AmazonDaxClient(endpoint_url=<cluster_discovery_endpoint_url>)

Boto3和botocore客户端API完全相同。

当客户端向集群发出请求时，默认启用TLS连接的主机名验证，对于未加密的集群没有影响。可以使用客户端API关闭此功能，但请确保您理解关闭此功能的影响，即无法验证您连接到的集群。

不受支持的特性

Amazon DAX客户端不支持表操作。任何表操作都必须使用常规Boto3或botocore DynamoDB客户端。

分页器目前不支持DAX。

文档

创建后，接口与Boto3/botocore DynamoDB客户端相同。

• Boto3 DynamoDB资源API

• botocore DynamoDB客户端API

要获得完整的示例，请遵循创建示例应用指南。

获取帮助

请使用以下社区资源来寻求帮助。

• 在StackOverflow上提问，并使用标签amazon-dynamodb-dax

• 在AWS DynamoDB 论坛上提问

• 通过AWS Support提交支持工单

变更记录

v2.0.0

• 传输中加密功能

• 停止支持低于3.6版本的Python

v1.1.8

• 重试逻辑错误修复

v1.1.7

• 小错误修复

v1.1.6

• 代码风格检查修复

• 更新日志记录，记录到Logger对象

v1.1.5

• 为可重试异常添加抖动和退避

v1.1.4

• 修复从少于3个节点的集群开始的错误。

v1.1.3

• 修复和改进服务发现逻辑。

• 支持Python 3.8。

• 修复AWS论坛中报告的'RetryHandler'对象没有属性'_cluster'：AttributeError问题。

• 修复静态分析中发现的问题。

v1.1.2

• 修复当名单变更时可能导致更新失败，随后可能导致NoRouteException的bug。

v1.1.1

• 修复可能导致节点失败时无限循环的bug。

• 更新TransactWriteItem测试项目限制为25。

v1.1.0

• 添加对DynamoDB事务的transact-get-items和transact-write-items API的支持。

• 提高连接池的效率。

v1.0.7

• 修复后台任务调度问题。

v1.0.6

• 正确去匿名化BatchWrite的UnprocessedItems结果。

• 如果没有后端可用，则引发适当的错误。

v1.0.5

• 修复部分属性更改时UpdateItem结果解析的问题。

v1.0.4

• 使用用户指定的超时时间。

• 修复项目未更改时更新响应的问题。

• 修复解码BatchWrite UnprocessedItems的错误。

v1.0.3

• 修复使用batch_get_items或batch_write_items时AmazonDaxClient.resource()的问题。

v1.0.2

• 修复Python 2编码问题。

• 修复批量操作中ConsumedCapacity、ItemCollectionMetrics的解码问题。

v1.0.1

• 初始发布