工作中用到了这个技术，把学习和实践过程记录一下。代码都在本地跑通过了，环境是Python 3.11。

先搞清楚原理

先说基本原理。Flyway的核心思路是索引结构选择。简单来说就是：把输入经过一系列变换，最终得到想要的结果。这个过程可以用下面的代码来理解：

-- 分区表创建
CREATE TABLE measurements_1 (
    id BIGSERIAL,
    sensor_id INTEGER NOT NULL,
    value DOUBLE PRECISION,
    recorded_at TIMESTAMP NOT NULL
) PARTITION BY RANGE (recorded_at);

CREATE TABLE measurements_1_q1 PARTITION OF measurements_1
    FOR VALUES FROM ('2024-01-01') TO ('2024-04-01');
CREATE TABLE measurements_1_q2 PARTITION OF measurements_1
    FOR VALUES FROM ('2024-04-01') TO ('2024-07-01');

CREATE INDEX idx_measurements_1_sensor ON measurements_1 (sensor_id, recorded_at);

EXPLAIN (ANALYZE, COSTS OFF)
SELECT * FROM measurements_1
WHERE recorded_at BETWEEN '2024-03-01' AND '2024-05-31';

实际怎么用

实际编码中，Flyway的用法可以简化。下面是我在项目中用的写法，经过几轮迭代优化过：

-- 存储过程与函数
CREATE OR REPLACE FUNCTION process_products(p_id INTEGER)
RETURNS TABLE(id INTEGER, status TEXT, result TEXT) AS $$
DECLARE
    v_record RECORD;
BEGIN
    FOR v_record IN SELECT * FROM products WHERE id = p_id LOOP
        IF v_record.status = 'pending' THEN
            UPDATE products SET status = 'processed' WHERE id = v_record.id;
            RETURN QUERY SELECT v_record.id, 'processed'::TEXT, 'success'::TEXT;
        ELSE
            RETURN QUERY SELECT v_record.id, v_record.status::TEXT, 'skipped'::TEXT;
        END IF;
    END LOOP;
    RETURN;
END;
$$ LANGUAGE plpgsql;

SELECT * FROM process_products(9);

进阶一点的用法

进阶一点的话，Flyway还有索引结构选择这个方向可以探索。原理不展开，直接看关键代码：

容易踩的坑

总结几个实际项目中的教训：Flyway在索引维护上容易出问题。建议写单元测试覆盖这些边界情况，免得线上出故障才后悔。

写在最后

Flyway的要点就这些。核心是索引维护，其他都是围绕这个展开的。代码已经贴在前面了，照着跑一遍基本就能上手。后续有新的发现再更新。

常见问题解答

Flyway入门难吗？

有编程基础的话上手不难，关键是多写代码实践。建议从简单示例开始，逐步深入。

Flyway和同类方案比有什么优势？

主要优势在于生态成熟、社区活跃、文档完善。具体选型还要看项目需求和技术栈。

Flyway生产环境要注意什么？

生产环境重点关注稳定性、监控和容错。建议做好压力测试，设置合理的超时和重试机制。

Flyway有哪些推荐的学习资源？

官方文档是最权威的参考。另外GitHub上的开源项目和博客文章也很有参考价值，建议边看边动手。

相关阅读