flyway使用配置参数和注意事项介绍

2024-01-27 08:12
文章标签 配置 参数 使用 介绍 注意事项 flyway

本文主要是介绍flyway使用配置参数和注意事项介绍，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

    • 业务场景
    • 参数介绍
      • initSqls
      • baselineOnMigrate
      • baselineVersion
      • target
      • validateOnMigrate
    • SQL注意事项

业务场景

  • 对于生产环境，随着项目版本迭代，数据库结构也会变动。如果一个项目在多个地方实施部署，且版本不一致，就需要一个方法来管理数据库结构。
  • flyway是个简单易用的轻量级数据库版本管理工具，可以让我们像使用 Git 管理代码一样，对数据库版本和变动，进行详细的记录
  • 使用flyway时，我们按照版本整理数据库SQL脚本，当发布新的项目版本时，同时发布SQL变动文件
  • 举例说明，对于第一个正式版本，我们的SQL文件包含数据库表初始化SQL，数据的初始化SQL；对于第二个版本，我们需要数据库表结构变动的SQL。每一个SQL文件都带有版本号，在各地实施时，会根据基础版本号和schema表里记录的情况，自动进行数据库结构校验和更新，保持表结构一致。
  • 对于新部署的项目，没有数据，可以不指定初始版本，直接从第一个数据库脚本开始执行，创建数据库，初始化数据，一直更新到需要的版本
  • 对于已经在运行的项目，数据库是已有的，里面也有客户的数据，不需要走创建数据库和初始化数据的过程。这时候需要设置基础版本的版本号，在进行表结构更新时，就会忽略之前的版本的SQL文件，只执行需要更新的SQL文件

参数介绍

  • 我的flyway的在spring boot应用里的application.yml配置
spring:datasource:type: com.zaxxer.hikari.HikariDataSourceurl: jdbc:postgresql://192.168.x.xx:5432/coreusername: xxxpassword: xxxxxxxhikari:poolName: Hikariauto-commit: falseflyway:enabled: trueschemas: publicencoding: UTF-8locations: classpath:db/migrationsql-migration-prefix: Vsql-migration-separator: __sql-migration-suffixes: .sqltable: flyway_schema_historybaseline-on-migrate: truevalidate-on-migrate: truebaseline-version: 2.0.0.1
  • enabled：默认true，是否启用flyway，设置为true，flyway才会生效
  • locations：默认classpath:db/migration，迁移脚本的位置
  • schemas：由 Flyway 管理的schema的名称（区分大小写）
  • encoding：默认UTF_8，SQL 迁移的编码
  • table：默认flyway_schema_history，Flyway 将使用的架构历史表的名称。
  • sqlMigrationPrefix：默认V，SQL 迁移的文件名前缀
  • sqlMigrationSuffixes：默认.sql，SQL 迁移的文件名后缀
  • sqlMigrationSeparator：默认__，SQL 迁移的文件名分隔符
  • repeatableSqlMigrationPrefix：默认R，可重复 SQL 迁移的文件名前缀
  • cleanDisabled：是否禁用数据库清理
  • cleanOnValidationError：验证错误时是否自动调用clean
  • baselineVersion：默认1，执行基线时用于标记现有模式的版本
  • target：应考虑迁移到的目标版本
  • initSqls：获取连接后立即执行初始化连接的 SQL 语句
  • baselineOnMigrate：迁移非空schema时是否自动调用基线
  • validateMigrationNaming：默认false，是否验证脚本不遵守正确命名约定的迁移和回调
  • validateOnMigrate：默认true，执行迁移时是否自动调用validate
  • 下面对于我有使用经验的，个人认为比较重要的几个参数，详细讲一下。

initSqls

  • 对于初次部署的系统，可以使用flyway新建表和初始化数据，但是没法新建库
  • 一开始想用init-sqls参数建库，发现不行
  • 一方面，在数据库连接参数url里就要指定库名了，如果这时候库还没创建，连接这个库的时候就会报错了，也不会进行下去
  • 另一方面，postgresql不支持create xx if not exists的用法，没法判断库不存在再去创建
  • initSqls参数，可以指定一些SQL语句，获取连接后立即执行初始化连接的 SQL 语句
  • 我没有需要在连接后执行SQL语句的场景，暂时未使用此参数

baselineOnMigrate

  • baseline-on-migrate参数，迁移非空schema时是否自动调用基线，主要是指数据库已存在，已经有数据库表和数据，此时开始使用flyway管理数据库的场景（此时flyway_schema_history表不存在）
  • schema（一般默认都是public）为空时，baseline-on-migrate参数就没有意义了，为空就直接走创建过程了，维护表结构时，会首先创建flyway_schema_history表，再去逐个执行SQL脚本
  • 在判断schema（一般默认都是public）非空时，设值为false，flyway_schema_history表不存在，就返回报错
    在这里插入图片描述
  • 在判断schema（一般默认都是public）非空时，设置为true，会去创建flyway_schema_history表，然后按照版本号逐个执行SQL文件

baselineVersion

  • baseline-version参数，指定基础版本，只有大于这个版本的SQL文件才会被检查和执行
  • 需要注意的是，只有在flyway_schema_history表不存在时，baseline-version参数才会生效
    在这里插入图片描述
  • 当flyway_schema_history表存在时，会根据表里的记录继续进行升级，baseline-version参数没有意义
  • 当schema表存在但表内容为空时，baseline-version参数同样没有意义，会根据locations的SQL文件，逐个版本升级，直到最新或者target版本
    在这里插入图片描述

target

  • 默认是迁移到最新版本，不配置时，就会根据locations的SQL文件，逐个版本升级，一直到全部文件执行完成
  • 如果指定版本号，则迁移到该版本，后续版本不升级
    在这里插入图片描述

validateOnMigrate

  • 默认true，执行迁移时自动调用validate，对SQL文件进行校验
  • 如果已有flyway_schema_history，会对里面的记录逐个校验checksum字段的值
  • 每个文件，会根据文件信息，生成一个 checksum 值，flyway在SQL文件执行时会在表里插入一条记录，包含checksum值
  • 当已经同步过的SQL文件发生变动时， checksum 值就会和数据库里的记录对应不上，就会校验失败
    在这里插入图片描述

SQL注意事项

  • 保证SQL能正确执行，可以多加些判断
  • 建表语句，新增字段的语句，可以多加一个IF NOT EXISTS
CREATE TABLE IF NOT EXISTS "public"."sys_log"
("id"      int8 NOT NULL,"op_desc" varchar(255) COLLATE "pg_catalog"."default","op_time" timestamp(6),CONSTRAINT "sys_log_pkey" PRIMARY KEY ("id")
);ALTER TABLE "public"."sys_setting" ADD COLUMN IF NOT EXISTS "enable_scheme_review" bool NOT NULL DEFAULT false;
  • 删除语句，可以多加一个IF EXISTS
ALTER TABLE "public"."wireless_security" DROP COLUMN IF EXISTS "dev_no";
ALTER TABLE "public"."bayonet" DROP CONSTRAINT IF EXISTS "fk_bayonet__intersection_id";
  • postgresql不支持create xx if not exists的用法，如果是增加外键、唯一键等操作，可以尝试先删除后新增，保证SQL一定执行成功
ALTER TABLE "public"."vip_traffic_movement" DROP CONSTRAINT IF EXISTS "fk_vip_traffic_movement__vip_route_config_id";
ALTER TABLE "public"."vip_traffic_movement" ADD CONSTRAINT "fk_vip_traffic_movement_vip_route_config_id" FOREIGN KEY ("vip_route_config_id") REFERENCES "public"."vip_route_config" ("id") ON DELETE NO ACTION ON UPDATE NO ACTION;

这篇关于flyway使用配置参数和注意事项介绍的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/649612。

相关文章

Zookeeper安装和配置说明

Zookeeper安装和配置说明

一、Zookeeper的搭建方式 Zookeeper安装方式有三种，单机模式和集群模式以及伪集群模式。 ■ 单机模式：Zookeeper只运行在一台服务器上，适合测试环境； ■ 伪集群模式：就是在一台物理机上运行多个Zookeeper 实例； ■ 集群模式：Zookeeper运行于一个集群上，适合生产环境，这个计算机集群被称为一个“集合体”（ensemble） Zookeeper通过复制来实现
阅读更多...
CentOS7安装配置mysql5.7 tar免安装版

CentOS7安装配置mysql5.7 tar免安装版

一、CentOS7.4系统自带mariadb # 查看系统自带的Mariadb[root@localhost~]# rpm -qa|grep mariadbmariadb-libs-5.5.44-2.el7.centos.x86_64# 卸载系统自带的Mariadb[root@localhost ~]# rpm -e --nodeps mariadb-libs-5.5.44-2.el7
阅读更多...
性能测试介绍

性能测试介绍

性能测试是一种测试方法，旨在评估系统、应用程序或组件在现实场景中的性能表现和可靠性。它通常用于衡量系统在不同负载条件下的响应时间、吞吐量、资源利用率、稳定性和可扩展性等关键指标。 为什么要进行性能测试 通过性能测试，可以确定系统是否能够满足预期的性能要求，找出性能瓶颈和潜在的问题，并进行优化和调整。 发现性能瓶颈：性能测试可以帮助发现系统的性能瓶颈，即系统在高负载或高并发情况下可能出现的问题
阅读更多...
中文分词jieba库的使用与实景应用（一）

中文分词jieba库的使用与实景应用（一）

知识星球：https://articles.zsxq.com/id_fxvgc803qmr2.html 目录 一.定义： 精确模式（默认模式）： 全模式： 搜索引擎模式： paddle 模式（基于深度学习的分词模式）： 二 自定义词典 三.文本解析   调整词出现的频率 四. 关键词提取 A. 基于TF-IDF算法的关键词提取 B. 基于TextRank算法的关键词提取
阅读更多...
水位雨量在线监测系统概述及应用介绍

水位雨量在线监测系统概述及应用介绍

在当今社会，随着科技的飞速发展，各种智能监测系统已成为保障公共安全、促进资源管理和环境保护的重要工具。其中，水位雨量在线监测系统作为自然灾害预警、水资源管理及水利工程运行的关键技术，其重要性不言而喻。 一、水位雨量在线监测系统的基本原理 水位雨量在线监测系统主要由数据采集单元、数据传输网络、数据处理中心及用户终端四大部分构成，形成了一个完整的闭环系统。 数据采集单元：这是系统的“眼睛”，
阅读更多...
使用SecondaryNameNode恢复NameNode的数据

使用SecondaryNameNode恢复NameNode的数据

1）需求： NameNode进程挂了并且存储的数据也丢失了，如何恢复NameNode 此种方式恢复的数据可能存在小部分数据的丢失。 2）故障模拟 （1）kill -9 NameNode进程 [lytfly@hadoop102 current]$ kill -9 19886 （2）删除NameNode存储的数据（/opt/module/hadoop-3.1.4/data/tmp/dfs/na
阅读更多...
hadoop开启回收站配置

hadoop开启回收站配置

开启回收站功能，可以将删除的文件在不超时的情况下，恢复原数据，起到防止误删除、备份等作用。 开启回收站功能参数说明 （1）默认值fs.trash.interval = 0，0表示禁用回收站；其他值表示设置文件的存活时间。 （2）默认值fs.trash.checkpoint.interval = 0，检查回收站的间隔时间。如果该值为0，则该值设置和fs.trash.interval的参数值相等。
阅读更多...
NameNode内存生产配置

NameNode内存生产配置

Hadoop2.x 系列，配置 NameNode 内存 NameNode 内存默认 2000m ，如果服务器内存 4G ， NameNode 内存可以配置 3g 。在 hadoop-env.sh 文件中配置如下。 HADOOP_NAMENODE_OPTS=-Xmx3072m Hadoop3.x 系列，配置 Nam
阅读更多...
Hadoop数据压缩使用介绍

Hadoop数据压缩使用介绍

一、压缩原则 （1）运算密集型的Job，少用压缩 （2）IO密集型的Job，多用压缩 二、压缩算法比较 三、压缩位置选择 四、压缩参数配置 1）为了支持多种压缩/解压缩算法，Hadoop引入了编码/解码器 2）要在Hadoop中启用压缩，可以配置如下参数
阅读更多...
Makefile简明使用教程

Makefile简明使用教程

文章目录 规则makefile文件的基本语法：加在命令前的特殊符号：.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具，常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2