ការដាក់ពង្រាយពេលមិនដំណើរការ និងមូលដ្ឋានទិន្នន័យ

អត្ថបទនេះពន្យល់លម្អិតអំពីរបៀបដោះស្រាយបញ្ហាភាពឆបគ្នានៃមូលដ្ឋានទិន្នន័យនៅក្នុងការដាក់ឱ្យប្រើប្រាស់។ យើងនឹងប្រាប់អ្នកពីអ្វីដែលអាចកើតឡើងចំពោះកម្មវិធីផលិតកម្មរបស់អ្នក ប្រសិនបើអ្នកព្យាយាមដាក់ពង្រាយដោយគ្មានការរៀបចំជាមុន។ បន្ទាប់​មក​យើង​នឹង​ឆ្លង​កាត់​ដំណាក់​កាល​ដំណើរ​ជីវិត​របស់​កម្មវិធី​ដែល​តម្រូវ​ឱ្យ​មាន​ពេល​វេលា​មិន​ដំណើរការ (ប្រហែល ផ្លូវ៖ បន្ថែមទៀត - សូន្យពេលវេលារងចាំ) លទ្ធផលនៃប្រតិបត្តិការរបស់យើងនឹងអនុវត្តការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យដែលមិនឆបគ្នាថយក្រោយក្នុងលក្ខណៈដែលឆបគ្នាថយក្រោយ។

ប្រសិនបើអ្នកចង់យល់ពីឧទាហរណ៍កូដពីអត្ថបទ អ្នកអាចស្វែងរកពួកវានៅ GitHub.

សេចក្តីណែនាំ

ការ​ដាក់​ពង្រាយ​ពេល​វេលា​មិន​ដំណើរការ

អ្វីដែលជាអាថ៌កំបាំង ការដាក់ពង្រាយពេលទំនេរសូន្យ? អ្នកអាចនិយាយបានថានេះគឺជាពេលដែលកម្មវិធីរបស់អ្នកត្រូវបានដាក់ឱ្យប្រើប្រាស់តាមរបៀបដែលអ្នកអាចណែនាំកំណែថ្មីនៃកម្មវិធីដោយជោគជ័យក្នុងការផលិត ខណៈពេលដែលអ្នកប្រើប្រាស់មិនកត់សំគាល់ភាពមិនអាចប្រើបានរបស់វា។ តាមទស្សនៈរបស់អ្នកប្រើ និងក្រុមហ៊ុន នេះគឺជាសេណារីយ៉ូនៃការដាក់ពង្រាយដ៏ល្អបំផុតដែលអាចធ្វើទៅបាន ព្រោះវាអនុញ្ញាតឱ្យលក្ខណៈពិសេសថ្មីៗត្រូវបានណែនាំ និងកំហុសត្រូវបានជួសជុលដោយមិនមានការរំខាន។

តើធ្វើដូចម្តេចដើម្បីសម្រេចបាននេះ? មានវិធីជាច្រើន នេះគឺជាវិធីមួយក្នុងចំណោមវិធីទាំងនេះ៖

• ដាក់ពង្រាយកំណែលេខ 1 នៃសេវាកម្មរបស់អ្នក។
• ធ្វើការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យ
• ប្រើកំណែ #2 នៃសេវាកម្មរបស់អ្នកស្របជាមួយកំណែ #1
• ដរាបណាអ្នកឃើញថាកំណែលេខ 2 ដំណើរការដូចដែលវាគួរតែ សូមលុបកំណែលេខ 1 ចេញ
• រួចរាល់!

ងាយស្រួលទេ? ជាអកុសល វាមិនសាមញ្ញនោះទេ ហើយយើងនឹងពិនិត្យមើលវាឱ្យលម្អិតនៅពេលក្រោយ។ ឥឡូវនេះ សូមពិនិត្យមើលដំណើរការដាក់ពង្រាយធម្មតាមួយផ្សេងទៀត - ការដាក់ពង្រាយពណ៌បៃតងខៀវ។

តើអ្នកធ្លាប់ heard អំពី ការដាក់ពង្រាយពណ៌ខៀវបៃតង? Cloud Foundry ធ្វើឱ្យវាងាយស្រួលបំផុត។ គ្រាន់តែមើល អត្ថបទនេះដែលជាកន្លែងដែលយើងពិពណ៌នាលម្អិតបន្ថែមទៀត។ ដើម្បីសង្ខេបដោយសង្ខេប អនុញ្ញាតឱ្យយើងរំលឹកអ្នកពីរបៀបដាក់ពង្រាយពណ៌ខៀវបៃតង៖

• ត្រូវប្រាកដថាច្បាប់ចម្លងពីរនៃកូដផលិតកម្មរបស់អ្នក ("ខៀវ" និង "បៃតង") ដំណើរការ។
• ដឹកនាំចរាចរណ៍ទាំងអស់ទៅកាន់បរិស្ថានពណ៌ខៀវ, i.e. ដូច្នេះ URLs ផលិតកម្មចង្អុលទៅទីនោះ;
• ដាក់ពង្រាយ និងសាកល្បងការផ្លាស់ប្តូរកម្មវិធីទាំងអស់នៅក្នុងបរិស្ថានបៃតង។
• ប្តូរ url ពីពណ៌ខៀវទៅបរិស្ថានបៃតង

ការ​ដាក់​ពង្រាយ​ពណ៌​បៃតង​ខៀវ​គឺ​ជា​វិធីសាស្ត្រ​ដែល​អនុញ្ញាត​ឱ្យ​អ្នក​ងាយស្រួល​ណែនាំ​មុខងារ​ថ្មីៗ​ដោយ​មិន​បាច់​បារម្ភ​ពី​ការ​បំបែក​ផលិតកម្ម។ នេះគឺដោយសារតែការពិតដែលថា ទោះបីជាមានអ្វីមួយកើតឡើងក៏ដោយ អ្នកអាចវិលត្រលប់ទៅបរិយាកាសពីមុនបានយ៉ាងងាយស្រួលដោយគ្រាន់តែ “ចុចបិទបើក”។

បន្ទាប់ពីបានអានទាំងអស់ខាងលើ អ្នកអាចនឹងសួរសំណួរថា តើពេលទំនេរគ្មានជាប់ទាក់ទងនឹងការដាក់ពង្រាយពណ៌ខៀវបៃតង?

ជាការប្រសើរណាស់ ពួកគេមានច្រើនដូចគ្នា ចាប់តាំងពីការរក្សាបាននូវច្បាប់ចម្លងពីរនៃបរិស្ថានដូចគ្នាទាមទារឱ្យមានការខិតខំប្រឹងប្រែងទ្វេដងក្នុងការថែរក្សាពួកគេ។ នេះ​ជា​មូលហេតុ​ដែល​ក្រុម​ខ្លះ​អះអាង Martin Fowlerសូមអនុវត្តតាមបំរែបំរួលនៃវិធីសាស្រ្តនេះ៖

ជម្រើសមួយទៀតគឺប្រើមូលដ្ឋានទិន្នន័យដូចគ្នា បង្កើតកុងតាក់ពណ៌ខៀវបៃតងសម្រាប់ស្រទាប់គេហទំព័រ និងដែន។ នៅក្នុងវិធីសាស្រ្តនេះ ជាញឹកញាប់មូលដ្ឋានទិន្នន័យអាចមានបញ្ហា ជាពិសេសនៅពេលដែលអ្នកត្រូវការផ្លាស់ប្តូរគ្រោងការណ៍របស់វាដើម្បីគាំទ្រកំណែថ្មីនៃកម្មវិធី។

ហើយនៅទីនេះយើងមកដល់បញ្ហាចម្បងនៅក្នុងអត្ថបទនេះ។ មូលដ្ឋានទិន្នន័យ. សូមក្រឡេកមើលឃ្លានេះមួយទៀត។

ធ្វើការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យ។

ឥឡូវអ្នកត្រូវសួរខ្លួនឯងនូវសំណួរ - ចុះបើការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យមិនត្រូវគ្នាវិញ? តើ​កំណែ​កម្មវិធី​ដំបូង​របស់​ខ្ញុំ​នឹង​មិន​ខូច​ឬ? តាមពិតទៅ នេះពិតជាអ្វីដែលនឹងកើតឡើង...

ដូច្នេះ ទោះបីជាមានអត្ថប្រយោជន៍ដ៏ធំនៃការដាក់ពង្រាយសូន្យ/ខៀវបៃតងក៏ដោយ ក៏ក្រុមហ៊ុនមានទំនោរនឹងអនុវត្តតាមដំណើរការដែលមានសុវត្ថិភាពជាងមុនខាងក្រោមសម្រាប់ការដាក់ពង្រាយកម្មវិធីរបស់ពួកគេ៖

• រៀបចំកញ្ចប់ជាមួយនឹងកំណែថ្មីនៃកម្មវិធី
• បិទកម្មវិធីដែលកំពុងដំណើរការ
• ដំណើរការស្គ្រីបដើម្បីផ្ទេរមូលដ្ឋានទិន្នន័យ
• ដាក់ពង្រាយ និងបើកដំណើរការកំណែថ្មីនៃកម្មវិធី

នៅក្នុងអត្ថបទនេះ យើងនឹងរៀបរាប់លម្អិតអំពីរបៀបដែលអ្នកអាចធ្វើការជាមួយមូលដ្ឋានទិន្នន័យ និងកូដរបស់អ្នក ដើម្បីទាញយកអត្ថប្រយោជន៍ពីការដាក់ឱ្យប្រើប្រាស់គ្មានពេលទំនេរ។

បញ្ហាមូលដ្ឋានទិន្នន័យ

ប្រសិនបើអ្នកមានកម្មវិធីគ្មានរដ្ឋដែលមិនរក្សាទុកទិន្នន័យណាមួយនៅក្នុងមូលដ្ឋានទិន្នន័យ អ្នកអាចទទួលបានសូន្យការដាក់ពង្រាយពេលទំនេរភ្លាមៗ។ ជាអកុសល កម្មវិធីភាគច្រើនត្រូវការរក្សាទុកទិន្នន័យនៅកន្លែងណាមួយ។ នេះជាមូលហេតុដែលអ្នកគួរតែគិតពីរដងមុនពេលធ្វើការផ្លាស់ប្តូរណាមួយចំពោះសៀគ្វី។ មុននឹងយើងស្វែងយល់លម្អិតអំពីរបៀបផ្លាស់ប្តូរគ្រោងការណ៍ ដើម្បីកុំឱ្យការដាក់ពង្រាយពេលទំនេរអាចធ្វើទៅបាន សូមយើងផ្តោតលើគ្រោងការណ៍កំណែជាមុនសិន។

គ្រោងការណ៍កំណែ

នៅក្នុងអត្ថបទនេះយើងនឹងប្រើ ផ្លូវហោះហើរ ជាឧបករណ៍ត្រួតពិនិត្យកំណែ (ប្រហែល ការបកប្រែ៖ យើងកំពុងនិយាយអំពីការធ្វើចំណាកស្រុកមូលដ្ឋានទិន្នន័យ) ជាធម្មតា យើងក៏នឹងសរសេរកម្មវិធី Spring Boot ដែលមានការគាំទ្រ Flyway ភ្ជាប់មកជាមួយ ហើយនឹងអនុវត្តការធ្វើចំណាកស្រុកតាមគ្រោងការណ៍ ខណៈពេលដែលរៀបចំបរិបទកម្មវិធី។ នៅពេលប្រើ Flyway អ្នកអាចរក្សាទុកស្គ្រីបការផ្ទេរទិន្នន័យនៅក្នុងថតគម្រោងរបស់អ្នក (តាមលំនាំដើមនៅក្នុង classpath:db/migration) នៅទីនេះអ្នកអាចមើលឃើញឧទាហរណ៍នៃឯកសារការធ្វើចំណាកស្រុកបែបនេះ

└── db
 └── migration
     ├── V1__init.sql
     ├── V2__Add_surname.sql
     ├── V3__Final_migration.sql
     └── V4__Remove_lastname.sql

ក្នុង​ឧទាហរណ៍​នេះ យើង​ឃើញ​ស្គ្រីប​ការ​ផ្លាស់​ទី​ចំនួន 4 ដែល​ប្រសិន​បើ​មិន​ត្រូវ​បាន​ប្រតិបត្តិ​ពី​មុន​នឹង​ត្រូវ​បាន​ប្រតិបត្តិ​មួយ​បន្ទាប់​ពី​ផ្សេង​ទៀត​នៅ​ពេល​ដែល​កម្មវិធី​ចាប់​ផ្តើ​ម​។ តោះមើលឯកសារមួយ (V1__init.sql) ជាឧទាហរណ៍។

CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);

insert into PERSON (first_name, last_name) values ('Dave', 'Syer');

អ្វីគ្រប់យ៉ាងគឺជាការពន្យល់ដោយខ្លួនឯងយ៉ាងល្អឥតខ្ចោះ៖ អ្នកអាចប្រើ SQL ដើម្បីកំណត់ពីរបៀបដែលមូលដ្ឋានទិន្នន័យរបស់អ្នកគួរតែត្រូវបានកែប្រែ។ សម្រាប់ព័ត៌មានបន្ថែមអំពី Spring Boot និង Flyway សូមពិនិត្យមើល ឯកសារ Spring Boot.

ដោយប្រើឧបករណ៍គ្រប់គ្រងប្រភពជាមួយ Spring Boot អ្នកទទួលបានអត្ថប្រយោជន៍ធំ 2៖

• អ្នកបំបែកការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យពីការផ្លាស់ប្តូរកូដ
• ការធ្វើចំណាកស្រុកមូលដ្ឋានទិន្នន័យកើតឡើងរួមជាមួយនឹងការដាក់ឱ្យដំណើរការកម្មវិធីរបស់អ្នក ពោលគឺឧ។ ដំណើរការដាក់ពង្រាយរបស់អ្នកត្រូវបានធ្វើឱ្យសាមញ្ញ

ការដោះស្រាយបញ្ហាមូលដ្ឋានទិន្នន័យ

នៅក្នុងផ្នែកបន្ទាប់នៃអត្ថបទ យើងនឹងផ្តោតលើការមើលវិធីសាស្រ្តពីរចំពោះការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យ។

• ភាពមិនឆបគ្នាខាងក្រោយ
• ភាពឆបគ្នាខាងក្រោយ

ទីមួយនឹងត្រូវបានចាត់ទុកថាជាការព្រមានមួយដែលអ្នកមិនគួរអនុវត្តការដាក់ពង្រាយគ្មានពេលវេលារងចាំដោយគ្មានការរៀបចំជាមុន... ទីពីរផ្តល់នូវដំណោះស្រាយអំពីរបៀបដែលអ្នកអាចអនុវត្តការដាក់ពង្រាយដោយគ្មានពេលវេលារងចាំ ហើយក្នុងពេលតែមួយរក្សាភាពឆបគ្នាថយក្រោយ។

គម្រោងរបស់យើងដែលយើងនឹងធ្វើការនឹងក្លាយជាកម្មវិធី Spring Boot Flyway ដ៏សាមញ្ញមួយដែលមាន Person с first_name и last_name នៅក្នុងមូលដ្ឋានទិន្នន័យ (ប្រហែល ការបកប្រែ៖ Person គឺជាតារាង និង first_name и last_name - ទាំងនេះគឺជាវាលនៅក្នុងវា។) យើងចង់ប្តូរឈ្មោះ last_name в surname.

ការសន្មត់

មុនពេលយើងចូលទៅក្នុងព័ត៌មានលម្អិត មានការសន្មត់មួយចំនួនដែលយើងត្រូវធ្វើអំពីកម្មវិធីរបស់យើង។ លទ្ធផលសំខាន់ដែលយើងចង់សម្រេចបាននឹងជាដំណើរការដ៏សាមញ្ញមួយ។

កំណត់សំគាល់។ អាជីវកម្ម PRO-TIP ។ ដំណើរការសាមញ្ញអាចជួយអ្នកសន្សំប្រាក់បានច្រើនលើការគាំទ្រ (មនុស្សកាន់តែច្រើនដែលអ្នកបានធ្វើការឱ្យក្រុមហ៊ុនរបស់អ្នក ប្រាក់កាន់តែច្រើនអ្នកអាចសន្សំបាន)!

មិនចាំបាច់ត្រឡប់មូលដ្ឋានទិន្នន័យទេ។

វាជួយសម្រួលដល់ដំណើរការដាក់ពង្រាយ (ការវិលត្រឡប់មកវិញនៃមូលដ្ឋានទិន្នន័យមួយចំនួនគឺស្ទើរតែមិនអាចទៅរួចទេ ដូចជាការលុបឡើងវិញ)។ យើងចង់ត្រឡប់តែកម្មវិធីប៉ុណ្ណោះ។ វិធីនេះ ទោះបីជាអ្នកមានមូលដ្ឋានទិន្នន័យផ្សេងគ្នា (ឧទាហរណ៍ SQL និង NoSQL) បំពង់ដាក់ពង្រាយរបស់អ្នកនឹងមើលទៅដូចគ្នា។

វាត្រូវតែអាចធ្វើទៅបានដើម្បីរមៀលកម្មវិធីត្រឡប់មកវិញកំណែមួយត្រឡប់មកវិញ (មិនមានទៀតទេ)

Rollback គួរ​តែ​ត្រូវ​បាន​ធ្វើ​នៅ​ពេល​ចាំបាច់។ ប្រសិនបើមានកំហុសនៅក្នុងកំណែបច្ចុប្បន្នដែលមិនត្រូវបានជួសជុលយ៉ាងងាយស្រួលនោះ យើងគួរតែអាចត្រឡប់ទៅកំណែដែលដំណើរការចុងក្រោយបំផុត។ យើងសន្មត់ថាកំណែចុងក្រោយបំផុតនេះគឺជាកំណែមុន។ ការរក្សាភាពត្រូវគ្នានៃកូដ និងមូលដ្ឋានទិន្នន័យសម្រាប់ការចេញផ្សាយច្រើនជាងមួយនឹងពិបាក និងថ្លៃណាស់។

កំណត់សំគាល់. ដើម្បីឱ្យកាន់តែងាយស្រួលអាន នៅក្នុងអត្ថបទនេះ យើងនឹងផ្លាស់ប្តូរកំណែសំខាន់ៗនៃកម្មវិធី។

ជំហានទី 1: ស្ថានភាពដំបូង

កំណែកម្មវិធី៖ 1.0.0
កំណែ DB៖ v1

ការអត្ថាធិប្បាយ

នេះនឹងជាស្ថានភាពដំបូងនៃកម្មវិធី។

ការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យ

DB មាន last_name.

CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);

insert into PERSON (first_name, last_name) values ('Dave', 'Syer');

ការផ្លាស់ប្តូរលេខកូដ

កម្មវិធីរក្សាទុកទិន្នន័យបុគ្គលនៅក្នុង last_name:

/*
 * Copyright 2012-2016 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package sample.flyway;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Person {
    @Id
    @GeneratedValue
    private Long id;
    private String firstName;
    private String lastName;

    public String getFirstName() {
        return this.firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    public String getLastName() {
        return this.lastName;
    }

    public void setLastName(String lastname) {
        this.lastName = lastname;
    }

    @Override
    public String toString() {
        return "Person [firstName=" + this.firstName + ", lastName=" + this.lastName
                + "]";
    }
}

ការប្តូរឈ្មោះជួរឈរមិនឆបគ្នាថយក្រោយ

សូមក្រឡេកមើលឧទាហរណ៍នៃរបៀបប្តូរឈ្មោះជួរឈរ៖

ការយកចិត្តទុកដាក់។ ឧទាហរណ៍ខាងក្រោមនឹងធ្វើឱ្យខូចអ្វីៗដោយចេតនា។ យើងបង្ហាញវាដើម្បីបង្ហាញពីបញ្ហានៃភាពឆបគ្នានៃមូលដ្ឋានទិន្នន័យ។

កំណែកម្មវិធី៖ 2.0.0.BAD

កំណែ DB៖ v2bad

ការអត្ថាធិប្បាយ

ការផ្លាស់ប្តូរបច្ចុប្បន្នមិនអនុញ្ញាតឱ្យយើងដំណើរការឧទាហរណ៍ពីរ (ចាស់ និងថ្មី) ក្នុងពេលតែមួយទេ។ ដូចនេះ ការដាក់ពង្រាយគ្មានពេលរងចាំនឹងពិបាកសម្រេចបាន (ប្រសិនបើការសន្មត់ត្រូវបានយកមកពិចារណា វាពិតជាមិនអាចទៅរួចទេ)។

ការធ្វើតេស្ត A/B

ស្ថានភាពបច្ចុប្បន្នគឺថាយើងមានកំណែកម្មវិធី 1.0.0, ដាក់ពង្រាយនៅក្នុងផលិតកម្ម និងមូលដ្ឋានទិន្នន័យ v1. យើងត្រូវប្រើឧទាហរណ៍ទីពីរនៃកម្មវិធី កំណែ 2.0.0.BADនិងធ្វើបច្ចុប្បន្នភាពមូលដ្ឋានទិន្នន័យទៅ v2bad.

ជំហាន៖

1. កម្មវិធីកំណែថ្មីត្រូវបានដាក់ពង្រាយ 2.0.0.BADដែលធ្វើបច្ចុប្បន្នភាពមូលដ្ឋានទិន្នន័យទៅ v2bad
2. នៅក្នុងមូលដ្ឋានទិន្នន័យ v2bad ជួរឈរ last_name មិនមានទៀតទេ - វាត្រូវបានប្តូរទៅ surname
3. ការធ្វើបច្ចុប្បន្នភាពមូលដ្ឋានទិន្នន័យ និងកម្មវិធីបានជោគជ័យ ហើយករណីមួយចំនួនកំពុងដំណើរការ 1.0.0, អ្នកផ្សេងទៀត - នៅក្នុង 2.0.0.BAD. អ្វីគ្រប់យ៉ាងត្រូវបានភ្ជាប់ទៅមូលដ្ឋានទិន្នន័យ v2bad
4. ករណីទាំងអស់នៃកំណែ 1.0.0 នឹងចាប់ផ្តើមបោះចោលកំហុស ព្រោះពួកគេនឹងព្យាយាមបញ្ចូលទិន្នន័យទៅក្នុងជួរឈរ last_nameដែលមិនមានទៀតទេ
5. ករណីទាំងអស់នៃកំណែ 2.0.0.BAD នឹងដំណើរការដោយគ្មានបញ្ហា

ដូចដែលអ្នកអាចមើលឃើញ ប្រសិនបើយើងធ្វើការផ្លាស់ប្តូរមិនឆបគ្នាថយក្រោយចំពោះមូលដ្ឋានទិន្នន័យ និងកម្មវិធីនោះ ការធ្វើតេស្ត A/B គឺមិនអាចទៅរួចទេ។

ការ​ត្រឡប់​កម្មវិធី​

ចូរសន្មតថាបន្ទាប់ពីព្យាយាមធ្វើ A/B ដាក់ពង្រាយ (ប្រហែល per.: អ្នកនិពន្ធប្រហែលជាមានន័យថាការធ្វើតេស្ត A/B នៅទីនេះ) យើងបានសម្រេចចិត្តថាយើងត្រូវបង្វិលកម្មវិធីទៅកំណែ 1.0.0. ឧបមាថាយើងមិនចង់ត្រឡប់មូលដ្ឋានទិន្នន័យទេ។

ជំហាន៖

1. យើងបញ្ឈប់កម្មវិធីកំណែ 2.0.0.BAD
2. មូលដ្ឋានទិន្នន័យនៅតែមាន v2bad
3. ចាប់តាំងពីកំណែ 1.0.0 មិនយល់ថាវាជាអ្វី surnameយើងនឹងឃើញកំហុស
4. នរក​បាន​បែក​ធ្លាយ យើង​មិន​អាច​ត្រឡប់​ទៅ​វិញ​បាន​ទៀត​ទេ។

ដូចដែលអ្នកអាចឃើញ ប្រសិនបើយើងធ្វើការផ្លាស់ប្តូរមិនឆបគ្នាថយក្រោយចំពោះមូលដ្ឋានទិន្នន័យ និងកម្មវិធីនោះ យើងមិនអាចវិលត្រលប់ទៅកំណែមុនបានទេ។

កំណត់ហេតុការប្រតិបត្តិស្គ្រីប

Backward incompatible scenario:

01) Run 1.0.0
02) Wait for the app (1.0.0) to boot
03) Generate a person by calling POST localhost:9991/person to version 1.0.0
04) Run 2.0.0.BAD
05) Wait for the app (2.0.0.BAD) to boot
06) Generate a person by calling POST localhost:9991/person to version 1.0.0 <-- this should fail
07) Generate a person by calling POST localhost:9992/person to version 2.0.0.BAD <-- this should pass

Starting app in version 1.0.0
Generate a person in version 1.0.0
Sending a post to 127.0.0.1:9991/person. This is the response:

{"firstName":"b73f639f-e176-4463-bf26-1135aace2f57","lastName":"b73f639f-e176-4463-bf26-1135aace2f57"}

Starting app in version 2.0.0.BAD
Generate a person in version 1.0.0
Sending a post to 127.0.0.1:9991/person. This is the response:

curl: (22) The requested URL returned error: 500 Internal Server Error

Generate a person in version 2.0.0.BAD
Sending a post to 127.0.0.1:9995/person. This is the response:

{"firstName":"e156be2e-06b6-4730-9c43-6e14cfcda125","surname":"e156be2e-06b6-4730-9c43-6e14cfcda125"}

ការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យ

ស្គ្រីបផ្ទេរឈ្មោះដែលប្តូរឈ្មោះ last_name в surname

ប្រភពស្គ្រីប Flyway៖

CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);

insert into PERSON (first_name, last_name) values ('Dave', 'Syer');

ស្គ្រីបដែលប្តូរឈ្មោះ last_name.

-- This change is backward incompatible - you can't do A/B testing
ALTER TABLE PERSON CHANGE last_name surname VARCHAR;

ការផ្លាស់ប្តូរលេខកូដ

យើងបានផ្លាស់ប្តូរឈ្មោះវាល lastName នៅលើ surname.

ការប្តូរឈ្មោះជួរឈរតាមរបៀបដែលត្រូវគ្នានឹងថយក្រោយ

នេះគឺជាស្ថានភាពទូទៅបំផុតដែលយើងអាចជួបប្រទះ។ យើងត្រូវធ្វើការផ្លាស់ប្តូរដែលមិនឆបគ្នាថយក្រោយ។ យើង​បាន​បង្ហាញ​រួច​ហើយ​ថា​សម្រាប់​ការ​ដាក់​ពង្រាយ​ពេល​វេលា​សូន្យ យើង​មិន​គួរ​អនុវត្ត​ការ​ផ្លាស់​ប្តូរ​មូលដ្ឋាន​ទិន្នន័យ​ដោយ​គ្មាន​ជំហាន​បន្ថែម​នោះ​ទេ។ នៅក្នុងផ្នែកនៃអត្ថបទនេះ យើងនឹងអនុវត្តការដាក់ពង្រាយកម្មវិធីចំនួន 3 រួមជាមួយនឹងការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យ ដើម្បីសម្រេចបាននូវលទ្ធផលដែលចង់បាន ខណៈពេលដែលរក្សាបាននូវភាពឆបគ្នាថយក្រោយ។

កំណត់សំគាល់។ សូមចាំថាយើងមានមូលដ្ឋានទិន្នន័យកំណែ v1. វាមានជួរឈរ first_name и last_name. យើងត្រូវតែផ្លាស់ប្តូរ last_name នៅលើ surname. យើងក៏មានកំណែកម្មវិធីផងដែរ។ 1.0.0, ដែលមិនទាន់ប្រើ surname.

ជំហានទី 2: បន្ថែមនាមត្រកូល

កំណែកម្មវិធី៖ 2.0.0
កំណែ DB៖ v2

ការអត្ថាធិប្បាយ

តាមរយៈការបន្ថែមជួរឈរថ្មី និងចម្លងមាតិការបស់វា យើងបង្កើតការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យដែលត្រូវគ្នានឹងថយក្រោយ។ ក្នុងពេលជាមួយគ្នានេះ ប្រសិនបើយើងបង្វិល JAR ឬមាន JAR ចាស់ដែលកំពុងដំណើរការ វានឹងមិនខូចកំឡុងពេលប្រតិបត្តិនោះទេ។

យើងកំពុងដាក់ចេញកំណែថ្មី។

ជំហាន៖

1. ធ្វើការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យ ដើម្បីបង្កើតជួរឈរថ្មី។ surname. ឥឡូវនេះកំណែ DB របស់អ្នក។ v2
2. ចម្លងទិន្នន័យពី last_name в surname. យកចិត្តទុកដាក់ថា​បើ​អ្នក​មាន​ទិន្នន័យ​នេះ​ច្រើន អ្នក​គួរ​តែ​ពិចារណា​ការ​ធ្វើ​ចំណាក​ស្រុក​ជា​ក្រុម!
3. សរសេរកូដកន្លែងដែលគេប្រើ ទាំងពីរ и новыйនិង ចាស់ ជួរឈរ។ ឥឡូវនេះកំណែកម្មវិធីរបស់អ្នក។ 2.0.0
4. អានតម្លៃពីជួរឈរ surnameប្រសិនបើវាមិនមែនទេ។ nullឬពី last_nameប្រសិនបើមួយ surname មិនបានបញ្ជាក់។ អ្នកអាចលុបបាន។ getLastName() ពីកូដព្រោះវានឹងចេញ null នៅពេលត្រឡប់កម្មវិធីរបស់អ្នកពី 3.0.0 រហូតដល់ទៅ 2.0.0.

ប្រសិនបើអ្នកកំពុងប្រើ Spring Boot Flyway ជំហានទាំងពីរនេះនឹងត្រូវបានអនុវត្តកំឡុងពេលចាប់ផ្តើមកំណែ 2.0.0 កម្មវិធី។ ប្រសិនបើអ្នកដំណើរការឧបករណ៍កំណែមូលដ្ឋានទិន្នន័យដោយដៃ អ្នកនឹងត្រូវធ្វើរឿងពីរផ្សេងគ្នាដើម្បីធ្វើវា (ដំបូងធ្វើបច្ចុប្បន្នភាពកំណែ db ដោយដៃ ហើយបន្ទាប់មកដាក់ឱ្យប្រើប្រាស់កម្មវិធីថ្មី)។

វាសំខាន់ណាស់។ ចងចាំថាជួរឈរដែលបានបង្កើតថ្មី។ មិន​គួរ ដើម្បីឱ្យមាន។ មិនមែនទេ. ប្រសិនបើអ្នកធ្វើ rollback កម្មវិធីចាស់មិនដឹងអំពីជួរឈរថ្មី ហើយនឹងមិនដំឡើងវាអំឡុងពេល Insert. ប៉ុន្តែប្រសិនបើអ្នកបន្ថែមឧបសគ្គនេះហើយ db របស់អ្នកនឹងមាន v2វានឹងតម្រូវឱ្យកំណត់តម្លៃនៃជួរឈរថ្មី។ ដែលនឹងនាំឱ្យមានការរំលោភលើការរឹតបន្តឹង។

វាសំខាន់ណាស់។ អ្នកត្រូវដកវិធីសាស្ត្រចេញ getLastName()ពីព្រោះនៅក្នុងកំណែ 3.0.0 មិនមានគំនិតនៃជួរឈរនៅក្នុងកូដទេ។ last_name. នេះមានន័យថា null នឹងត្រូវបានកំណត់នៅទីនោះ។ អ្នកអាចទុកវិធីសាស្ត្រ ហើយបន្ថែមការត្រួតពិនិត្យ nullប៉ុន្តែដំណោះស្រាយល្អជាងនេះ គឺត្រូវធ្វើឱ្យប្រាកដថានៅក្នុងតក្កវិជ្ជា getSurname() អ្នកបានជ្រើសរើសតម្លៃមិនសូន្យត្រឹមត្រូវ។

ការធ្វើតេស្ត A/B

ស្ថានភាពបច្ចុប្បន្នគឺថាយើងមានកំណែកម្មវិធី 1.0.0បានដាក់ពង្រាយលើការផលិត និងមូលដ្ឋានទិន្នន័យនៅក្នុង v1. យើងត្រូវដាក់ពង្រាយឧទាហរណ៍ទីពីរនៃកម្មវិធីកំណែ 2.0.0ដែលនឹងធ្វើបច្ចុប្បន្នភាពមូលដ្ឋានទិន្នន័យទៅ v2.

ជំហាន៖

1. កម្មវិធីកំណែថ្មីត្រូវបានដាក់ពង្រាយ 2.0.0ដែលធ្វើបច្ចុប្បន្នភាពមូលដ្ឋានទិន្នន័យទៅ v2
2. ក្នុងពេលនេះសំណើមួយចំនួនត្រូវបានដំណើរការដោយកំណែកំណែ 1.0.0
3. ការអាប់ដេតបានជោគជ័យ ហើយអ្នកមានកម្មវិធីកំណែជាច្រើនដែលកំពុងដំណើរការ 1.0.0 និងកំណែផ្សេងទៀត។ 2.0.0. មនុស្សគ្រប់គ្នាទាក់ទងជាមួយមូលដ្ឋានទិន្នន័យនៅក្នុង v2
4. កំណែ 1.0.0 មិនប្រើជួរឈរនាមត្រកូលនៅក្នុងមូលដ្ឋានទិន្នន័យទេ ប៉ុន្តែកំណែ 2.0.0 ប្រើប្រាស់។ ពួកគេមិនជ្រៀតជ្រែកគ្នាទៅវិញទៅមកហើយមិនគួរមានកំហុសទេ។
5. កំណែ 2.0.0 រក្សាទុកទិន្នន័យទាំងក្នុងជួរឈរចាស់ និងថ្មី ធានាភាពឆបគ្នាថយក្រោយ

វាសំខាន់ណាស់។ ប្រសិនបើអ្នកមានសំណួរណាមួយដែលរាប់ធាតុដោយផ្អែកលើតម្លៃពីជួរឈរចាស់/ថ្មី អ្នកគួរតែចងចាំថាឥឡូវនេះអ្នកមានតម្លៃស្ទួន (ភាគច្រើនទំនងជាពួកគេនៅតែផ្លាស់ប្តូរ)។ ឧទាហរណ៍ ប្រសិនបើអ្នកចង់រាប់ចំនួនអ្នកប្រើប្រាស់ដែលមាននាមត្រកូល (អ្វីក៏ដោយដែលហៅថាជួរឈរ) បានចាប់ផ្តើមដោយអក្សរ Aបន្ទាប់មករហូតដល់ការផ្ទេរទិន្នន័យត្រូវបានបញ្ចប់ (old → new column) អ្នកអាចមានទិន្នន័យមិនស៊ីសង្វាក់គ្នា ប្រសិនបើអ្នកសួរជួរឈរថ្មី។

ការ​ត្រឡប់​កម្មវិធី​

ឥឡូវនេះយើងមានកំណែកម្មវិធី 2.0.0 និងមូលដ្ឋានទិន្នន័យនៅក្នុង v2.

ជំហាន៖

1. ត្រឡប់កម្មវិធីរបស់អ្នកទៅជាកំណែ 1.0.0.
2. កំណែ 1.0.0 មិនប្រើជួរឈរក្នុងមូលដ្ឋានទិន្នន័យទេ។ surnameដូច្នេះ rollback គួរតែទទួលបានជោគជ័យ

ការផ្លាស់ប្តូរ DB

មូលដ្ឋានទិន្នន័យមានជួរឈរដែលមានឈ្មោះ last_name.

ប្រភពស្គ្រីប Flyway៖

CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);

insert into PERSON (first_name, last_name) values ('Dave', 'Syer');

បន្ថែមស្គ្រីប surname.

ការយកចិត្តទុកដាក់។ សូមចងចាំថាអ្នកមិនអាចបន្ថែមឧបសគ្គដែលមិនមែនជា NULL ទៅក្នុងជួរឈរដែលអ្នកកំពុងបន្ថែមបានទេ។ ប្រសិនបើអ្នកត្រឡប់ JAR វិញ កំណែចាស់នឹងមិនមានគំនិតអំពីជួរឈរដែលបានបន្ថែមទេ ហើយនឹងកំណត់វាដោយស្វ័យប្រវត្តិទៅជា NULL ។ ប្រសិនបើមានការកំណត់បែបនេះ កម្មវិធីចាស់នឹងខូច។

-- NOTE: This field can't have the NOT NULL constraint cause if you rollback, the old version won't know about this field
-- and will always set it to NULL
ALTER TABLE PERSON ADD surname varchar(255);

-- WE'RE ASSUMING THAT IT'S A FAST MIGRATION - OTHERWISE WE WOULD HAVE TO MIGRATE IN BATCHES
UPDATE PERSON SET PERSON.surname = PERSON.last_name

ការផ្លាស់ប្តូរលេខកូដ

យើងរក្សាទុកទិន្នន័យជា last_nameនិងក្នុង surname. ក្នុងពេលជាមួយគ្នានេះយើងអានពី last_nameចាប់តាំងពីជួរឈរនេះគឺពាក់ព័ន្ធបំផុត។ ក្នុងអំឡុងពេលដំណើរការដាក់ពង្រាយ សំណើមួយចំនួនអាចត្រូវបានដំណើរការដោយឧទាហរណ៍កម្មវិធីដែលមិនទាន់ត្រូវបានធ្វើបច្ចុប្បន្នភាព។

/*
 * Copyright 2012-2016 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package sample.flyway;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Person {
    @Id
    @GeneratedValue
    private Long id;
    private String firstName;
    private String lastName;
    private String surname;

    public String getFirstName() {
        return this.firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    /**
     * Reading from the new column if it's set. If not the from the old one.
     *
     * When migrating from version 1.0.0 -> 2.0.0 this can lead to a possibility that some data in
     * the surname column is not up to date (during the migration process lastName could have been updated).
     * In this case one can run yet another migration script after all applications have been deployed in the
     * new version to ensure that the surname field is updated.
     *
     * However it makes sense since when looking at the migration from 2.0.0 -> 3.0.0. In 3.0.0 we no longer
     * have a notion of lastName at all - so we don't update that column. If we rollback from 3.0.0 -> 2.0.0 if we
     * would be reading from lastName, then we would have very old data (since not a single datum was inserted
     * to lastName in version 3.0.0).
     */
    public String getSurname() {
        return this.surname != null ? this.surname : this.lastName;
    }

    /**
     * Storing both FIRST_NAME and SURNAME entries
     */
    public void setSurname(String surname) {
        this.lastName = surname;
        this.surname = surname;
    }

    @Override
    public String toString() {
        return "Person [firstName=" + this.firstName + ", lastName=" + this.lastName + ", surname=" + this.surname
                + "]";
    }
}

ជំហានទី 3: ការដកឈ្មោះចុងក្រោយចេញពីលេខកូដ

កំណែកម្មវិធី៖ 3.0.0

កំណែ DB៖v3

ការអត្ថាធិប្បាយ

ចំណាំ per.: ជាក់ស្តែង នៅក្នុងអត្ថបទដើម អ្នកនិពន្ធបានចម្លងអត្ថបទនៃប្លុកនេះដោយច្រឡំពីជំហានទី 2។ នៅជំហាននេះ ការផ្លាស់ប្តូរគួរតែត្រូវបានធ្វើឡើងនៅក្នុងកូដកម្មវិធីដែលមានគោលបំណងលុបមុខងារដែលប្រើជួរឈរចេញ។ last_name.

តាមរយៈការបន្ថែមជួរឈរថ្មី និងចម្លងមាតិការបស់វា យើងបានបង្កើតការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យដែលត្រូវគ្នានឹងថយក្រោយ។ ផងដែរ ប្រសិនបើយើងបង្វិល JAR ឬមាន JAR ចាស់ដែលកំពុងដំណើរការ វានឹងមិនខូចកំឡុងពេលប្រតិបត្តិនោះទេ។

ការ​ត្រឡប់​កម្មវិធី​

បច្ចុប្បន្នយើងមានកំណែកម្មវិធី 3.0.0 និងមូលដ្ឋានទិន្នន័យ v3. កំណែ 3.0.0 មិនរក្សាទុកទិន្នន័យទៅ last_name. នេះមានន័យថានៅក្នុង surname ព័ត៌មានចុងក្រោយបំផុតត្រូវបានរក្សាទុក។

ជំហាន៖

1. ត្រឡប់កម្មវិធីរបស់អ្នកទៅជាកំណែ 2.0.0.
2. កំណែ 2.0.0 ប្រើប្រាស់ និង last_name и surname.
3. កំណែ 2.0.0 នឹងយក surnameប្រសិនបើវាមិនមែនជាសូន្យ បើមិនដូច្នេះទេ -last_name

ការផ្លាស់ប្តូរមូលដ្ឋានទិន្នន័យ

មិនមានការផ្លាស់ប្តូររចនាសម្ព័ន្ធនៅក្នុងមូលដ្ឋានទិន្នន័យទេ។ ស្គ្រីបខាងក្រោមត្រូវបានប្រតិបត្តិ ដើម្បីធ្វើការផ្ទេរចុងក្រោយនៃទិន្នន័យចាស់៖

-- WE'RE ASSUMING THAT IT'S A FAST MIGRATION - OTHERWISE WE WOULD HAVE TO MIGRATE IN BATCHES
-- ALSO WE'RE NOT CHECKING IF WE'RE NOT OVERRIDING EXISTING ENTRIES. WE WOULD HAVE TO COMPARE
-- ENTRY VERSIONS TO ENSURE THAT IF THERE IS ALREADY AN ENTRY WITH A HIGHER VERSION NUMBER
-- WE WILL NOT OVERRIDE IT.
UPDATE PERSON SET PERSON.surname = PERSON.last_name;

-- DROPPING THE NOT NULL CONSTRAINT; OTHERWISE YOU WILL TRY TO INSERT NULL VALUE OF THE LAST_NAME
-- WITH A NOT_NULL CONSTRAINT.
ALTER TABLE PERSON MODIFY COLUMN last_name varchar(255) NULL DEFAULT NULL;

ការផ្លាស់ប្តូរលេខកូដ

ចំណាំ per.: ការពិពណ៌នានៃប្លុកនេះក៏ត្រូវបានចម្លងច្រឡំដោយអ្នកនិពន្ធពីជំហានទី 2។ ដោយអនុលោមតាមតក្កវិជ្ជានៃអត្ថបទ ការផ្លាស់ប្តូរកូដនៅជំហាននេះគួរតែមានគោលបំណងដកចេញពីធាតុដែលដំណើរការជាមួយជួរឈរ។ last_name.

យើងរក្សាទុកទិន្នន័យជា last_nameនិងក្នុង surname. លើសពីនេះទៀតយើងអានពីជួរឈរ last_nameព្រោះវាពាក់ព័ន្ធបំផុត។ ក្នុងអំឡុងពេលដំណើរការដាក់ពង្រាយ សំណើមួយចំនួនអាចត្រូវបានដំណើរការដោយឧទាហរណ៍ដែលមិនទាន់ត្រូវបានដំឡើងកំណែ។

/*
 * Copyright 2012-2016 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package sample.flyway;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Person {
    @Id
    @GeneratedValue
    private Long id;
    private String firstName;
    private String surname;

    public String getFirstName() {
        return this.firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    public String getSurname() {
        return this.surname;
    }

    public void setSurname(String lastname) {
        this.surname = lastname;
    }

    @Override
    public String toString() {
        return "Person [firstName=" + this.firstName + ", surname=" + this.surname
                + "]";
    }
}

ជំហានទី 4: ការដកឈ្មោះចុងក្រោយចេញពីមូលដ្ឋានទិន្នន័យ

កំណែកម្មវិធី៖ 4.0.0

កំណែ DB៖ v4

ការអត្ថាធិប្បាយ

ដោយសារតែការពិតដែលថាលេខកូដកំណែ 3.0.0 មិនបានប្រើជួរឈរទេ។ last_nameគ្មានអ្វីអាក្រក់នឹងកើតឡើងក្នុងអំឡុងពេលប្រតិបត្តិទេ ប្រសិនបើយើងត្រលប់ទៅ 3.0.0 បន្ទាប់ពីដកជួរឈរចេញពីមូលដ្ឋានទិន្នន័យ។

កំណត់ហេតុការប្រតិបត្តិស្គ្រីប

We will do it in the following way:

01) Run 1.0.0
02) Wait for the app (1.0.0) to boot
03) Generate a person by calling POST localhost:9991/person to version 1.0.0
04) Run 2.0.0
05) Wait for the app (2.0.0) to boot
06) Generate a person by calling POST localhost:9991/person to version 1.0.0
07) Generate a person by calling POST localhost:9992/person to version 2.0.0
08) Kill app (1.0.0)
09) Run 3.0.0
10) Wait for the app (3.0.0) to boot
11) Generate a person by calling POST localhost:9992/person to version 2.0.0
12) Generate a person by calling POST localhost:9993/person to version 3.0.0
13) Kill app (3.0.0)
14) Run 4.0.0
15) Wait for the app (4.0.0) to boot
16) Generate a person by calling POST localhost:9993/person to version 3.0.0
17) Generate a person by calling POST localhost:9994/person to version 4.0.0

Starting app in version 1.0.0
Generate a person in version 1.0.0
Sending a post to 127.0.0.1:9991/person. This is the response:

{"firstName":"52b6e125-4a5c-429b-a47a-ef18bbc639d2","lastName":"52b6e125-4a5c-429b-a47a-ef18bbc639d2"}

Starting app in version 2.0.0

Generate a person in version 1.0.0
Sending a post to 127.0.0.1:9991/person. This is the response:

{"firstName":"e41ee756-4fa7-4737-b832-e28827a00deb","lastName":"e41ee756-4fa7-4737-b832-e28827a00deb"}

Generate a person in version 2.0.0
Sending a post to 127.0.0.1:9992/person. This is the response:

{"firstName":"0c1240f5-649a-4bc5-8aa9-cff855f3927f","lastName":"0c1240f5-649a-4bc5-8aa9-cff855f3927f","surname":"0c1240f5-649a-4bc5-8aa9-cff855f3927f"}

Killing app 1.0.0

Starting app in version 3.0.0

Generate a person in version 2.0.0
Sending a post to 127.0.0.1:9992/person. This is the response:
{"firstName":"74d84a9e-5f44-43b8-907c-148c6d26a71b","lastName":"74d84a9e-5f44-43b8-907c-148c6d26a71b","surname":"74d84a9e-5f44-43b8-907c-148c6d26a71b"}

Generate a person in version 3.0.0
Sending a post to 127.0.0.1:9993/person. This is the response:
{"firstName":"c6564dbe-9ab5-40ae-9077-8ae6668d5862","surname":"c6564dbe-9ab5-40ae-9077-8ae6668d5862"}

Killing app 2.0.0

Starting app in version 4.0.0

Generate a person in version 3.0.0
Sending a post to 127.0.0.1:9993/person. This is the response:

{"firstName":"cbe942fc-832e-45e9-a838-0fae25c10a51","surname":"cbe942fc-832e-45e9-a838-0fae25c10a51"}

Generate a person in version 4.0.0
Sending a post to 127.0.0.1:9994/person. This is the response:

{"firstName":"ff6857ce-9c41-413a-863e-358e2719bf88","surname":"ff6857ce-9c41-413a-863e-358e2719bf88"}

ការផ្លាស់ប្តូរ DB

ទាក់ទង v3 យើងគ្រាន់តែដកជួរឈរចេញ last_name និងបន្ថែមការរឹតបន្តឹងដែលបាត់។

-- REMOVE THE COLUMN
ALTER TABLE PERSON DROP last_name;

-- ADD CONSTRAINTS
UPDATE PERSON SET surname='' WHERE surname IS NULL;
ALTER TABLE PERSON ALTER COLUMN surname VARCHAR NOT NULL;

ការផ្លាស់ប្តូរលេខកូដ

មិនមានការផ្លាស់ប្តូរកូដទេ។

សេចក្តីសន្និដ្ឋាន

យើងបានអនុវត្តការផ្លាស់ប្ដូរឈ្មោះជួរឈរដែលមិនឆបគ្នាថយក្រោយដោយជោគជ័យ ដោយអនុវត្តការដាក់ពង្រាយដែលឆបគ្នាថយក្រោយជាច្រើន។ ខាងក្រោមនេះជាសេចក្តីសង្ខេបនៃសកម្មភាពដែលបានអនុវត្ត៖

1. ការដាក់ឱ្យប្រើប្រាស់កំណែកម្មវិធី 1.0.0 с v1 គ្រោងការណ៍មូលដ្ឋានទិន្នន័យ (ឈ្មោះជួរឈរ = last_name)
2. ការដាក់ឱ្យប្រើប្រាស់កំណែកម្មវិធី 2.0.0, ដែលរក្សាទុកទិន្នន័យនៅក្នុង last_name и surname. កម្មវិធីអានពី last_name. មូលដ្ឋានទិន្នន័យគឺនៅក្នុងកំណែ v2មានជួរឈរដូចជា last_name, និង surname. surname គឺជាច្បាប់ចម្លងនៃ last_name. (ចំណាំ៖ ជួរ​ឈរ​នេះ​មិន​ត្រូវ​មាន​កម្រិត​មិន​ទុក​ជា​មោឃៈ​ទេ)
3. ការដាក់ឱ្យប្រើប្រាស់កំណែកម្មវិធី 3.0.0ដែលរក្សាទុកតែទិន្នន័យនៅក្នុង surname និងអានពីនាមត្រកូល។ សម្រាប់មូលដ្ឋានទិន្នន័យ ការធ្វើចំណាកស្រុកចុងក្រោយកំពុងកើតឡើង last_name в surname. ដែនកំណត់ផងដែរ។ មិនមែនទេ ដកចេញពី last_name. ឥឡូវនេះ មូលដ្ឋានទិន្នន័យស្ថិតនៅក្នុងកំណែ v3
4. ការដាក់ឱ្យប្រើប្រាស់កំណែកម្មវិធី 4.0.0 - មិនមានការផ្លាស់ប្តូរណាមួយចំពោះលេខកូដទេ។ ការដាក់ពង្រាយមូលដ្ឋានទិន្នន័យ v4ដែលដកចេញ last_name. នៅទីនេះអ្នកអាចបន្ថែមឧបសគ្គដែលបាត់ទៅមូលដ្ឋានទិន្នន័យ។

ដោយធ្វើតាមវិធីសាស្រ្តនេះ អ្នកតែងតែអាចត្រឡប់កំណែមួយវិញដោយមិនបំបែកភាពឆបគ្នានៃមូលដ្ឋានទិន្នន័យ/កម្មវិធី។

លេខកូដ

កូដទាំងអស់ដែលប្រើក្នុងអត្ថបទនេះមាននៅ Github. ខាងក្រោមនេះគឺជាការពិពណ៌នាបន្ថែម។

គម្រោង

បន្ទាប់ពីក្លូនឃ្លាំង អ្នកនឹងឃើញរចនាសម្ព័ន្ធថតខាងក្រោម។

├── boot-flyway-v1              - 1.0.0 version of the app with v1 of the schema
├── boot-flyway-v2              - 2.0.0 version of the app with v2 of the schema (backward-compatible - app can be rolled back)
├── boot-flyway-v2-bad          - 2.0.0.BAD version of the app with v2bad of the schema (backward-incompatible - app cannot be rolled back)
├── boot-flyway-v3              - 3.0.0 version of the app with v3 of the schema (app can be rolled back)
└── boot-flyway-v4              - 4.0.0 version of the app with v4 of the schema (app can be rolled back)

ស្គ្រីប

អ្នកអាចដំណើរការស្គ្រីបដែលបានពិពណ៌នានៅក្នុងស្គ្រីបខាងក្រោម ដែលនឹងបង្ហាញពីការផ្លាស់ប្តូរដែលឆបគ្នាថយក្រោយ និងមិនត្រូវគ្នាទៅនឹងមូលដ្ឋានទិន្នន័យ។

ចង់​ឃើញ ករណី​ដែល​មាន​ការ​ផ្លាស់​ប្តូ​រ​ត្រូវ​គ្នា​ថយ​ក្រោយ​រត់៖

./scripts/scenario_backward_compatible.sh

និងដើម្បីមើល ករណី​ដែល​មាន​ការ​ផ្លាស់​ប្តូ​រ​មិន​ត្រូវ​គ្នា​ថយ​ក្រោយ​រត់៖

./scripts/scenario_backward_incompatible.sh

Spring Boot Sample Flyway

ឧទាហរណ៍ទាំងអស់ត្រូវបានយកចេញពី Spring Boot Sample Flyway.

អ្នកអាចមើល http://localhost:8080/flywayមានបញ្ជីស្គ្រីប។

ឧទាហរណ៍នេះក៏រួមបញ្ចូលកុងសូល H2 (នៅ http://localhost:8080/h2-console) ដូច្នេះអ្នកអាចមើលស្ថានភាពមូលដ្ឋានទិន្នន័យ (លំនាំដើម jdbc URL គឺ jdbc:h2:mem:testdb).

លើសពីនេះទៀត

• លំនាំការកែលម្អមូលដ្ឋានទិន្នន័យ
• ការដឹកជញ្ជូនបន្ត

សូមអានអត្ថបទផ្សេងទៀតនៅលើប្លក់របស់យើងផងដែរ៖

• Kubernetes៖ ហេតុអ្វីបានជាវាមានសារៈសំខាន់ខ្លាំងណាស់ក្នុងការកំណត់រចនាសម្ព័ន្ធការគ្រប់គ្រងធនធានប្រព័ន្ធ?
• បំពង់ Tekton - បំពង់បង្ហូរប្រេងដើម Kubernetes
• ការកសាងម៉ូឌុលថាមវន្តសម្រាប់ Nginx
• ការណែនាំអំពីការអនុញ្ញាត Kubernetes របស់កុងស៊ុល Hashicorp
• តើការធ្វើចំណាកស្រុកពី ClickHouse ដោយគ្មានការអនុញ្ញាតទៅ ClickHouse ជាមួយនឹងការអនុញ្ញាតនាំទៅរកអ្វី?
• ការដាក់ពង្រាយពណ៌ខៀវបៃតងនៃកម្មវិធីនិទាឃរដូវជាមួយម៉ាស៊ីនមេបណ្តាញ Nginx

ប្រភព: www.habr.com