@azure/cosmos (TypeScript/JavaScript)
使用 TypeScript 构建 Cosmos DB 应用程序
开发人员需要高效地执行 Azure Cosmos DB 文档的 CRUD 操作。此技能提供用于查询、批量操作和正确身份验证的 TypeScript 模式。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“@azure/cosmos (TypeScript/JavaScript)”。 Create a product document with name 'Laptop', price 999.99, category 'electronics'
预期结果:
成功在容器 'products' 中创建了 id 为 'prod-8a7b2c' 的文档。请求费用：5.21 RU。
正在使用“@azure/cosmos (TypeScript/JavaScript)”。 Query products where price < 1000 and category = 'electronics'
预期结果:
检索到 15 个符合查询条件的产品。总请求费用：3.47 RU。结果包括：Laptop、Tablet、Wireless Mouse、USB Hub...
安全审计
安全Prompt-only instructional skill containing documentation for Azure Cosmos DB SDK usage. Static analysis scanned 0 files with 0 findings and risk score 0/100. No executable code, network access, or security concerns detected. The skill teaches proper security practices including AAD authentication and parameterized queries.
质量评分
你能构建什么
构建 SaaS 应用程序的后端开发人员
使用分层分区键实现多层租户数据层，在隔离客户数据的同时保持查询性能。
处理高容量事务的数据工程师
使用批量操作高效地每秒插入、更新和删除数千个文档，并带有适当的错误处理。
创建实时应用的全栈开发人员
构建变更源处理器并实现乐观并发以处理来自多个客户端的并发更新。
试试这些提示
创建一个 TypeScript 函数，将新产品文档插入到 Azure Cosmos DB 中。产品应包含 id、name、price 和 category 字段。使用 DefaultAzureCredential 进行身份验证，并包含对重复文档的适当错误处理。
编写一个 TypeScript 服务方法，查询 Cosmos DB 中指定价格范围内的产品。使用带有命名参数的 SqlQuerySpec 来防止注入攻击。包含使用延续令牌的分页支持。
实现一个批量导入函数，使用 executeBulkOperations 处理包含 1000 多个文档的数组。通过记录失败操作及其状态码来处理部分失败，同时继续处理成功的操作。
创建一个更新函数，使用 ETag 来防止多个用户修改同一文档时丢失更新。当 ETag 先决条件失败时返回特定错误，以便客户端可以刷新并重试。
最佳实践
- 在生产环境中使用 DefaultAzureCredential 进行身份验证，而不是使用账户密钥
- 始终使用带有 SqlQuerySpec 的参数化查询以防止注入并改进查询计划缓存
- 在所有点操作中指定分区键值以避免跨分区查询开销
避免
- 直接在代码中使用账户密钥而不是使用环境变量或托管身份
- 在大型容器上执行没有 WHERE 子句的 SELECT * 查询
- 忽略 429 速率限制错误而不是实现指数退避重试逻辑