初始化數據庫和導入數據

Spring Boot應用的測試一文中,我們在StarterRunner類的run(...)方法中給數據庫中添加一些初始數據。盡管通過編程方式添加初始數據比較快捷方便,但長期來看這并不是一個好辦法——特別是當需要添加的數據量很大時。我們開發最好把數據庫準備、數據庫修改和數據庫的配置與將要運行的程序代碼分離,盡管這僅僅是為測試用例做準備。Spring Boot已經提供了相應的支持來完成這個任務。

我們在之前的應用程序基礎上進行實驗。Spring Boot提供兩種方法來定義數據庫的表結構以及添加數據。第一種方法是使用Hibernate提供的工具來創建表結構,該機制會自動搜索@Entity實體對象并創建對應的表,然后使用import.sql文件導入測試數據;第二種方法是利用舊的Spring JDBC,通過schema.sql文件定義數據庫的表結構、通過data.sql導入測試數據。

How Do

  • 首先,將現有的“編程式初始化數據”的代碼注釋掉,因此在StarterRunner中run方法中注釋掉下列代碼:
    @Override
    public void run(String... strings) throws Exception {
//        Author author = new Author("du", "qi");
//        authorRepository.save(author);
//        Publisher publisher = new Publisher("中文測試");
//        publisherRepository.save(publisher);
//        Book book = new Book(author, "9876-5432-1111", publisher, "瞅啥");
//        book.setDescription("23333333,這是一本有趣的書");
//        bookRepository.save(book);
        logger.info("Number of books: " + bookRepository.count());
    }
  • 在resources目錄下新建import.sql文件(注意,SQL語句中指定的字段要與Hibernate自動生成的表的字段相同),該文件的內容如下:
INSERT INTO author (id, first_name, last_name) VALUES (1, 'Alex', 'Antonov');
INSERT INTO publisher (id, name) VALUES (1, 'Packt');
INSERT INTO book (isbn, title, author, publisher) VALUES ('9876-5432-1111', 'Spring Boot Recipes', 1,1);
  • 現在運行測試用例,發現可以通過;
  • 第二種方法是獲取Spring JDBC的支持,需要我們提供schema.sql和data.sql文件。現在可以將import.sql重命名為data.sql,然后再創建新的文件schema.sql。在刪除數據表時,需要考慮依賴關系,例如表A依賴表B,則先刪除表B。創建數據庫關系的內容如下:
-- clear context
DROP TABLE IF EXISTS `book_reviewers`;
DROP TABLE IF EXISTS `reviewer`;
DROP TABLE IF EXISTS `book`;
DROP TABLE IF EXISTS `author`;
DROP TABLE IF EXISTS `publisher`;

-- Create syntax for TABLE 'author'
CREATE TABLE `author` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT,
  `first_name` VARCHAR(255) DEFAULT NULL ,
  `last_name` VARCHAR(255) DEFAULT NULL ,
  PRIMARY KEY (`id`)
);

-- Create syntax for TABLE 'publisher'
CREATE TABLE `publisher` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT,
  `name` VARCHAR(255) DEFAULT NULL ,
  PRIMARY KEY (`id`)
);

-- Create syntax for TABLE 'book'
CREATE TABLE `book` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT,
  `description` VARCHAR(255) DEFAULT NULL ,
  `isbn` VARCHAR(255) DEFAULT NULL ,
  `title` VARCHAR(255) DEFAULT NULL ,
  `author` BIGINT(20) DEFAULT NULL ,
  `publisher` BIGINT(20) DEFAULT NULL ,
  PRIMARY KEY (`id`),
  CONSTRAINT `FK_publisher` FOREIGN KEY (`publisher`) REFERENCES `publisher` (`id`),
  CONSTRAINT `FK_author` FOREIGN KEY (`author`) REFERENCES `author` (`id`)
);

-- Create syntax for TABLE 'reviewer'
CREATE TABLE `reviewer` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT,
  `first_name` VARCHAR(255) DEFAULT NULL ,
  `last_name` VARCHAR(255) DEFAULT NULL ,
  PRIMARY KEY (`id`)
);

-- Create syntax for TABLE 'book_reviewers'
CREATE TABLE `book_reviewers` (
  `books` BIGINT(20) NOT NULL ,
  `reviewers` BIGINT(20) NOT NULL ,
  CONSTRAINT `FK_book` FOREIGN KEY (`books`) REFERENCES `book` (`id`),
  CONSTRAINT `FK_reviewer` FOREIGN KEY (`reviewers`) REFERENCES `reviewer` (`id`)
);
  • 我們手動創建了數據庫表結構,因此需要關掉Hibernate的自動創建開關,即在application.properties中設置spring.jpa.hibernate.ddl-auto = none
  • 運行測試,發現測試可以正常通過。

Note:個人建議是使用Hibernate的自動創建機制,當然這會少一點可定制性;最近更流行的是Mybatis,mybatis-spring-boot也可以使用,mybatis的可定制性更強。

分析

在Spring社區中常常可以通過使用各種組件,例如Spring JDBC、Spring JPA with Hibernate,或者Flyway、Liquidbase這類數據庫遷移工具,都能實現類似的功能。

Note:Flyway和Liquidbase都提供數據庫的增量遷移功能。當項目中需要管理數據庫的增量變動,并且需要快速切換到指定的數據版本時,非常適合使用Flyway和Liquidbase,更多的信息可以參考http://flywaydb.org/http://www.liquibase.org/

在上文中我們使用了兩種不同的方法來初始化數據庫和填充測試數據

使用Spring JPA with Hibernate初始化數據庫

這種方法中,由Hibernate庫完成大部分工作,我們只需要配置合適的配置項,并創建對應的實體類的定義。在這個方案中我們主要使用以下配置項:

  • spring.jpa.hibernate.ddl-auto=create-drop配置項告訴Hibernate通過@Entity模型的定義自動推斷數據庫定義并創建合適的表。在程序啟動時,經由Hibernate計算出的schema會用來創建表結構,在程序結束時這些表也被刪除。即使程序強制退出或者奔潰,在重新啟動的時候也會先把之前的表刪除,并重新創建——因此"create-drop"這種配置不適合生產環境。PS:如果程序沒有顯式配置spring.jpa.hibernate.ddl-auto屬性,Spring Boot會給H2這類的嵌入式數據庫配置create-drop,因此需要仔細斟酌這個配置項。

  • 在classpath下創建import.sql文件供Hibernate使用,該文件中的內容是一些SQL語句,將會在應用程序啟動時運行。盡管該文件中可以寫任何有效的SQL語句,不過建議只寫數據操作語句,例如INSERT、UPDATE等等。

使用Spring JDBC初始化數據庫

如果項目中沒有用JPA或者你不想依賴Hibernate庫,Spring提供另外一種方法來設置數據庫,當然,首先需要提供spring-boot-starter-jdbc依賴。

  • spring.jpa.hibernate.ddl-auto=none表示Hibernate不會自動創建數據庫表結構。在生產環境中最好用這個設置,能夠避免你不小心將數據庫全部刪除(那一定是一個噩夢)。

  • schema.sql文件包含創建數據庫表結構的SQL語句,在應用程序啟動過程中,需要創建數據庫表結構時,執行該文件中的DDL語句。Hibernate會自動刪除已經存在的表,如果我們希望只有某個表不存在的時候才創建它,可以在這個文件開頭最好先使用DROP TABLE IF EXISTS刪除可能存在的表,再使用CREATE TABLE IF NOT EXISTS創建表。這種用法可以靈活得定義數據庫中的表結構,因此在生產環境中用更安全。

  • data.sql的作用跟上一個方法的import.sql一樣,用于存放數據導入的SQL語句。

考慮到這是Spring的特性,我們可以不只是全局定義數據庫定義文件,還可以針對不同的數據庫定義不同的文件。例如,可以定義給Oracle數據庫使用的schema-oracle.sql,給MySQL數據庫用的schema-mysql.sql文件;對于data.sql文件,則可以由不同數據庫共用。如果你希望覆蓋Spring Boot的自動推斷,可以配置spring.datasource.platform屬性。

Tip:如果你希望使用別的名字代替schema.sql或者data.sql,Spring Boot也提供了對應的配置屬性,即spring.datasource.schemaspring.datasource.data


本號專注于后端技術、JVM問題排查和優化、Java面試題、個人成長和自我管理等主題,為讀者提供一線開發者的工作和成長經驗,期待你能在這里有所收獲。


javaadu
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,983評論 6 537
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,772評論 3 422
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,947評論 0 381
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,201評論 1 315
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,960評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,350評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,406評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,549評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,104評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,914評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,089評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,647評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,340評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,753評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,007評論 1 289
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,834評論 3 395
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,106評論 2 375

推薦閱讀更多精彩內容

  • 0. 前言 本文參考的主要是Spring Boot 1.5.8官方文檔,寫這篇文章的原因是,在做Spring Bo...
    SYFHEHE閱讀 22,493評論 0 13
  • Spring Boot 參考指南 介紹 轉載自:https://www.gitbook.com/book/qbgb...
    毛宇鵬閱讀 46,900評論 6 342
  • Spring Cloud為開發人員提供了快速構建分布式系統中一些常見模式的工具(例如配置管理,服務發現,斷路器,智...
    卡卡羅2017閱讀 134,799評論 18 139
  • 一個數據庫可以使用不同的方式進行初始化,這取決于你的技術棧。或者你可以手動完成該任務,只要數據庫是單獨的過程。 1...
    OzanShareing閱讀 579評論 0 2
  • 關于“落后”的三個問題: 第一,1%之后都有可能是落后; 我們上學的時候,都知道考試不及格,也就是說60分的及格線...
    松球42閱讀 249評論 0 1