Azure Data Explorer集群无法附加数据库：Terraform部署报错排查

已创建Azure Data Explorer（ADX）集群Cluster 2，尝试通过Terraform与Azure DevOps附加来自ADX集群Cluster 1的数据库Db1。但执行azurerm_kusto_attached_database_configuration资源时出现如下错误，请问问题出在哪里、缺少什么配置？该错误暗示了什么？

│ Error: creating/updating Attached Database Configuration (Subscription: "xx"
│ Resource Group Name: "x-rg"
│ Cluster Name: "x"
│ Attached Database Configuration Name: "x"): polling after CreateOrUpdate: Code="Failed" Message="Internal Server Error"
│
│   with module.labs_kusto.azurerm_kusto_attached_database_configuration.this["x"],
│   in resource "azurerm_kusto_attached_database_configuration" "this":

问题分析与解决方案 #

可能的问题与缺失配置 #

• 权限配置不到位：
  • Cluster 1必须对Cluster 2授予Microsoft.Kusto/clusters/attachedDatabaseConfigurations/write权限，或者Terraform使用的服务主体需要拥有Cluster 1的Kusto Database User及以上权限（比如Kusto Admin）。
  • 确认服务主体同时拥有两个集群所在资源组的Contributor权限，或至少拥有ADX集群的管理权限。
• 跨环境配置遗漏：
  若Cluster 1和Cluster 2分属不同区域或订阅：
  • 必须先建立集群对等连接，且确保对等状态为Connected。
  • 跨订阅场景下，要在Cluster 2所在订阅注册Microsoft.Kusto资源提供商，同时双方集群的防火墙规则需允许彼此的IP访问。
• 参数或数据库状态错误：
  • 检查Cluster 1中的Db1是否处于正常可用状态（未挂起、未删除），且Terraform配置里的数据库名称拼写完全一致。
  • 核对cluster_resource_id（Cluster 1的完整资源ID）、database_name、location（需与Cluster 2同区域）等参数，确保订阅ID、资源组名称无拼写错误。

错误暗示的信息 #

这个Internal Server Error一般不是Terraform的问题，而是Azure Kusto服务端处理附加请求时遇到了未预期的异常。大概率是以下几种情况：

• 权限不足导致操作被拒绝，但服务端未返回明确的权限错误；
• 集群对等连接未完成或状态异常；
• 源数据库或集群状态不一致；
• Azure Kusto服务端临时故障。

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