build Nyrdex

MariaDB 資料庫匯出與匯入

指令(command)

# 匯出(InnoDB 不鎖表,含預存程序、觸發程序與排程事件)
mariadb-dump --default-character-set=utf8mb4 --single-transaction \
  --routines --triggers --events -u username -p mydb > mydb_20261006.sql

# 匯出並壓縮
mariadb-dump --default-character-set=utf8mb4 --single-transaction -u username -p mydb | gzip > mydb_20261006.sql.gz

# 匯入,資料庫要先存在
mariadb --default-character-set=utf8mb4 -u username -p mydb < mydb_20261006.sql

# 只匯出指定資料表
mariadb-dump --default-character-set=utf8mb4 --single-transaction -u username -p mydb posts users > mydb_tables.sql

使用情境(description)

備份資料庫、搬移主機,或把正式資料複製到測試環境時使用。匯出與匯入都指定 utf8mb4 比較安全,可以避免中文或 emoji 變成亂碼。

參數說明

參數 說明
--default-character-set=utf8mb4 指定連線使用的字元集
--single-transaction InnoDB 用一致性快照匯出,不用鎖表
--routines、--events 一併匯出預存程序與排程事件,預設不包含
--triggers 匯出觸發程序,預設已開啟,寫出來比較明確
-p 不接密碼時,執行後才提示輸入

常見誤區(pitfalls)

  • 匯入會覆蓋同名資料表:匯出檔預設含 DROP TABLE IF EXISTS,匯入前先備份目標資料庫。
  • 不要把密碼寫在指令裡:-p'password' 會留在 shell 歷史,也可能出現在程序清單。排程要用時,把帳密放在權限 600 的設定檔,並用 --defaults-extra-file 指定。
  • Windows PowerShell 的亂碼:不要用 > 匯出,見 Mysql 在 PowerShell 匯出出現亂碼。
  • 匯入舊版用戶端失敗:較新版的 MariaDB 匯出檔第一行有 sandbox 模式標記,舊版用戶端可能無法解析。

相關連結(related)

← 所有 Runbook 文章