14,953
edits
| (21 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
排除 MySQL 技術疑難問題 | 排除 MySQL 技術疑難問題 | ||
{{LanguageSwitcher | content = [[Troubleshooting of MySQL errors | | {{LanguageSwitcher | content = [[Troubleshooting of MySQL errors | English]], [[排除 MySQL 技術疑難問題|漢字]]}} | ||
本文探討了使用 MySQL 時遇到的各種常見問題,並根據其性質和影響將它們分為七個不同的類別。這些類別有助於識別潛在的問題並促進高效的故障排除。這些問題分類如下: | 本文探討了使用 MySQL 時遇到的各種常見問題,並根據其性質和影響將它們分為七個不同的類別。這些類別有助於識別潛在的問題並促進高效的故障排除。這些問題分類如下: | ||
| Line 59: | Line 59: | ||
* 檢查 mysql 數據文件夾所在的磁碟空間是否足夠。例如,在 {{Linux}} 上輸入 {{kbd | key=df -h}} | * 檢查 mysql 數據文件夾所在的磁碟空間是否足夠。例如,在 {{Linux}} 上輸入 {{kbd | key=df -h}} | ||
* 更多資訊請見 [http://stackoverflow.com/questions/18719748/error-1006-hy000-cant-create-database-errno-13-mysql-5-6-12 ERROR 1006 (HY000) 無法創建資料庫 (errno: 13) MySQL 5.6.12 - Stack Overflow]。 | * 更多資訊請見 [http://stackoverflow.com/questions/18719748/error-1006-hy000-cant-create-database-errno-13-mysql-5-6-12 ERROR 1006 (HY000) 無法創建資料庫 (errno: 13) MySQL 5.6.12 - Stack Overflow]。 | ||
=== ERROR 1010: Error dropping database (can't rmdir) === | |||
Message: <pre>Error dropping database (can't rmdir '.\<db_name>\', errno: 17)</pre> | |||
解決方式 | |||
* 手動刪除資料庫目錄中殘留的非 MySQL 檔案(例如 .sql 檔案),再重新執行 DROP DATABASE;或直接手動刪除整個資料夾。 | |||
根本原因 | |||
* MySQL 的 DROP DATABASE 只會移除它所管理的檔案。資料目錄中若存在其他外來檔案(例如 .sql 備份檔),將導致 rmdir 無法移除資料夾,進而觸發 errno 17(ENOTEMPTY)。 | |||
=== ERROR 1017 - Can't find file: '.\DATABASE\TABLE.frm' (errno: 22 - Invalid argument) === | === ERROR 1017 - Can't find file: '.\DATABASE\TABLE.frm' (errno: 22 - Invalid argument) === | ||
| Line 185: | Line 194: | ||
</pre> | </pre> | ||
=== | == 訪問和認證錯誤 == | ||
=== [Warning] Using a password on the command line interface can be insecure === | |||
問題描述: | |||
使用 bash 命令匯出或匯入 MySQL 資料庫時,可能會遇到以下警告:[警告] 在命令行介面上使用密碼可能不安全。 | |||
<pre> | |||
mysql: [Warning] Using a password on the command line interface can be insecure. | |||
or | |||
mysqldump: [Warning] Using a password on the command line interface can be insecure. | |||
</pre> | |||
這通常發生在使用如下命令時: | |||
<pre> | <pre> | ||
mysqldump -u USERNAME -p -h 127.0.0.1 --default-character-set=utf8 DATABASE > DATABASE.sql | |||
</pre> | </pre> | ||
解決方案:要解決此警告並提高安全性,請按照以下步驟操作: | |||
# 使用 [https://dev.mysql.com/doc/refman/8.4/en/mysql-config-editor.html mysql_config_editor] 設定登入路徑 (login path):{{kbd | key=<nowiki>mysql_config_editor set --login-path=local --host=localhost --user=root --password</nowiki>}} | |||
# 匯出或匯入 MySQL 資料庫時使用登入路徑 (1) 匯出時:{{kbd | key=<nowiki>mysqldump --login-path=local --default-character-set=utf8 資料庫名稱 > 資料庫名稱.sql</nowiki>}} (2) 匯入時:{{kbd | key=<nowiki>pv 資料庫名稱.sql.gz | gunzip | mysql --login-path=local --default_character_set utf8 --force 資料庫名稱</nowiki>}} | |||
# 查看所有已設定的登入路徑 {{kbd | key=<nowiki>mysql_config_editor print --all</nowiki>}} | |||
透過使用登入路徑,可以避免在命令行中暴露密碼,解決安全警告。 | |||
=== 錯誤 1044 (42000): 拒絕使用者 'USER'@'localhost' 存取資料庫 'DATABASE_NAME' === | === 錯誤 1044 (42000): 拒絕使用者 'USER'@'localhost' 存取資料庫 'DATABASE_NAME' === | ||
訊息:{{kbd | key=<nowiki>錯誤 1044 (42000): 拒絕使用者 'USER'@'localhost' 存取資料庫 'DATABASE_NAME'</nowiki>}} | 訊息:{{kbd | key=<nowiki>錯誤 1044 (42000): 拒絕使用者 'USER'@'localhost' 存取資料庫 'DATABASE_NAME'</nowiki>}} | ||
| Line 257: | Line 282: | ||
* 您可能需要刪除現有的帳戶設定並重新配置。 | * 您可能需要刪除現有的帳戶設定並重新配置。 | ||
== SQL | === 錯誤!: SQLSTATE[28000]: 無效的授權規格:1045 拒絕訪問 === | ||
訊息:錯誤!: {{kbd | key=<nowiki>SQLSTATE[28000]: 無效的授權規格:1045 拒絕使用者 'user'@'localhost' 存取(使用密碼:YES)</nowiki>}} | |||
解決方案: | |||
* 如果您執行了查詢 {{kbd | key=INTO OUTFILE}},您需要授予文件權限,例如:{{kbd | key=GRANT FILE ON *.* TO 'user'@'localhost';}}<ref>[https://dev.mysql.com/doc/refman/5.7/en/privileges-provided.html#priv_file MySQL :: MySQL 5.7 參考手冊 :: 6.2.1 提供的權限]</ref><ref>[https://stackoverflow.com/questions/6091427/mysql-into-outfile-access-denied-but-my-user-has-all-access-and-the-fold MYSQL into outfile "拒絕訪問" - 但我的使用者有 "全部" 訪問權限.. 且文件夾是 CHMOD 777 - Stack Overflow]</ref>。 | |||
相關問題:"錯誤!: SQLSTATE[HY000]: 一般錯誤:1290 MySQL 伺服器正在使用 --secure-file-priv 選項運行,所以它不能執行這個聲明"<ref>[https://stackoverflow.com/questions/32737478/how-should-i-tackle-secure-file-priv-in-mysql 資料庫 - 如何處理 MySQL 中的 --secure-file-priv? - Stack Overflow]</ref> | |||
== SQL 查詢語法錯誤 == | |||
=== 捕獲異常:SQLSTATE[HY093]:無效的參數編號:參數未定義 === | === 捕獲異常:SQLSTATE[HY093]:無效的參數編號:參數未定義 === | ||
解決方案 | 解決方案 | ||
* 問號的數量與查詢值的數量不一致 <ref>[https://stackoverflow.com/questions/10966251/sqlstatehy093-invalid-parameter-number-parameter-was-not-defined php Invalid parameter number: parameter was not defined - Stack Overflow]</ref> | * 問號的數量與查詢值的數量不一致 <ref>[https://stackoverflow.com/questions/10966251/sqlstatehy093-invalid-parameter-number-parameter-was-not-defined php Invalid parameter number: parameter was not defined - Stack Overflow]</ref> | ||
| Line 286: | Line 319: | ||
$ file plain_text.sql | $ file plain_text.sql | ||
plain_text.sql:UTF-8 Unicode 文本,帶有非常長的行 | plain_text.sql:UTF-8 Unicode 文本,帶有非常長的行 | ||
</pre> | |||
=== 錯誤 1055: Expression #1 of SELECT list is not in GROUP BY clause and contains nonaggregated column === | |||
訊息 | |||
<pre> | |||
查詢發生錯誤 (1055): Expression #1 of SELECT list is not in GROUP BY clause and contains nonaggregated column 'test.posts.id' which is not functionally dependent on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by | |||
</pre> | |||
遇到錯誤的查詢 | |||
<pre> | |||
-- 建立範例資料表 | |||
CREATE TABLE posts ( | |||
id INT, | |||
post_id VARCHAR(10), | |||
author VARCHAR(50), | |||
content TEXT, | |||
likes INT, | |||
post_time DATETIME | |||
); | |||
-- 插入範例資料 | |||
INSERT INTO posts VALUES | |||
(1, 'A123', 'Alice', '第一篇文章', 10, '2024-01-01'), | |||
(2, 'A123', 'Bob', '推推', 5, '2024-01-02'), | |||
(3, 'A123', 'Bob', '讚讚', 3, '2024-01-03'); | |||
-- 這會報錯 | |||
SELECT | |||
id, -- 問題: 沒有在 GROUP BY 中 | |||
post_id, | |||
author, | |||
GROUP_CONCAT(content SEPARATOR "\n") AS content, -- 問題: 沒有在 GROUP BY 中 | |||
likes -- 問題: 沒有在 GROUP BY 中 | |||
FROM posts | |||
GROUP BY post_id, author; | |||
</pre> | |||
解決方案:修正後的查詢 (1) SELECT 中的每個欄位要麼放在 GROUP BY 中、或 (2) 使用彙總函數 (如 MAX, MIN, SUM, COUNT, GROUP_CONCAT) | |||
<pre> | |||
-- 方法一:取消 `sql_mode=only_full_group_by`: | |||
有兩種方法可以取消 `sql_mode=only_full_group_by`: | |||
1. 暫時性修改 (僅對當前會話有效) | |||
```sql | |||
SET sql_mode=(SELECT REPLACE(@@sql_mode,'ONLY_FULL_GROUP_BY','')); | |||
``` | |||
2. 永久性修改 (修改 MySQL 設定檔) | |||
- 找到 MySQL 設定檔 (通常是 `my.cnf` 或 `my.ini`) | |||
- 在 `[mysqld]` 區段加入或修改: | |||
```ini | |||
[mysqld] | |||
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION | |||
``` | |||
注意事項: | |||
1. 修改設定檔後需要重啟 MySQL 服務才會生效 | |||
2. 不建議取消這個設定,因為: | |||
- 可能導致查詢結果不可預測 | |||
- 違反 SQL 標準 | |||
- 可能在未來版本中產生相容性問題 | |||
建議的做法是修正 SQL 查詢而不是更改 SQL mode。 | |||
-- 方法二: 把所有欄位加入 GROUP BY | |||
SELECT | |||
id, | |||
post_id, | |||
author, | |||
content, | |||
likes | |||
FROM posts | |||
GROUP BY post_id, author, id, content, likes; | |||
-- 方法三: 對非 GROUP BY 的欄位使用彙總函數 | |||
SELECT | |||
MAX(id) as id, | |||
post_id, | |||
author, | |||
GROUP_CONCAT(content) as contents, | |||
SUM(likes) as total_likes | |||
FROM posts | |||
GROUP BY post_id, author; | |||
</pre> | </pre> | ||
| Line 330: | Line 446: | ||
* [https://www.eversql.com/sql-syntax-check-validator/ SQL 語法檢查在線上,SQL 驗證器,即時 SQL 編譯器在線上 - EverSQL] {{exclaim}} 不支持 [https://www.php.net/manual/en/pdo.prepare.php PHP: PDO::prepare],其中查詢語法包含問號。 | * [https://www.eversql.com/sql-syntax-check-validator/ SQL 語法檢查在線上,SQL 驗證器,即時 SQL 編譯器在線上 - EverSQL] {{exclaim}} 不支持 [https://www.php.net/manual/en/pdo.prepare.php PHP: PDO::prepare],其中查詢語法包含問號。 | ||
== | == 連接和網路錯誤 == | ||
=== MySQL 伺服器已斷開 (has gone away) === | === MySQL 伺服器已斷開 (has gone away) === | ||
步驟 | 步驟 | ||
| Line 416: | Line 532: | ||
INSERT IGNORE INTO `target`.`table` SELECT * FROM `source`.`table` LIMIT 0, 10000; | INSERT IGNORE INTO `target`.`table` SELECT * FROM `source`.`table` LIMIT 0, 10000; | ||
</pre> | </pre> | ||
=== 從 MySQL 資料轉移至 MSSQL === | |||
情況: 需要將 MySQL 資料庫中的資料同步或遷移至 Microsoft SQL Server。 | |||
解決方案: | |||
* (手動方式) 匯出 MySQL 資料為 MSSQL 相容格式: {{kbd | key=<nowiki>mysqldump --compatible=mssql [database_name]</nowiki>}}<ref>[https://dev.mysql.com/doc/refman/8.4/en/mysqldump.html#option_mysqldump_compatible MySQL :: MySQL 8.4 Reference Manual :: 6.5.4 mysqldump — A Database Backup Program]</ref> | |||
* (自動方式) 使用 [https://learn.microsoft.com/en-us/sql/ssma/sql-server-migration-assistant?view=sql-server-ver17 Microsoft SQL Server Migration Assistant]、''$'' [https://www.webyog.com/product/sqlyog SQLyog] 工具 (適用於 {{Win}})。設定特定查詢來控制要從 MySQL 轉移至 Microsoft SQL Server 的資料。 | |||
常見挑戰: | |||
* 大型資料集的連線逾時問題: 參考 2013 錯誤的故障排除方法,例如延長逾時參數或實施批次處理。 | |||
* 資料類型不相容: 在遷移前驗證兩系統間的類型對應,以防止資料損壞或遺失。 | |||
== 資源和環境錯誤 == | == 資源和環境錯誤 == | ||
| Line 544: | Line 671: | ||
[http://errerrors.blogspot.com/2016/07/mysql.html Err: 解決 MySQL 資料庫所在硬碟空間不足的狀況] | [http://errerrors.blogspot.com/2016/07/mysql.html Err: 解決 MySQL 資料庫所在硬碟空間不足的狀況] | ||
== 其他工具特定錯誤 == | == 其他工具特定錯誤 == | ||
| Line 571: | Line 689: | ||
* 限制 MySQL 查詢的行數 | * 限制 MySQL 查詢的行數 | ||
== Navicat 錯誤: 導入數據筆數不一致 == | === Navicat error: Field doesn't have a default value === | ||
錯誤: | |||
<pre> | |||
[ERR] 1364 - Field 'source' doesn't have a default value | |||
</pre> | |||
解決方案: | |||
* 從 Excel 匯入到資料庫時,source 欄位是空值或者沒有指定,需要指定 source 欄位值。或者修改欄位定義,允許欄位值可以 NULL。 | |||
=== Navicat 錯誤: 導入數據筆數不一致 === | |||
錯誤: | 錯誤: | ||
| Line 579: | Line 706: | ||
* [https://errerrors.blogspot.com/2023/11/blog-post.html 解決 NaviCat 匯入 Excel 檔案到資料庫,出現資料總筆數不一致的問題] (written in Mandarin) | * [https://errerrors.blogspot.com/2023/11/blog-post.html 解決 NaviCat 匯入 Excel 檔案到資料庫,出現資料總筆數不一致的問題] (written in Mandarin) | ||
== 如何解決 “zsh: operation not permitted: xxx.sql” == | === 如何解決 “zsh: operation not permitted: xxx.sql” === | ||
錯誤情況 | 錯誤情況 | ||
<pre> | <pre> | ||
| Line 596: | Line 723: | ||
* 尋找終端機應用程式或 iTerm2 或你正在使用的任何終端機,勾選允許完整磁碟存取的方框。 | * 尋找終端機應用程式或 iTerm2 或你正在使用的任何終端機,勾選允許完整磁碟存取的方框。 | ||
* 重啟你的終端機。 | * 重啟你的終端機。 | ||
== 延伸閱讀 == | |||
* 如果找不到想要的問題答案,可以前往stackoverflow 尋找 [https://stackoverflow.com/questions/tagged/mysql Unanswered 'mysql' Questions - Stack Overflow] | |||
== References == | == References == | ||
<references/> | <references/> | ||
{{Template: | {{Template: Data factory flow in Mandarin}} | ||
[[Category:MySQL]] | [[Category: MySQL]] | ||
[[Category:Database]] | [[Category: Database]] | ||
[[Category:Data Science]] | [[Category: Data Science]] | ||
[[Category: Revised with LLMs]] | |||