能否通过PowerShell上传JSON文件替换CosmosDB数据库当前索引策略？

完全可以通过PowerShell上传预先编写好的JSON文件来替换CosmosDB容器的索引策略，这正好能满足你版本控制、避免手动操作的需求。下面是具体的操作步骤：

1. 准备索引策略JSON文件 #

先把你已经编写完成的索引策略保存成一个JSON文件，比如命名为index-policy.json，示例内容参考如下（根据你的实际业务需求调整）：

{
  "indexingMode": "consistent",
  "automatic": true,
  "includedPaths": [
    {
      "path": "/*",
      "indexes": [
        {
          "kind": "Range",
          "dataType": "String",
          "precision": -1
        },
        {
          "kind": "Range",
          "dataType": "Number",
          "precision": -1
        }
      ]
    }
  ],
  "excludedPaths": [
    {
      "path": "/\"_etag\"/?"
    }
  ]
}

注意：务必保证JSON格式完全符合CosmosDB的索引策略规范，避免因格式错误导致操作失败

2. 配置Azure PowerShell环境 #

首先确认你已安装Az.CosmosDB模块，若未安装，先运行以下命令安装：

Install-Module -Name Az.CosmosDB -Force -AllowClobber

接着登录你的Azure账号：

Connect-AzAccount

如果你的Azure存在多个订阅，记得切换到目标CosmosDB所在的订阅：

Set-AzContext -SubscriptionId "你的订阅ID"

3. 执行索引策略替换操作 #

使用Set-AzCosmosDBSqlContainer命令完成替换，具体命令如下：

# 读取本地JSON文件并转换为PowerShell对象
$indexPolicy = Get-Content -Path "C:\你的文件路径\index-policy.json" -Raw | ConvertFrom-Json

# 替换容器的索引策略
Set-AzCosmosDBSqlContainer `
  -ResourceGroupName "你的资源组名称" `
  -AccountName "你的CosmosDB账户名" `
  -DatabaseName "目标数据库名" `
  -Name "目标容器名" `
  -IndexPolicy $indexPolicy

-Raw参数用于确保将整个JSON文件作为完整字符串读取，避免因换行等问题导致解析错误

额外实用建议 #

• 备份当前策略：替换前建议导出当前索引策略做备份，以防操作失误：

Get-AzCosmosDBSqlContainer -ResourceGroupName "资源组名" -AccountName "账户名" -DatabaseName "数据库名" -Name "容器名" | Select-Object -ExpandProperty IndexPolicy | ConvertTo-Json -Depth 10 | Out-File "backup-index-policy.json"

• 版本控制与自动化：把PowerShell脚本和索引策略JSON文件一起存入Git仓库，就能实现完整的版本管理。还可以将脚本集成到CI/CD流程（比如Azure DevOps Pipeline）中，一键完成部署，彻底告别手动操作。
• 验证JSON格式：执行替换前，用Test-Json命令验证文件格式是否合法：

Test-Json -Path "C:\你的文件路径\index-policy.json"

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