MySQL 查詢結果導出 Excel/CSV 完整指南：命令行、SELECT INTO OUTFILE、權限問題排查

MySQL 查詢結果導出 Excel/CSV 完整指南：命令行、SELECT INTO OUTFILE、權限問題排查

將查詢結果導出為表格文件是數據分析、報表分發、數據遷移的高頻需求。本文對比命令行導出、SELECT ... INTO OUTFILE、客戶端工具三大方案，並詳細講解 macOS/Linux/Windows 下的權限陷阱與解決方案。

方案一：命令行直導 (最簡單、無需文件權限)

# 基本語法
mysql -h -u -p -D -e "" > /path/to/output.xls

# 實例：導出全表為 Tab 分隔文本 (Excel 可直接打開)
mysql -h127.0.0.1 -uroot -p123 -Dtest -e "SELECT * FROM edu_iclass_areas" > /Users/zhengcanrui/WORK/test/test.xls

# 參數說明
# -h: 主機
# -u: 用戶
# -p: 密碼 (緊跟 -p 無空格，或交互式輸入)
# -D: 數據庫
# -e: 直接執行 SQL
# > : Shell 重定向輸出

優點：無需 MySQL 服務器文件寫入權限，客戶端本地即可生成文件。
缺點：大數據量輸出慢，無法直接生成標準 CSV (需後處理)。

方案二：SELECT ... INTO OUTFILE (服務端生成、高性能)

-- 登入 MySQL 後執行
SELECT * FROM edu_iclass_areas
INTO OUTFILE '/tmp/export.csv'
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n';

前置條件：

1. MySQL 服務進程擁有目標目錄寫入權限 (通常需 secure_file_priv 允許)。
2. 當前用戶擁有 FILE 權限：GRANT FILE ON *.* TO 'user'@'host';

查看 secure_file_priv 限制：

SHOW VARIABLES LIKE 'secure_file_priv';
-- NULL: 禁用導出
-- /var/lib/mysql-files/: 僅允許此目錄
-- 空值: 無限制 (不安全，生產慎用)

方案三：macOS 終端啟動 MySQL 並導出 (圖文步驟)

1. 系統偏好設置 → MySQL → 啟動 MySQL 服務。
2. 啟動 終端 (應用程式 → 實用工具)。
3. 臨時加入 PATH：export PATH=$PATH:/usr/local/mysql/bin
4. 登入：mysql -uroot -p
5. 執行導出命令 (方案一或二)。

權限問題終極排查清單

生產環境導出最佳實踐

1. 大數據分批：SELECT ... LIMIT 100000 OFFSET 0 INTO OUTFILE ... 循環導出，避免單文件過大。
2. 壓縮傳輸：mysql ... | gzip > dump.sql.gz 或導出後 gzip export.csv。
3. 遠程導出：mysqldump -h -P3306 -u... -p... db table | gzip > local_dump.sql.gz
4. 驗證數據完整性：導出行數 vs SELECT COUNT(*)，抽樣對比關鍵欄位。
5. 敏感數據脫敏：導出前在 SQL 中對手機/身份證/金額做掩碼處理。

命令行重定向 (方案一) 是通用性最強、權限要求最低的方案，建議作為首選；INTO OUTFILE 適合服務端有權限且追求極致性能的場景。