MySQL on Bill.Lin's Notes

HikariCP 連線池調校

Mon, 15 Jan 2024 00:00:00 +0800

為什麼需要連線池

每次建立一條 MySQL 連線涉及：

TCP 三向交握
MySQL 認證協議（握手、登入封包）
SSL 協商（若啟用）

單次耗時 ~5–30ms，在高並發場景下，每個請求都新建連線會讓延遲成為瓶頸。連線池預先建立固定數量的連線並重複使用，消除這段開銷。

另一個角度：MySQL Server 端的連線數有上限（max_connections，預設 151）。連線池讓多個應用執行緒共享少量資料庫連線。

HikariCP 核心參數

spring:
  datasource:
    hikari:
      maximum-pool-size: 10       # 連線池最大連線數
      minimum-idle: 5             # 最少保持的閒置連線數
      connection-timeout: 30000   # 向池請求連線的最長等待時間（ms），超過拋出例外
      idle-timeout: 600000        # 閒置連線在池中存活的最長時間（ms），10 分鐘
      max-lifetime: 1800000       # 連線在池中存活的最長時間（ms），30 分鐘
      leak-detection-threshold: 60000  # 連線被借出後超過此時間未歸還，印出警告（ms）
      pool-name: HikariPool-Main

maximumPoolSize 公式

HikariCP 官方推薦公式（基於 PostgreSQL 基準測試，MySQL 也適用）：

JPA Enum 型別處理完整指南：映射策略與最佳實踐

Thu, 05 Jan 2023 23:18:48 +0800

概述

在企業級應用程式開發中，Enum（列舉）是表示有限狀態集合的理想選擇，如訂單狀態、使用者角色、審核狀態等。本文深入探討如何在 JPA/Hibernate 中有效處理 Enum 型別，包含各種映射策略、效能考量和實際應用場景。

基本 Enum 映射

1. @Enumerated 註解

JPA 提供 @Enumerated 註解來處理 Enum 映射，支援兩種策略：

EnumType.ORDINAL（數字映射）

// 定義狀態列舉
public enum OrderStatus {
    PENDING,    // 0
    CONFIRMED,  // 1
    SHIPPED,    // 2
    DELIVERED,  // 3
    CANCELLED   // 4
}

// 實體類使用
@Entity
@Table(name = "orders")
public class Order {
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Enumerated(EnumType.ORDINAL)
    @Column(name = "status", nullable = false)
    private OrderStatus status = OrderStatus.PENDING;
    
    // 其他屬性...
}

資料庫儲存：

Docker MySQL：容器化部署與設定

Tue, 18 Jan 2022 23:56:44 +0800

概述

在現代開發流程中，使用 Docker 部署資料庫已成為主流。將 MySQL 運行在 Docker 容器中，可以帶來許多好處：環境隔離、快速部署、版本控制、以及方便的遷移。這篇文章將引導您如何在 Docker 中設定和管理 MySQL 容器。

啟動 MySQL 容器

鏡像選擇：mysql/mysql-server 是 Oracle 的私有版本（不同於 Docker Hub 官方鏡像），現已標記為 deprecated。請使用官方 mysql 鏡像（docker.io/library/mysql）。

使用 docker run 指令可以快速啟動一個 MySQL 容器。以下是一個常用的範例，包含了密碼設定、埠映射和字元集設定。

docker run \
    --name mysql-server \
    -e MYSQL_ROOT_PASSWORD=your_strong_password \
    -p 3306:3306 \
    -d \
    mysql:8.0 \
    --character-set-server=utf8mb4 \
    --collation-server=utf8mb4_unicode_ci \
    --skip-character-set-client-handshake

指令參數說明

--name mysql-server: 為容器指定一個易於識別的名稱，這裡命名為 mysql-server。
-e MYSQL_ROOT_PASSWORD=your_strong_password: 設定 MySQL root 使用者的密碼。請務必將 your_strong_password 替換為您自己的強密碼。
-p 3306:3306: 將主機的 3306 埠映射到容器的 3306 埠。這樣您就可以從主機透過 3306 埠連接到容器內的 MySQL 服務。
-d: 以背景模式 (detached mode) 運行容器，讓容器在背景執行。
mysql:8.0: 指定要使用的 Docker 映像檔。使用 Docker Hub 官方 mysql 鏡像。
--character-set-server=utf8mb4: 設定 MySQL 伺服器的預設字元集為 utf8mb4，以支援更廣泛的字元，包括表情符號。
--collation-server=utf8mb4_unicode_ci: 設定伺服器的預設排序規則為 utf8mb4_unicode_ci，這是一種不區分大小寫和重音的排序規則。
--skip-character-set-client-handshake: 禁用客戶端字元集握手。這有助於確保客戶端和伺服器之間的字元集一致性，避免亂碼問題。

字元集設定的等效配置

上述字元集相關的 docker run 參數，在 MySQL 的配置檔 (my.cnf) 中，等效於以下設定：