跳转到主要内容

Python的Amazon DAX客户端

项目描述

Python的Amazon DAX客户端用于从Python访问Amazon DAX集群。它与Boto3几乎源兼容,只需对客户端初始化进行微小更改即可使用DAX而不是DynamoDB。创建与您的DAX集群的连接需要使用DescribeClusters响应中返回的集群发现端点URL作为端点。

安装

使用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客户端相同。

有关完整示例,请遵循创建示例应用程序指南

获取帮助

请使用以下社区资源获取帮助。

变更记录

v2.0.3

  • 修复了严格的antlr4-python3-runtime依赖关系

v2.0.1

  • 在NoMoreData错误上重试

  • 修复了ExpressionAttributeNames中重复的属性名称值上的错误验证问题

  • 修复了botocore依赖关系

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

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的编码问题

  • 修复了解码batch操作中的ConsumedCapacity和ItemCollectionMetrics

v1.0.1

  • 首次发布

项目详情


下载文件

下载适合您平台的应用文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码分发

amazon-dax-client-2.0.3.tar.gz (96.3 kB 查看散列值)

上传时间 源代码

由以下支持