萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL 影響行數獲取函數實測:ROW_COUNT() vs FOUND_ROWS() 正確用法

核心函數對照

函數適用操作回傳值含義注意事項
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` → 重置計數器,回傳值錯誤。
copyright © 萬盛學電腦網 all rights reserved