Azure Web Apps项目中CosmosDB存储过程管理方案咨询及参考请求

刚好我之前做过类似的场景，给你整理几个实用的实现思路和落地方案：

一、存储过程的文件结构与版本控制 #

• 把每个存储过程单独存为独立的.js文件，放在NodeJS项目的专属目录（比如/cosmos-stored-procedures），每个文件名对应存储过程的ID，文件内直接写原生的Cosmos DB存储过程JavaScript代码，不用额外包装。比如calculateOrderTotal.js就对应同名的存储过程，这样方便单独维护和Git版本控制。
• 新增一个配置文件（比如sprocs-mapping.json），用来关联存储过程文件与目标数据库、容器，让控制台应用能明确部署路径。示例配置：

{
  "storedProcedures": [
    {
      "id": "calculateOrderTotal",
      "filePath": "./cosmos-stored-procedures/calculateOrderTotal.js",
      "databaseName": "ECommerceDB",
      "containerName": "Orders"
    },
    {
      "id": "cleanupExpiredSessions",
      "filePath": "./cosmos-stored-procedures/cleanupExpiredSessions.js",
      "databaseName": "ECommerceDB",
      "containerName": "UserSessions"
    }
  ]
}

二、控制台应用的核心部署逻辑 #

使用@azure/cosmos NodeJS SDK实现存储过程的上传、更新操作，核心流程如下：

1. 读取配置文件，遍历所有存储过程条目；
2. 读取对应.js文件的代码内容；
3. 连接到Cosmos DB（支持模拟器或云端实例）；
4. 检查目标容器中是否已存在同名存储过程：存在则更新，不存在则创建。

核心代码片段示例：

const { CosmosClient } = require('@azure/cosmos');
const fs = require('fs').promises;
const sprocConfig = require('./sprocs-mapping.json');

async function deployStoredProcedures() {
  // 从环境变量读取连接字符串，避免硬编码
  const cosmosClient = new CosmosClient(process.env.COSMOS_DB_CONNECTION_STRING);

  for (const sproc of sprocConfig.storedProcedures) {
    try {
      // 读取存储过程代码
      const sprocCode = await fs.readFile(sproc.filePath, 'utf8');
      // 获取目标容器的脚本操作对象
      const container = cosmosClient.database(sproc.databaseName).container(sproc.containerName);
      const sprocRef = container.scripts.storedProcedure(sproc.id);

      // 尝试读取已存在的存储过程，存在则更新
      await sprocRef.read();
      await sprocRef.replace({ body: sprocCode });
      console.log(`✅ 已更新存储过程: ${sproc.id}`);
    } catch (error) {
      if (error.code === 404) {
        // 不存在则创建新的存储过程
        await container.scripts.createStoredProcedure({
          id: sproc.id,
          body: sprocCode
        });
        console.log(`✅ 已创建存储过程: ${sproc.id}`);
      } else {
        console.error(`❌ 处理存储过程 ${sproc.id} 失败:`, error.message);
      }
    }
  }
}

// 执行部署
deployStoredProcedures().catch(err => console.error('部署流程出错:', err));

三、与Visual Studio项目的集成 #

• 可以在Azure Web Apps项目中添加预构建事件，自动触发NodeJS控制台应用部署存储过程。在项目属性的「生成事件」中配置预构建命令：

cd $(SolutionDir)\YourNodeJSProjectName
npm install --silent
node deploy-sprocs.js

这样每次构建Web项目时，都会自动同步最新的存储过程到Cosmos DB（注意在本地开发时，把Cosmos模拟器的连接字符串设置为环境变量）。

• 如果使用CI/CD流水线（比如Azure DevOps），可以把这个部署步骤作为Web App部署的前置环节，确保存储过程与应用代码同步更新。

四、本地调试与验证技巧 #

• 本地开发时，依然可以用Cosmos DB模拟器的浏览器编辑器快速测试存储过程逻辑，验证通过后再把代码同步到NodeJS项目的文件中，保证代码源唯一。
• 给控制台应用添加--dry-run参数，开启后只输出要执行的操作（创建/更新哪些存储过程），不实际修改Cosmos DB，方便提前验证配置和文件路径是否正确。

内容的提问来源于stack exchange，提问作者Milan Egon Votrubec