Node.js使用@azure/data-tables updateEntity报replace读取错误

问题场景 #

在Node.js环境中使用*@azure/data-tables*库开发Azure表存储相关功能，实现表实体更新操作时，调用updateEntity方法持续抛出异常：Cannot read properties of undefined (reading 'replace')。
已确认的正常前提：

• 存储账户名account与账户密钥accountKey配置正确
• createEntity方法可正常运行，能够成功向表中插入实体数据
• 目标表包含PartitionKey、RowKey、Name三个属性，所有字段类型均为字符串类型

问题复现代码 #

index.js实现 #

const { TableClient, AzureNamedKeyCredential } = require("@azure/data-tables");

module.exports = async function (context, req) {
    const account = ""
    const accountKey = ""
    const tableName = "Person"
    const sharedKeyCredential = new AzureNamedKeyCredential(account, accountKey);

    const client = new TableClient(
        `https://${account}.table.core.windows.net`,
        `${tableName}`,
        sharedKeyCredential
    );

    const entity = {
        PartitionKey: "1",
        RowKey: "1",
        Name: 'Mathilde'
    };
    await client.updateEntity(entity);
}

function.json配置 #

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "input",
      "methods": ["put"],
      "route": "updatingUsers"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    }
  ],
  "disabled": false
}

已尝试排查操作 #

• 分别使用已存在的PartitionKey/RowKey组合、全新唯一的PartitionKey/RowKey组合测试更新操作
• 尝试对其他数据表执行更新操作
• 将RowKey字段值修改为数值类型进行测试
• 调试检查实体对象、client实例是否存在undefined属性，未发现异常，两者相关属性均正常
• 测试SDK其他方法可用性，确认createEntity方法可正常运行

根因与修复方案 #

报错根因 #

@azure/data-tables库的updateEntity方法要求必须传入第二个参数指定更新模式，原代码未传入该参数时，SDK内部逻辑会尝试对undefined值执行字符串replace处理，直接触发该类型错误。

修复方式 #

调用updateEntity时补充第二个更新模式参数即可，支持两种模式：

• Merge：合并更新，仅修改传入的属性值，实体上未传入的原有属性会保留
• Replace：全量替换，实体上未传入的原有属性会被删除
  修复后的调用代码示例：

// 按需选择更新模式，示例使用Merge模式
await client.updateEntity(entity, "Merge");

补充说明 #

如果业务场景需要「实体不存在则插入、存在则更新」的逻辑，不要使用updateEntity，请改用upsertEntity方法，该方法同样需要传入第二个参数指定更新模式。

内容的提问来源于stack exchange，提问作者Muerte