已分片Atlas MongoDB集群如何通过API等途径为集合添加分片键

给已开启分片功能的Atlas MongoDB集群集合配置分片键，本质是执行shardCollection数据库命令，所有可向Atlas数据面发起合法admin命令的通道都可完成该操作，完全不需要依赖Mongo Shell，也无需使用适配性较差的Terraform，具体可落地的途径如下：

• Atlas Data API调用
  这是Atlas原生提供的HTTP形式数据接口，无需安装任何MongoDB客户端工具：先在Atlas控制台开启目标集群的Data API功能，生成具备集群管理权限的API Key，直接向接口发起runCommand请求即可。核心请求体参考：

  {
    "dataSource": "你的Atlas集群标识名",
    "database": "admin",
    "command": {
      "shardCollection": "<目标数据库名>.<目标集合名>",
      "key": {"<你的分片键字段>": 1}
    }
  }
  

  该方式完全适配自动化运维场景，请求发起到执行完成全程不需要登录服务器操作Mongo Shell。
• 官方MongoDB Driver脚本调用
  所有官方维护的MongoDB语言驱动（Python、Node.js、Go、Java等）都支持直接执行数据库原生命令，你可以写几行简单的脚本完成操作，不需要依赖Shell环境。以Python驱动为例，核心逻辑如下：

  from pymongo import MongoClient
  # 替换为你的Atlas集群连接串，使用拥有分片管理权限的数据库账号
  client = MongoClient("mongodb+srv://<账号>:<密码>@<集群地址>/")
  admin_db = client["admin"]
  # 执行分片集合命令
  admin_db.command(
      "shardCollection",
      "目标数据库名.目标集合名",
      key={"分片键字段": 1}
  )
  

  该方式适合集成到CI/CD流程、内部运维平台中，灵活度最高。
• Atlas控制台可视化操作
  如果是单次手动操作，不需要做自动化适配，直接登录Atlas管理控制台，进入目标集群的Collections页面，选中需要配置的空集合，在集合设置项中找到分片键配置入口，可视化选择分片键字段提交即可，全程不需要输入任何命令。

注意事项：

1. 目前Atlas管控面API（负责集群创建、规格调整、网络配置等生命周期管理的接口）没有开放集合级分片键配置能力，分片键属于数据面操作，必须通过上述数据面通道完成；
2. 和Mongo Shell下的限制一致，只有空集合可以直接配置分片键，非空集合配置分片键需要提前满足对应索引、数据量要求，否则会执行报错。

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