Atlas项目中利用glob模式简化多文件Schema配置

在Atlas项目中，当我们需要管理包含大量Schema文件的数据库环境时，手动维护每个环境中的文件列表会变得非常繁琐。本文将介绍如何使用Atlas提供的glob函数来简化这一过程。

传统配置方式的痛点

在Atlas的早期版本中，开发者需要为每个环境显式列出所有Schema文件路径。例如，对于一个包含多个领域模块的项目，配置可能如下：

env "dev" {
  src = [
    "file://src/domain/a/a.pg.hcl",
    "file://src/domain/b/b.pg.hcl",
    "file://src/domain/c/c.pg.hcl"
    // 更多文件...
  ]
}

这种方式存在几个明显问题：

1. 每次新增Schema文件都需要手动更新配置
2. 多个环境间需要重复相同的文件列表
3. 容易遗漏文件更新，导致配置不一致

使用glob函数简化配置

Atlas的最新版本引入了glob函数，它支持使用通配符模式匹配文件路径。我们可以将上述配置简化为：

env "dev" {
  src = glob("src/domain/**/*.pg.hcl")
}

glob函数详解

glob函数支持以下通配符：

• * 匹配任意非分隔符字符序列
• ** 匹配任意字符序列，包括分隔符（可跨目录）
• ? 匹配任意单个非分隔符字符
• [字符类] 匹配字符类中的任意字符

实际应用示例

假设项目结构如下：

src/
  domain/
    user/
      schema.pg.hcl
    product/
      schema.pg.hcl
    order/
      schema.pg.hcl

我们可以使用以下配置匹配所有Schema文件：

env "dev" {
  src = glob("src/domain/**/schema.pg.hcl")
}

或者匹配特定扩展名的所有文件：

env "prod" {
  src = glob("src/domain/**/*.pg.hcl")
}

注意事项

1. glob模式基于项目根目录解析，路径应以相对路径表示
2. 匹配结果不保证顺序，如有依赖关系需单独处理
3. 复杂项目可能需要组合多个glob模式
4. 某些特殊字符可能需要转义处理

通过使用glob函数，开发者可以大幅简化Atlas项目的Schema管理，提高开发效率并减少配置错误。这一特性特别适合采用领域驱动设计(DDD)或微服务架构的项目，其中Schema文件通常分散在多个模块目录中。