record update — 更新记录

命令格式

Usage:
  dws aitable record update [flags]
Example:
  dws aitable record update --base-id <BASE_ID> --table-id <TABLE_ID> \
    --records '[{"recordId":"recXXX","cells":{"fldStatusId":"已完成"}}]'
Flags:
      --base-id string        Base ID (必填)
      --records string        待更新记录 JSON 数组，单次最多 100 条；cells key 支持 fieldId 或当前表内唯一字段名，推荐 fieldId (必填，与 --records-file 二选一)
      --records-file string   从文件读取 records JSON（替代 --records，适合超长数据或 Windows 环境）
      --table-id string       Table ID (必填)

只需传入需修改的字段，未传入的保持原值。每条记录必须含 recordId 和 cells。

cells key：优先使用 fieldId，也支持唯一字段名

cells 的 key 有两种写法：

fieldId（推荐）：不受字段重命名或重名影响，通过 field get 获取。
当前表内唯一的字段名：按名称精确匹配；如果存在同名字段，必须改用 fieldId。

同一字段同时通过 fieldId 和字段名传入时，fieldId 对应的值优先。

# 推荐：fieldId
dws aitable record update --base-id <BASE_ID> --table-id <TABLE_ID> \
  --records '[{"recordId":"recXXX","cells":{"fldStatusId":"已完成"}}]' --format json

# 便捷写法：当前表内唯一字段名
dws aitable record update --base-id <BASE_ID> --table-id <TABLE_ID> \
  --records '[{"recordId":"recXXX","cells":{"状态":"已完成"}}]' --format json

不推荐或无效写法	推荐写法
`--record-id recXXX --cells '{"fldX":"值"}'`（隐藏兼容入口）	`--records '[{"recordId":"recXXX","cells":{"fldX":"值"}}]'`
`--id recXXX --data '{"fldX":"值"}'`	同上
`--record-id recXXX --field fldX --value "新值"`	同上

单条更新模板（直接复制）

dws aitable record update --base-id <BASE_ID> --table-id <TABLE_ID> \
  --records '[{"recordId":"<RECORD_ID>","cells":{"<FIELD_ID>":"新值"}}]' --format json

# 从更新响应的 data.recordIds[] 提取成功记录 ID，并回读确认真实值
dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID> \
  --record-ids <RECORD_ID> --format json

更新响应不返回“受影响字段”；以 data.recordIds[] 确定成功记录，再用查询回读验证。

引号转义提示

Linux/macOS：外层用单引号 '[...]'，内部 JSON 用双引号即可
Windows PowerShell：外层用双引号 "[...]"，内部双引号需转义为 \"
或将 JSON 写入临时文件，用 --records-file ./records.json 规避转义

2.9 KiB Raw Blame History

record update — 更新记录

命令格式

cells key：优先使用 fieldId，也支持唯一字段名

推荐参数形式

单条更新模板（直接复制）

引号转义提示

2.9 KiB

Raw Blame History