ปกติแล้ว DBA หรือ Dev มักจะมีปัญหาในการจัดการสคริปต์ ในแต่ละโปรเจกต์มากๆ ในการ Deploy แต่ละครั้ง หรือเวลามีฟีเจอร์ใหม่ที่ add on ไปในระบบเดิม หรือการ Setup Database Environment เพื่อจัดเตรียมโครงสร้างฐานข้อมูลในพาร์ทต่างๆ ไม่ว่าจะเป็นในส่วนของ database สำหรับ dev หรือ uat เราเองในฐานะที่เป็น DBA คงต้องหาแนวทางแก้ไขจนมาเจอตัวนี้ค่ะ เว้าแล้วก็ไป๊

Step 1: Preparing for installation

ก่อนจะติดตั้ง Liquibase ให้ตรวจสอบในเครื่องที่ใช้งานว่าได้ติดตั้ง Java jdk แล้วหรือยังค่ะ ถ้ายังไม่มีให้ดาวน์โหลด JAVA จากนั้นทำการติดตั้งและ Set Path JAVA_HOME ก่อนจ้า

จากนั้นดาวน์โหลด Liquibase download เลือก ดาวน์โหลดตาม OS ที่ใช้งาน ในตัวอย่างนี้จะใช้งานบน Windows ค่ะ ทำการ Extract File และติดตั้ง เมื่อเสร็จเรียบร้อยแล้ว ตรวจสอบเวอร์ชั่นกันนิดนึงด้วยคำสั่ง liquibase — - version

liquibase — -version

ในการทำงานของ Liquibase จะต้องมี JDBC Driver File ซึ่งในไฟล์ Liquibase setup โดยปรกติแล้ว Liquibase จะแพครวม JDBC Driver มาให้เราอยู่แล้วค่ะ ในตัวอย่างที่ติดตั้งจะเป็น Liquibase เวอร์ชั่น 4.24.0 เราสามารถตรวจสอบ Driver ที่มีอยู่ได้จาก Path: liquibase/internal/lib หรือลองใช้คำสั่ง dir run ผ่าน command prompt หากตรวจสอบแล้วไม่พบ Driver ของ Database ที่ใช้ ก็ตามไปดาวน์โหลดที่ JDBC Driver กันได้เลย ในตัวอย่างนี้ จะใช้ Liquibase ทำงานร่วมกับ PostgreSql ค่ะ

เมื่อทุกอย่างเตรียมพร้อม เรามาเริ่มต้นโปรเจ็คด้วยการสร้าง Folder ที่เราต้องการจัดเก็บสคริปต์ ชื่อว่า liquibasePractice และใช้ VSCode เจ้าประจำค่ะ ให้ New Terminal ขึ้นมาและเริ่มต้นโปรเจกต์ด้วยคำสั่ง liquibase init project

liquibase init project

เจ้าตัว Liquibase จะถามว่าจะสร้างไฟล์ตาม Default หรือเปล่า ถ้ากด Y (Yes) ก็จะได้ ไฟล์ liquibase.properties และตัวอย่างไฟล์อื่นๆ มาให้เราแบบอัตโนมัติ หรือเราจะเลือก customize ไฟล์ขึ้นมาเองก็ได้ค่ะ

เมื่อคลิกดูไฟล์ liquibase.properties ก็จะเห็นว่ามีการสร้าง liquibase.command ในส่วนของ Connection setting เป็นค่า Default ไว้ให้เราลองรันทดสอบค่ะ

Concepts คร่าวๆในการติดตั้ง Liquibase ก็จะประมาณนี้ค่ะ ไปต่อกันเลยดีกว่าเนอะ

Step 2: Configuring Database Connection

ในการตั้งค่าการเชื่อมต่อไปยัง Database จะขอ customize ไฟล์ขึ้นมาใหม่ และเราจะมาตั้งค่ากันในไฟล์ liquibase.properties กันค่ะ

#Database current connection

• liquibase.hub.mode ตั้งค่าเป็น off เพราะเราไม่ต้องการแชร์ขึ้นไปยัง hub ของ liquibase
• url เชื่อมต่อ Database ตาม Syntax ของ Liquibase ค่ะ ตัวอย่างนี้เป็นการเชื่อมต่อ PostgreSql สำหรับท่านใดที่ใช้ Database ค่ายอื่นสามารถตรวจสอบเวอร์ชั่นที่รองรับ และ url format ได้ที่ Link นี้นะคะ
• username และ password ที่ใช้ login database ของเราค่ะ
• changelogFile สามารถสร้าง changelog file ได้หลายนามสกุล ทั้ง .sql หรือ .xml แต่จะขอสร้างเป็นไฟล์ชื่อ dbroot.xml เพื่อตั้งค่าให้สอดคล้องกับการูปแบบการจัดการไฟล์ในการจัดเก็บสคริปต์ และได้ตั้งค่าเป็น includeAll Part เพื่อที่จะให้ liquibase รันอัพเดทสคริปต์ทุก changelog ที่อยู่ภายใต้โฟลเดอร์นั้นๆ ค่ะ (ในการตั้งค่าเพื่อนๆ สามารถอ่านเพิ่มเติมได้ ใน Document ของ liquibase นะ)

# Reference Database for compare object เป็นการตั้งค่าเมื่อต้องการเปรียบเทียบ object ในกรณีที่มี database หรือ schema ที่ต้องการตรวจสอบว่ามี object ใดขาดหายไป (ขอยกตัวอย่างใน ย่อหน้าถัดไปนะคะ)

• referenceUrl
• referenceUsername และ referencePassword

ในส่วนของไฟล์ dbroot.xml จะกำหนด เป็น includeAll path โฟลเดอร์ที่จัดเก็บ changelogs ของเราค่ะ

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:pro="http://www.liquibase.org/xml/ns/pro"
xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.4.xsd">
   <includeAll 
   path="ChangelogsPractice/changelogs_sprint1_prepareData" 
   errorIfMissingOrEmpty="false"
   />
</databaseChangeLog>

liquibase validate

เมื่อตั้งค่าการเชื่อมต่อเสร็จแล้วสามารถตรวจสอบความถูกต้องของการตั้งค่า connection หรือ syntax อื่น ๆ ด้วยคำสั่ง liquibase validate เจ้าตัว liquibase จะ สร้าง ตาราง databasechangelog และ databasechangeloglock ใน ฐานข้อมูลของเราเพื่อใช้จัดเก็บ history การอัพเดท changelog หรือ changeset ของเรานั่นเองค่ะ

Step 3: Management changelog and changeset

ทำความเข้าใจ Changelog และ Changeset

โดยทั่วไปแล้วการจัดเก็บสคริปต์จะ จัดเก็บ statements ต่างๆ ไว้ในไฟล์นามสกุล .sql เพื่อความสะดวกในการนำไปใช้งานต่อ ในตัวอย่างนี้จะจัดเก็บ statements ไว้ในไฟล์หนึ่งไฟล์ นับเป็นหนึ่ง changelog ในหนึ่ง changelog จะ control statements ที่มีการเปลี่ยนแปลงไว้ด้วย changeset และ ในหนึ่ง changeset อาจมีมากกว่าหนึ่ง statement หรือ แล้วแต่สไตล์การทำงานของแต่ละคนเนอะ อิอิ

Trig : ในที่นี้จะขอตั้งชื่อโฟลเดอร์ที่จัดเก็บ changelog ตามลำดับความสำคัญในการรันสคริปต์ DDL (Data Definition Language) โดยใช้วิธีกำหนดการตั้งชื่อไฟล์ เป็นรูปแบบเดียวการตั้งชื่อตัวเลขเวอร์ชั่น ในการกำกับ เช่น 1.3.0 createSequece ก่อน 1.4.0 createTrigger เหตุผลเนื่องจาก เมื่อเวลานำสคริปต์ในรันบนฐานข้อมูล เรามักจะต้องมีการลำดับขั้นตอนว่าจะต้องรันสคริปต์อะไรก่อนเพื่อไม่ให้ติดขัดตอนที่เรารัน (DBA จะรู้ ฮ่าๆ)

ในไฟล์ changelog จะเริ่มต้นด้วย command — — liquibase formatted sql ในทุกๆ changelog

• - - liquibase formatted sql เพื่อให้ liquibase อ่านค่า statement และรันสคริปต์ได้ตามรูปแบบที่เราจัดเก็บ
• - -changeset Author: Id ชื่อเจ้าของ changeset ตามด้วย Id ในตัวอย่างนี้ตั้งเป็น Id ของ changeset นะคะ ในส่วนของ labels และ context แล้วแต่จะกำหนดได้เลยค่ะ

- - liquibase formatted sql

- - changeset Tanida.m:1 labels:prepareData context:dev
- - comment: createTable person
create table person (
id serial not null,
name character varying(50) not null,
address1 character varying(50),
address2 character varying(50),
city character varying(30)
)
- - rollback DROP TABLE person;


- - changeset your.name:2 labels:prepareData context:dev
- - comment: createTable company
create table company (
id serial not null,
name character varying(50) not null,
address1 character varying(50),
address2 character varying(50),
city character varying(30)
)
- - rollback DROP TABLE company;

จากนั้นให้รันคำสั่ง liquibase update

liquibase update

ข้อดีของ liquibase คือจะช่วยเราคลีน statements และจะไม่ยอมให้ update statement ลงในฐานข้อมูล หาก syntax ไม่ถูกต้อง หากเรารันคำสั่ง update ผ่านโดยไม่มี error แจ้งขึ้นมา liquibase จะแสดงผลลัพธ์ จำนวน changeset ที่ถูกรันไปแล้ว และจำนวน changeset ที่มีการรันอัพเดท เท่ากับว่าเราจะมีตัวช่วยในการเช็คให้ statement ที่ถูกรันไปแล้วนั่นเอง และยังช่วยลดขั้นตอนในการทำงานอีกด้วย (ไม่ต้อง Manual แล้วจ้า)

และสามารถตรวจสอบ history การันคำสั่ง liquibase history ใน terminal หรือจะเข้าไปดูข้อมูลประวัติ ในตาราง databasechangelog ก็ได้ค่ะ

liquibase history

หรือจะใช้คำสั่ง หากต้องการรันสคริปต์เป็น บาง statement หรือบาง changelog โดยใช้คำสั่ง liquibase execute-sql แต่ข้อเสียของคำสั่งนี้คือจะไม่เก็บ History การเปลี่ยนแปลงว่ามีใครอัพเดทโครงสร้างอะไรไปบ้างค่ะ

liquibase execute-sql

liquibase execute-sql --sql-file=D:/liquibasePractic/ChangelogsPractice/changelogs_sprint1_prepareData.sql

Diff for compare two database

สำหรับ Liquibase ก็มีคำสั่ง Liquibase diff เพื่อช่วยในการตรวจสอบ object ที่ขาดหายไประหว่าง database หรือระหว่าง schema ก็ได้เช่นกันค่ะ ส่วนตัวเองก็ค่อนข้าชอบฟังก์ชั่นนี้มาก เพราะช่วยให้การทำงานง่ายลงไปเยอะเลยค่ะ อีกทั้งยังมีความรวดเร็วอีกด้วย

หากเพื่อนๆตั้งค่าการเชื่อมต่อใน Step 2 ในส่วนของ ReferanceUrl ไปยัง database ที่ต้องการเทียบ object เรียบร้อยแล้วให้ทดสอบรันคำสั่ง ใน terminal ได้เลยค่ะ จะเห็น Diff Results ให้เราอยู่ใน terminal

liquibase diff

อีกหนึ่งคำสั่งทีอาจจะต้องใช้งาน นั่นคือคำสั่ง Rollback ซึ่งรายละเอียดของการ Rollback จะมีข้อควรระวังอยู่เยอะมาก ถ้ามีเวลาจะมาอัพเดทให้ใน EP. ถัดไปนะคะ

วันนี้ขอลาไปก่อนนะคะ บ๊าย บายย ย

Trig :

• หากต้องการจะให้ liquibase รันสคริปต์เป็นบาง changelog สามารถทำได้หลายวิธี เช่นเปลี่ยนการตั้งค่า changelogFile หรือตั้งค่า include และระบุ path ที่ต้องการรัน ในไฟล์ dbroot.xml หรือจะใช้คำสั่ง liquibase command บางคำสั่งแล้วแต่สไตล์และความชอบในการจัดการสคริปต์
• changeset ที่รันคำสั่ง liquibase update ไปแล้วเราจะไม่ไปแก้ไขสคริปต์เดิม แต่จะใช้วิธีการอื่นมาจัดการสคริปต์แทน โดยการใช้คำสั่ง DDL พวก Alter, Drop หรือ Create object เป็น changelog ใหม่แทน
• หรือจะใช้คำสั่ง rollback หากยังไม่มี การ dev (Rollback ผิดชีวิตเปลี่ยน) อาจจะไปตีกับ Dev ได้
• หากต้องการรันสคริปต์สร้างโครงสร้างใน Database ที่เป็น ฐานข้อมูลสำหรับ UAT เมื่อ Dev และ DBA review script ร่วมกันแล้วก็แค่เปลี่ยน url connection ใน liquibase.propertie แล้วรัน update โลดด ^^

ข้อดีของการมี Web BLOG

อย่างที่ทราบกันว่า Medium เป็นแหล่งเขียนบล็อกที่นิยมกัน เมื่อ เสิร์ชหาข้อมูลความรู้ บางครั้งก็หลุดมาใน blog ของใครก็ไม่รู้ที่มีการแชร์ Knowledge ไว้มากมาย ยิ่ง follow ก็ยิ่งเห็นว่า blogger บางคนนี่เจ๋งหว่ะ เห้ยย อย่างที่โอโรจิมารุได้กล่าวไว้ “คนเราน่ะ หนีไม่พ้นกิเลสของ ความอยากรู้ หรอก” ยิ่งติดตามยิ่งรู้สึกว่า เย้ยย คนอื่นเขาไปไกลแล้วนะนี่ คนอื่นเขาใช้ tool ใหม่ ๆ ภาษาใหม่ ๆ ที่ทำให้ชีวิตมันดูง่ายขึ้น การเข้าดู Blog ของคนอื่นบ่อยๆ มันทำให้เรารู้สึกกระหาย อยากที่จะเรียนรู้อะไรใหม่ๆ มุมมองใหม่ มีแรงบันดาลใจ มีแรงผลักดันที่จะขวนขวายมาซึ่งความรู้ เพิ่มพูนให้กับตัวเอง อยากจะเก่ง อยากจะเป็นกูรู แล้วขียน Blog เป็นของตัวเองบ้าง 55+

โดยส่วนตัวอยากจะให้พวกเรา ชาว WULIB ออฟฟิศที่มีเทพหลายองค์สิงสถิตอยู่ ได้เขียน blog ขึ้นมา องค์ความรู้ทั้งหลายไม่ควรที่จะสูญหายไปกับกาลเวลา อย่างน้อยเราจะได้ไม่หมกมุ่นอยู่กับสิ่งเดิม คอยแก้ปัญหาเดิมๆ ทำงานเดิมๆ ตะบี้ตะบันทำงานเพื่อให้ส่งงานได้ทันก่อนหมดสัญญา ว่างๆ ก็เขียนบล็อกระบายความรู้หรือความในใจก็ได้นะ อิอิ เปลี่ยนไลฟ์สไตล์ไปส่องชีวิตคนอื่น ส่องไปส่องมาอาจจะได้ context หรือ connection จากใครที่ไม่เคยรู้จักก็ได้นะ

อ้าว เรามี WALAI AutoLib KM อยู่แล้วนี่ จะสร้างบล็อกอีกทำไม

Medium กับ เว็บบล็อก KM ที่เรามีมันไม่เหมือนกันนะ KM เหมือนคลังความรู้ที่ต้องคอยปัดฝุ่น เอาจริงๆก็ไม่ค่อยได้เข้าไปหรอก ถ้าความรู้ของเรามีคนมาอ่านเยอะ มีคนกดถูกใจ ชอบใจบทความของเรา มีคนมาตาม follow เรา มันคงรู้สึกดีเนอะ มันดู สิ่งที่เราเขียนไปมันมีคุณค่าถ้าถูกเปิดอ่าน ซึ่ง Medium ได้สร้าง ฟังก์ชั่นเหล่านี้ขึ้นมา ให้มี reaction เหมือนกับ Social Media ทั่วไปน่ะแหละ Follow บุคคล หรือ Community ที่สนใจ คือดีย์อ่ะ และถ้าเราผูกโดเมน กับ Medium ภายใต้ชื่อ WALAI AutoLib เพื่อสร้าง เมื่อเราไปแชร์บล็อกของเราไว้ที่ไหน มันก็จะมี แบรนดืดิ้ง WALAI แทนที่จะมี Medium นำหน้าที่อยู่ลิ้งของเรา https://medium.com/p/c268f4c9c427

อย่าง user TANIDA ก็จะไม่ใช่แค่ TANIDA ที่เป็นใครก็ไม่รู้ แต่เป็น TANIDA แห่ง WALAI AutoLib ฮ่าๆ ดูดี๊ดูดี อารมณ์ประมาณนี้ (ขอแคปมาทำรุปตัวอย่างหน่อยน้า)

เพิ่มเติมที่ลิ้งค์นี้นะ https://nuuneoi.com/blog/blog.php?read_id=895

ตัว Medium.com ก็แสนจะใช้งานง่ายมากๆเนอะ จะแนบรูปหรือวิดิโอ ก็ง๊ายง่าย ถ้า เรา stream vidio การใช้โปรแกรมวลัย โยนบล็อกไปในเพจ user group หรือส่งให้ลูกค้าก็ดีเนอะ ขอบคุณวิดิโอ ปลากรอบ จากพี่จูน

หรือๆ พี่ยันจะเขียนบล็อกแชร์ ทริคถ่ายรูปแล้วไปโยนในเพจพี่ยันก็น่าจะดีน้าา

หรือๆ เทรนเนอร์จะเขียน การลงรายการตาม Tag แชร์ไว้ก็ดีไม่น้อยเนอะ

หรือๆ พี่บวบที่กำลัง เล่น Docger ก็มาแชร์ไว้บ้างก็ดีนะคะ 555+

หรือๆ พี่รงค์ พี่ฝน พี่วิท และพี่ๆทุกคน มาแชร์ความรู้อันทรงคุณค่าเพื่อเป็นวิทยาทานแก่ชนรุ่นหลังสืบไป ฮ่าา

บล็อกนี้เป็นบล็อกแรกที่ด๊ะเขียนขึ้นมา ดูเหมือนจะง๊องแง๊งเนาะ แต่คิดว่าอะไรที่ได้กลับมามันคงมากและคุ้มค่ากับค่าจดโดเมน ปีละไม่บาท ไม่มีอะไรหร๊อกก แค่อยากเก่งๆ แล้วเป็น Writer เองบ้าง ฮิฮิฮิ เราไม่ควรแต่เอาแต่อ่าน blog ของคนอื่น ทั้งๆที่เราก็มีของให้ปล่อยเน้อออ ว่ามั้ยคะ ^^

ชอบก็กดปรบมือด้านล่าง หรือ follow มา เดี๋ยว follow กลับ ไม่โกงค้าา