使用Terraform部署AWS RDS SQL Server实例时创建数据库的方法

一、你的local-exec配置为什么不可行？ #

你当前的local-exec命令只是单纯的SQL语句，没有指定连接目标数据库的上下文信息，Terraform无法直接执行这条SQL——必须通过SQL客户端工具（比如SQL Server的sqlcmd）连接到RDS实例后才能执行。

二、正确的local-exec实现方式 #

需要借助sqlcmd工具（需在Terraform运行的机器上预先安装），结合RDS实例的端点、认证信息执行建库语句，同时要确保RDS实例完全可用后再执行，避免连接失败。

示例配置：

# 从SSM参数存储获取数据库用户名和密码
data "aws_ssm_parameter" "db_username" {
  name = "somewhere/in/ssm/username"
}

data "aws_ssm_parameter" "db_password" {
  name = "somewhere/in/ssm/password"
  with_decryption = true
}

resource "aws_db_instance" "rds" {
  identifier     = "my_db"
  engine         = "sqlserver-se"
  engine_version = "14.00.3401.7.v1"

  username       = data.aws_ssm_parameter.db_username.value
  password       = data.aws_ssm_parameter.db_password.value

  # 补充RDS必要配置（根据实际需求调整）
  instance_class        = "db.t3.small"
  allocated_storage     = 20
  vpc_security_group_ids = [aws_security_group.rds_sg.id]
  publicly_accessible   = false
}

provisioner "local-exec" {
  # 仅在RDS首次创建时执行，避免重复建库
  when = create
  command = <<EOT
    # 等待RDS实例完全可用
    until sqlcmd -S ${aws_db_instance.rds.endpoint} -U ${data.aws_ssm_parameter.db_username.value} -P ${data.aws_ssm_parameter.db_password.value} -Q "SELECT 1" >nul 2>&1; do
      echo 等待RDS实例就绪...
      sleep 10
    done
    # 执行建库语句
    sqlcmd -S ${aws_db_instance.rds.endpoint} -U ${data.aws_ssm_parameter.db_username.value} -P ${data.aws_ssm_parameter.db_password.value} -Q "CREATE DATABASE db-name"
  EOT
}

注意事项：

• 运行Terraform的机器必须安装sqlcmd：Windows系统默认可能自带，Linux需安装mssql-tools包
• 确保RDS安全组允许Terraform运行机器的IP访问1433端口
• 数据库名称若包含特殊字符，需用方括号包裹（如[db-name-with-hyphens]）

三、更优雅的方案：使用官方hashicorp/sql Provider #

如果你觉得local-exec依赖本地环境不够可靠，推荐使用HashiCorp官方维护的sql Provider，它采用声明式方式管理数据库对象，更符合Terraform的设计理念。

步骤1：添加sql Provider配置

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "3.37.0"
    }
    sql = {
      source  = "hashicorp/sql"
      version = ">= 1.13.0"
    }
  }
}

provider "sql" {
  alias = "mssql"
  driver = "mssql"
  host = aws_db_instance.rds.endpoint
  username = data.aws_ssm_parameter.db_username.value
  password = data.aws_ssm_parameter.db_password.value
  port = 1433 # SQL Server默认端口
}

步骤2：创建数据库资源

resource "sql_database" "my_target_db" {
  provider = sql.mssql
  name = "db-name"
  # 确保RDS实例创建完成后再执行建库
  depends_on = [aws_db_instance.rds]
}

该方案优势：

• 声明式状态跟踪，不会重复创建数据库
• 不依赖本地SQL客户端工具
• 可直接通过Terraform管理数据库的生命周期

四、关于社区提供商的疑问 #

无需选择第三方社区提供商，hashicorp/sql是官方维护的组件，可靠性有保障。

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