MySQL 行前連線資訊確認
本文件用於補齊 MySQL TaskStore PoC 進入程式實作前的行前確認節點。在 Schema Attribute、Schema Initializer 或 TaskStore 實作前,需先確認使用者已建立可供測試的 MySQL database,並提供必要連線資訊。
本文件只定義行前確認項目,不代表已經同意連線資料庫、建立資料表、修改程式 repo、安裝套件或改變啟動方式。
節點定位
MySQL 行前連線資訊確認
- MySQL 套件選型分析
- MySQL Schema 自動建表設計
- MySQL schema Class 初稿
- MySQL 行前連線資訊確認
- Schema Attribute 實作前確認
- Schema Generator / Initializer 實作
- MySQL TaskStore PoC
使用者需提供資訊
| 項目 | 範例 | 是否必填 | 說明 |
|---|---|---|---|
| MySQL 版本 | 5.6.2 | 是 | 需確認是否為 PoC 目標版本 |
| Host / IP | 127.0.0.1 或內部 IP | 是 | MySQL Server 位置 |
| Port | 3306 | 是 | MySQL 連線埠 |
| Database Name | hs_device_control | 是 | 建議先由使用者或 DBA 建立 |
| User | hs_app | 是 | PoC 使用者帳號 |
| Password | 不寫入文件 | 是 | 不得提交到 repo |
| Charset | utf8 | 建議 | MySQL 5.6.2 第一版建議 utf8 |
| 是否允許自動建表 | true / false | 是 | 對應 AutoCreateSchema |
| 是否只做 Dry Run | true / false | 是 | 首次建議先 Dry Run |
密碼與敏感資訊規則
- 實際 password 不得寫入 Markdown、HTML、README、commit 訊息或 GitHub issue。
- 若需要提供給 Codex 測試,建議使用本機環境變數、
.env.local或臨時輸入方式。 .env.local、連線字串檔、匯出的 DB 密碼檔不得提交到 repo。
HS_DB_HOST
HS_DB_PORT
HS_DB_NAME
HS_DB_USER
HS_DB_PASSWORD
建議連線字串格式
Server={HOST};Port={PORT};Database={DB_NAME};Uid={USER};Pwd={PASSWORD};CharSet=utf8;
Database 建立責任
第一版建議 database 由使用者、DBA 或部署流程先建立。程式不自動建立 database,只在既有 database 內自動建立缺少的 table、column、index。
CREATE DATABASE hs_device_control DEFAULT CHARACTER SET utf8;
權限需求
| 權限 | 用途 |
|---|---|
SELECT | 查詢任務紀錄、讀取 information_schema |
INSERT | 寫入任務、節點、命令與錯誤紀錄 |
UPDATE | 更新任務狀態與結束時間 |
CREATE | 建立缺少的 table |
ALTER | 補缺少的 column |
INDEX | 建立缺少的 index |
行前測試順序
| 順序 | 測試 | 目的 | 預期結果 |
|---|---|---|---|
| 1 | TCP 連線測試 | 確認 Host / Port 可達 | 可連到 MySQL port |
| 2 | 登入測試 | 確認 user / password 正確 | 可成功登入 |
| 3 | 版本查詢 | 確認 MySQL 版本 | 回傳 5.6.2 或相容版本 |
| 4 | Database 存在測試 | 確認 DB name 正確 | 可切換到指定 database |
| 5 | 權限測試 | 確認可建表與補索引 | 權限符合 PoC 需求 |
| 6 | Dry Run SQL | 先產 SQL 不執行 | 可檢視即將建立的 DDL |
| 7 | AutoCreateSchema 測試 | 建立缺少 table / column / index | 建表成功且可重複啟動 |
行前確認表
| 項目 | 狀態 | 完成條件 | 是否卡住下一步 |
|---|---|---|---|
| MySQL Server 可連線 | 待確認 | Host / Port 已提供,且後續可測試連線 | 是 |
| MySQL 版本符合 5.6.2 | 待確認 | 查詢結果為 5.6.2 或已確認相容差異 | 是 |
| Database 已建立 | 待確認 | 指定 database 已存在 | 是 |
| User 已建立 | 待確認 | PoC 專用帳號已建立 | 是 |
| Password 已安全提供 | 待確認 | 以環境變數、臨時輸入或其他安全通道提供 | 是 |
| 權限符合需求 | 待確認 | 具備 SELECT / INSERT / UPDATE / CREATE / ALTER / INDEX | 是 |
| Dry Run 策略已確認 | 待確認 | 首次建議先只輸出 SQL | 是 |
| AutoCreateSchema 策略已確認 | 待確認 | 確認是否允許程式建立 table / column / index | 是 |
| 敏感資訊未進 repo | 待確認 | 未寫入真實密碼或完整 ConnectionString | 是 |
可回覆給 Codex 的確認摘要
請只填非敏感資訊。Password 請填提供方式,不要填真實值。
MySQL 版本:
Host / IP:
Port:
Database Name:
User:
Password 提供方式:
Charset:
AutoCreateSchema:
DryRunSchemaSql:
StopOnSchemaMismatch:
權限確認:
建議下一步
MySQL 行前資訊填寫範本請參考:MySQL 行前資訊填寫範本。
建議下一步先由使用者依範本確認並提供 MySQL 行前連線資訊。資訊齊全後,再進入「Schema Attribute 實作前確認」與程式 repo 實作。