Azure Cosmos DB JavaScript/TypeScript SDK(azure/cosmos),用于数据平面操作,包括文档CRUD、查询、批量操作和容器管理。技能概述azure-cosmos-ts 技能是Azure Cosmos DB NoSQL API的TypeScript/JavaScript客户端库,提供完整的数据平面操作支持。该SDK支持文档的CRUD操作、SQL查询、批量操作、存储过程调用等功能,适用于构建Node.js应用和前端应用。通过该技能,开发者可以利用TypeScript的类型安全特性,快速实现可靠的数据访问层。下载地址:antigravity-awesome-skills/skills/azure-cosmos-ts at main · sickn33/antigravity-awesome-skills · GitHub主要功能文档CRUD操作: 支持文档的创建、读取、更新、删除、Upsert和Patch操作SQL查询: 支持参数化查询、跨分区查询、分页和投影批量操作: 支持批量创建、更新、删除操作,提高吞吐量分区键管理: 支持单分区键和层级分区键(MultiHash)TypeScript类型: 提供完整的类型定义,确保类型安全AAD认证: 支持使用DefaultAzureCredential进行安全认证乐观并发: 支持使用ETag实现乐观并发控制存储过程: 支持调用和管理存储过程、触发器和UDF触发条件在以下情况下应该使用此技能:需要使用TypeScript/JavaScript开发Azure Cosmos DB应用需要实现文档的CRUD操作和查询功能需要使用批量操作提高吞吐量需要实现乐观并发控制需要使用存储过程和触发器需要构建类型安全的数据访问层使用场景Node.js API服务构建基于Express或NestJS的RESTful API,使用Cosmos DB作为数据存储,实现高性能的数据访问。前端应用在浏览器或React Native应用中直接访问Cosmos DB,实现无服务器的数据访问架构。Azure Functions在Azure Functions中访问Cosmos DB,构建无服务器的事件驱动应用。处理过程1. 客户端初始化创建Cosmos客户端并配置认证:import { CosmosClient } from azure/cosmos;import { DefaultAzureCredential } from azure/identity;const client new CosmosClient({endpoint: process.env.COSMOS_ENDPOINT!,aadCredentials: new DefaultAzureCredential(),});2. 数据库和容器设置创建或获取数据库和容器:const { database } await client.databases.createIfNotExists({id: my-database,});const { container } await database.containers.createIfNotExists({id: my-container,partitionKey: { paths: [/partitionKey] },});3. 文档CRUD操作执行文档的创建、读取、更新和删除:interface Product {id: string;partitionKey: string;name: string;price: number;}// 创建const { resource } await container.items.createProduct(item);// 读取const { resource } await container.item(product-1, electronics).readProduct();// 更新const { resource: updated } await container.item(product-1, electronics).replaceProduct(existing);// Upsertconst { resource } await container.items.upsertProduct(item);// 删除await container.item(product-1, electronics).delete();4. Patch操作执行部分更新:import { PatchOperation } from azure/cosmos;const operations: PatchOperation[] [{ op: replace, path: /price, value: 799.99 },{ op: add, path: /discount, value: true },{ op: remove, path: /oldField },];const { resource } await container.item(product-1, electronics).patchProduct(operations);输入要求使用此技能时,需要提供:Cosmos DB账户端点URL认证凭据(AAD或密钥)数据库名称和容器名称分区键路径TypeScript接口定义输出说明技能将提供:完整的客户端初始化代码TypeScript接口定义示例CRUD操作实现代码查询执行和分页代码批量操作示例错误处理和并发控制使用示例示例1: 参数化查询import { SqlQuerySpec } from azure/cosmos;const querySpec: SqlQuerySpec {query: SELECT * FROM c WHERE c.partitionKey category AND c.price maxPrice,parameters: [{ name: category, value: electronics },{ name: maxPrice, value: 1000 },],};const { resources } await container.items.queryProduct(querySpec).fetchAll();示例2: 批量操作import { BulkOperationType, OperationInput } from azure/cosmos;const operations: OperationInput[] [{operationType: BulkOperationType.Create,resourceBody: { id: 1, partitionKey: cat-a, name: Item 1 },},{operationType: BulkOperationType.Upsert,resourceBody: { id: 2, partitionKey: cat-a, name: Item 2 },},{operationType: BulkOperationType.Delete,id: 3,partitionKey: cat-b,},];const response await container.items.executeBulkOperations(operations);示例3: 乐观并发控制// 读取时获取ETagconst { resource, etag } await container.item(product-1, electronics).readProduct();if (resource etag) {resource.price 899.99;try {// 仅当ETag匹配时替换await container.item(product-1, electronics).replace(resource, {accessCondition: {type: IfMatch,condition: etag,},});} catch (error) {if (error instanceof ErrorResponse error.code 412) {console.log(Document was modified by another process);}}}最佳实践使用AAD认证: 优先使用DefaultAzureCredential而不是密钥始终使用参数化查询: 防止注入攻击并提高计划缓存效率指定分区键: 尽可能避免跨分区查询使用批量操作: 对于多次写入,使用executeBulkOperations处理429错误: 实现指数退避的重试逻辑使用ETag实现并发: 防止并发场景中的丢失更新关闭客户端: 在清理时调用client.dispose()资源层次结构CosmosClient└── Database└── Container├── Items (documents)├── Scripts (stored procedures, triggers, UDFs)└── Conflicts分区键管理层级分区键(MultiHash)支持最多3层分区键,实现更精细的数据分布:import { PartitionKeyDefinitionVersion, PartitionKeyKind } from azure/cosmos;const { container } await database.containers.createIfNotExists({id: orders,partitionKey: {paths: [/tenantId, /userId, /sessionId],version: PartitionKeyDefinitionVersion.V2,kind: PartitionKeyKind.MultiHash,},});// 操作需要分区键值数组const { resource } await container.item(order-1, [tenant-a, user-123, session-xyz]).read();错误处理import { ErrorResponse } from azure/cosmos;try {const { resource } await container.item(missing, pk).read();} catch (error) {if (error instanceof ErrorResponse) {switch (error.code) {case 404:console.log(Document not found);break;case 409:console.log(Conflict - document already exists);break;case 412:console.log(Precondition failed (ETag mismatch));break;case 429:console.log(Rate limited - retry after:, error.retryAfterInMs);break;default:console.error(Cosmos error ${error.code}: ${error.message});}}throw error;}服务层模式export class ProductService {private container: Container;constructor(client: CosmosClient) {this.container client.database(process.env.COSMOS_DATABASE!).container(process.env.COSMOS_CONTAINER!);}async getById(id: string, category: string): PromiseProduct | null {try {const { resource } await this.container.item(id, category).readProduct();return resource ?? null;} catch (error) {if (error instanceof ErrorResponse error.code 404) {return null;}throw error;}}async create(product: OmitProduct, id): PromiseProduct {const item { ...product, id: crypto.randomUUID() };const { resource } await this.container.items.createProduct(item);return resource!;}}安装和配置# 安装依赖npm install azure/cosmos azure/identity# 环境变量COSMOS_ENDPOINThttps://account.documents.azure.com:443/COSMOS_DATABASEdatabase-nameCOSMOS_CONTAINERcontainer-nameTypeScript类型参考import {// 客户端和资源CosmosClient,Database,Container,Item,Items,// 操作OperationInput,BulkOperationType,PatchOperation,// 查询SqlQuerySpec,SqlParameter,FeedOptions,// 分区键PartitionKeyDefinition,PartitionKeyDefinitionVersion,PartitionKeyKind,// 响应ItemResponse,FeedResponse,ResourceResponse,// 错误ErrorResponse,} from azure/cosmos;相关SDKSDK用途安装azure/cosmos数据平面(此SDK)npm install azure/cosmosazure/arm-cosmosdb管理平面(ARM)npm install azure/arm-cosmosdbazure/identity认证npm install azure/identity
企业数字化 ERP 产品动态
相关推荐
【研发类-区块链开发Skills】maxia 技能 连接到Solana上的MAXIA AI-to-AI市场。发现、购买、出售AI服务。赚取USDC。13个MCP工具、A2A协议、DeFi收益、情绪分析、rug检测。
技能概述
maxia 技能是一个连接到Solana上MAXIA市场的技能,AI代理可以在此相互交易服务。该技能支持发现和购买AI服务、出售自己的AI服务赚取U… · 2026/11/19 10:27:45
C++函数反射实现:从类型擦除到动态调用的工程实践 1. 项目概述:为什么我们需要在C中实现函数反射?在C的世界里,我们常常羡慕Java、C#这类语言自带的“反射”能力——运行时获取类型信息、动态调用函数,这对于构建插件系统、序列化框架、RPC服务或者游戏引擎的脚本绑定来说… · 2026/11/8 3:39:52
布吉有女生考电工证值不值得考?怕考不过白交培训费?一文说透 布吉有女生考电工证值不值得考?怕考不过白交培训费?一文说透 怕考不过白交培训费?布吉有女生考电工证值不值得考?这些问题其实很多人都在问,但真正去了解的人却不多。特别是女生,对电工证这种技术性比较强的证书,总感觉门槛高、流程复杂,甚至不知道从… · 2026/11/19 10:26:51
大连为啥考不了电工证 电工证含金量你真的了解吗 大连为啥考不了电工证 电工证含金量你真的了解吗 你是不是也遇到过这样的问题: 不知道去哪报名怕被中介坑 ?电工证作为特种作业操作证的一种,是从事电气作业的“门槛证”,但很多人因为不了解报考流程、地方政策、证书含金量,最后反而错过了考证机会,… · 2026/11/19 10:26:51
电工作业有害因素证丢了怎么补办 多久拿证全攻略 电工作业有害因素证丢了怎么补办 多久拿证全攻略 证书过期了不知道怎么复审延期?电工作业有害因素证丢了怎么补办?这事儿真不是小事,尤其是在洛阳中小施工企业里,电工岗位是保障项目安全运转的关键角色,证书一旦过期或丢失,不仅影响工作,还可能带来法… · 2026/11/19 10:26:51
祁县电工证在哪里考,学历不高也能拿全国通用证书 祁县电工证在哪里考,学历不高也能拿全国通用证书 你是不是总觉得自己学历不高,考个电工证都难?别担心,祁县电工证在哪里考,其实有明确的流程和规定,只要准备充分, 全国通用… · 2026/11/19 10:26:51
广州电工证考证哪里考郑州报考避坑指南 广州电工证考证哪里考郑州报考避坑指南 证书过期了不知道怎么复审延期?你不是一个人,这几乎是所有特种作业持证人都会遇到的“生死时速”问题。尤其是在广州、郑州等地,特种作业证书的办理、复审、延期政策经常变动,稍有不慎就可能影响你的工作和收入。本… · 2026/11/19 10:26:51
初级电工证多少天考试在哪考 考上就能干电工活 初级电工证多少天考试在哪考 考上就能干电工活 学历不高怕报不上名,这事儿我懂。很多打算考初级电工证的朋友,最大的顾虑就是怕自己学历不够,报名会被卡住。其实不然,国家对电工证的报考条件并不苛刻,尤其是初级电工证, 根本不要求你有高中以上学历… · 2026/11/19 10:25:50
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/18 8:19:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/18 8:19:53
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/18 14:38:14
姑苏区哪里考电工证好考前押题怎么找 姑苏区哪里考电工证好考前押题怎么找 工地太忙根本没时间复习考试,电工证考前还总找不到靠谱的 考前押题 资源,真让人头疼。如果你也是在苏州姑苏区从事建筑或电力行业的,那这些建议你一定要看完。 为什么姑苏区考电工证的人这么多?… · 2026/11/19 0:00:12
罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 之前考的证在外省能不能转过来?这几乎是每个特种作业证书持有者都会遇到的问题,特别是像你这样已经在外地工作多年,想回老家罗定发展或者重新规划职业路径的人。别急,今天就给你一条清晰的路… · 2026/11/19 0:00:12
罗定能考电工证吗 电工证含金量到底有多少? 罗定能考电工证吗 电工证含金量到底有多少? 之前考的证在外省能不能转过来,这几乎是每个准备考电工证的朋友最先想到的问题。特别是在罗定这样的地方,很多人的电工证都是在外地考的,现在想在当地继续使用,但不知道怎么办。实际上,电工证的 含金量… · 2026/11/19 0:00:12
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38