核心函數對照
| 函數 | 適用操作 | 回傳值含義 | 注意事項 |
ROW_COUNT() | `INSERT`、`UPDATE`、`DELETE`、`REPLACE` | 受影響的行數 | 需緊接在 DML 語句**之後立即呼叫**,中間不可有其他查詢 |
FOUND_ROWS() | `SELECT` (配合 `SQL_CALC_FOUND_ROWS`) | 查詢符合條件的總行數 (忽略 LIMIT) | 必須在 `SELECT` 使用 `SQL_CALC_FOUND_ROWS` 提示,否則僅回傳實際傳回行數 |
完整驗證腳本
DROP DATABASE IF EXISTS `mytest`;
CREATE DATABASE `mytest`;
USE `mytest`;
DROP TABLE IF EXISTS `MyTestTable`;
CREATE TABLE `MyTestTable` (`ID` INT, `Name` VARCHAR(10));
-- 1. INSERT 測試
INSERT INTO `MyTestTable` (`ID`,`Name`)
SELECT 1,'role1' UNION ALL SELECT 2,'role2' UNION ALL SELECT 3,'role3';
SELECT ROW_COUNT(); -- 輸出 3 (INSERT 影響行數)
-- 注意: INSERT ... VALUES 單列僅回傳 1
-- 2. SELECT 測試
SELECT * FROM `MyTestTable`;
SELECT FOUND_ROWS(); -- 輸出 3 (無 LIMIT 時等同總行數)
-- 正確用法: 分頁查詢取總數
SELECT SQL_CALC_FOUND_ROWS * FROM `MyTestTable` LIMIT 2;
SELECT FOUND_ROWS(); -- 輸出 3 (總行數),而非 2
-- 3. UPDATE 測試
UPDATE `MyTestTable` SET `Name`='people';
SELECT ROW_COUNT(); -- 輸出 3 (全部更新)
-- 4. DELETE 測試
DELETE FROM `MyTestTable`;
SELECT ROW_COUNT(); -- 輸出 3 (全部刪除)
應用場景:分頁查詢總筆數 (避免雙查詢)
-- 傳統做法: 兩次查詢
SELECT COUNT(*) FROM BigTable WHERE Condition;
SELECT * FROM BigTable WHERE Condition LIMIT 20 OFFSET 40;
-- 優化做法: 一次查詢 + FOUND_ROWS()
SELECT SQL_CALC_FOUND_ROWS * FROM BigTable WHERE Condition LIMIT 20 OFFSET 40;
SELECT FOUND_ROWS(); -- 取得總筆數,前端計算總頁數
效能提示: `SQL_CALC_FOUND_ROWS` 會掃描所有符合條列,大數據量下仍有開銷。極大表建議使用獨立 `COUNT(*)` 配合覆蓋索引,或快取總數 (Redis)。
程式語言介面對應
| 語言/驅動 | 取得影響行數 API |
| MySQL C API | `mysql_affected_rows(MYSQL*)` |
| JDBC (Java) | `Statement.getUpdateCount()` / `executeUpdate()` 回傳值 |
| Connector/NET (C#) | `MySqlCommand.ExecuteNonQuery()` 回傳 `int` |
| PDO (PHP) | `PDOStatement->rowCount()` (僅 INSERT/UPDATE/DELETE) |
| mysqli (PHP) | `mysqli_affected_rows($link)` / `$stmt->affected_rows` |
常見誤區
- ❌ `SELECT ROW_COUNT()` 放在 `SELECT` 後 → 回傳 `-1` 或 `0` (無意義)。
- ❌ `SELECT FOUND_ROWS()` 沒加 `SQL_CALC_FOUND_ROWS` → 回傳實際傳回行數 (受 `LIMIT` 影響)。
- ❌ 中間插入 `PRINT`、`SET`、另一個 `SELECT` → 重置計數器,回傳值錯誤。