用途：azure-cosmos 是 Azure Cosmos DB 的 Java 客户端库，面向 NoSQL API，用于在 Java 应用中执行数据库与条目操作，并支持全局分发与响应式（Reactive）编程模式。
主要能力：提供账户级客户端 CosmosClient 与 CosmosAsyncClient；通过 CosmosDatabase/CosmosContainer（及异步版本）管理数据库、容器和条目。支持创建数据库与容器（含 IfNotExists 变体）、条目的创建、读取、替换、删除、SQL 查询，以及分区键、一致性级别、首选区域、请求单位（RU）计费等配置。异步客户端支持链式流式调用。
使用方式：通过 Maven 引入依赖 <dependency><groupId>com.azure</groupId><artifactId>azure-cosmos</artifactId><version>LATEST</version></dependency>，也可使用 azure-sdk-bom 统一管理版本。使用环境变量配置连接信息：COSMOS_ENDPOINT 与 COSMOS_KEY。使用 CosmosClientBuilder 以 endpoint 和 key 构建同步或异步客户端，可配置直连模式、一致性级别、连接共享、写操作返回内容、userAgent 后缀和首选区域。典型流程为创建数据库、创建容器（需指定分区键路径），再进行 CRUD 与查询。
关键概念与限制：分区键应具有高基数、分布均匀且常用于查询；一致性级别包含强、有界过期、会话、一致前缀和最终一致；所有操作消耗 RU，可通过响应获取请求计费。错误处理可捕获 CosmosException，根据状态码处理（如 409 已存在、429 限流并参考重试时长）。最佳实践包括复用客户端、高吞吐使用异步客户端、谨慎选择分区键、必要时启用写操作内容返回、配置首选区域、依赖内置重试策略、生产使用直连模式以降低延迟。原文未提供具体定价与平台配额信息。相关 Maven 包、API 文档、产品文档、示例与性能/故障排查链接见资料。