Azure Cosmos DB JavaScript SDK 教程

Azure Cosmos DB JavaScript SDK 教程

azure-cosmos-js @azure/cosmos has moved to a new repo https://github.com/Azure/azure-sdk-for-js 项目地址: https://gitcode.com/gh_mirrors/az/azure-cosmos-js

---

项目介绍

Azure Cosmos DB JavaScript SDK 是一个专为开发者设计的库，它支持在JavaScript及Node.js环境中访问Azure Cosmos DB的SQL API。此SDK提供了全面的功能来创建、读取、更新和删除文档，以及管理数据库和容器等核心操作。伴随SDK的还有丰富的示例、工具和实用程序，帮助开发人员高效地集成Azure Cosmos DB到他们的应用中。

项目快速启动

要迅速开始使用Azure Cosmos DB JavaScript SDK，首先确保你的开发环境已经配置了Node.js。接下来，通过npm安装SDK：

npm install @azure/cosmos

然后，你可以使用以下代码片段来连接到你的Cosmos DB账户并执行基本操作：

const { CosmosClient } = require('@azure/cosmos');

// 替换下面的占位符为你自己的Cosmos DB端点和密钥
const endpoint = "https://your-account.documents.azure.com";
const key = "[your-master-key]";
const client = new CosmosClient({ endpoint, key });

async function quickStart() {
    try {
        // 创建或获取数据库
        const databaseId = "sampleDatabase";
        const { database } = await client.databases.createIfNotExists({ id: databaseId });
        
        // 创建或获取容器（集合）
        const containerId = "sampleContainer";
        const { container } = await database.containers.createIfNotExists({ id: containerId });
        
        // 插入文档
        const doc = { id: "doc1", content: "Sample Document" };
        const { resource: createdDoc } = await container.items.create(doc);
        console.log(`Created item with content: ${createdDoc.content}`);
        
        // 示例结束时清理资源，删除数据库
        await database.delete();
        console.log('Database deleted');
    } catch (error) {
        console.error(error);
    }
}

quickStart();

请记得替换your-account.documents.azure.com和[your-master-key]为你自己的Cosmos DB账号信息。

应用案例和最佳实践

应用案例

• Web应用程序: 使用Cosmos DB作为后端数据存储，实现高性能的数据存取。
• 物联网(IoT): 实时处理来自成千上万设备的数据流。
• 游戏服务: 支持高并发的用户状态管理和排行榜更新。

最佳实践

• 分区设计: 根据访问模式合理划分数据，以优化查询性能。
• 吞吐量预配: 根据应用需求调整RU/s，避免过量支付。
• 利用ID设计: 唯一且高效的文档ID可以提升查询效率。

典型生态项目

虽然特定的“生态项目”通常指的是与主项目协同工作的其他开源项目或服务，在Azure Cosmos DB场景下，开发者可能会结合使用如Express.js、React或Vue.js等前端框架，构建全栈应用。此外，监控和管理工具如Application Insights可以与Cosmos DB集成，用于跟踪应用性能和数据库活动。对于更高级的应用场景，可能涉及事件驱动架构，使用Azure Functions与Cosmos DB相结合，自动化处理数据更新或触发业务逻辑。

确保在构建应用时参考Azure Cosmos DB的官方文档，那里有详细的指南和最佳实践，帮助你在实际项目中充分利用该服务。

azure-cosmos-js @azure/cosmos has moved to a new repo https://github.com/Azure/azure-sdk-for-js 项目地址: https://gitcode.com/gh_mirrors/az/azure-cosmos-js