alex9ufo 聰明人求知心切: Node-Red +SQLite <範例1>

Node-Red +SQLite範例

SQLite 是一款非常獨特且極受歡迎的關聯式資料庫管理系統（RDBMS）。與 MySQL、PostgreSQL 或 Oracle 等傳統資料庫不同，SQLite 的核心設計理念是輕量化、嵌入式且無需設定。

以下為您詳細拆解 SQLite 的核心功能與特性：

💡 核心特性 (Key Features)

1. 嵌入式與伺服器無關 (Serverless)

傳統資料庫需要啟動一個獨立的伺服器行程（Process），並透過網路連接埠（如 MySQL 的 3306）進行通訊。

SQLite 沒有獨立的伺服器行程。
它是一個軟體庫（Library），直接被編譯並嵌入到你的應用程式中。應用程式透過直接呼叫函數來讀寫資料，完全省去了網路傳輸的開銷。

2. 單一檔案儲存 (Single-File Database)

SQLite 將整個資料庫（包含結構定義、資料表、索引、資料本身）完整地儲存在電腦硬碟中的單一個普通檔案中。
這使得資料庫的備份、複製、共享變得極其簡單，就像移動一個 Word 文件一樣方便。

3. 零配置 (Zero-Configuration)

使用 SQLite 不需要安裝、不需要設定設定檔、不需要管理使用者權限，更不需要啟動或停止服務。
只要你的應用程式載入了 SQLite 庫，指定一個檔案路徑，資料庫就馬建好並可以使用了。

4. 跨平台與高相容性

SQLite 的資料庫檔案格式是跨平台的。你在 Windows 上生成的資料庫檔案，可以直接複製到 Mac、Linux、iOS 或 Android 上直接讀取，完全不需要轉換格式。

5. 動態型別系統 (Manifest Typing)

多數 SQL 資料庫（如 MySQL）在建立欄位時如果指定了 INTEGER，就絕對不能存入字串。
SQLite 採用動態型別，資料的型別是跟著「資料本身」走，而不是跟著「欄位」走。你可以在一個 INTEGER 欄位裡存入字串（除了 INTEGER PRIMARY KEY 例外）。

🛠️ 主要功能 (Major Capabilities)

完整的 SQL 支援： 支援絕大多數的 SQL-92 標準，包含複雜的查詢（JOIN、SUBQUERY）、檢視表（VIEW）、觸發器（TRIGGER）以及視窗函數（Window Functions）。
ACID 事務支援： 具備完整的原子性（Atomicity）、一致性（Consistency）、隔離性（Isolation）與持久性（Durability）。即使程式崩潰或突然斷電，也能確保資料不會損壞。
記憶體資料庫 (In-Memory Database)： 支援直接在記憶體中建立資料庫（使用 :memory: 作為檔名），讀寫速度極快，非常適合用於暫存資料或單元測試（Unit Test）。
高效能的讀取： 對於中小型規模的資料，SQLite 的讀取速度往往比傳統客戶端/伺服器架構的資料庫還要快，因為它沒有網路延遲。

⚖️ 優缺點與適用場景

優點 (Pros)	缺點與限制 (Cons)
極度輕量：核心庫大小通常小於 1MB。	不適合高併發寫入：寫入時會鎖定整個資料庫檔案，若有大量同時寫入的需求會遭遇瓶頸。
維護成本極低：免去維護資料庫伺服器的煩惱。	缺乏細粒度權限控制：無法針對單一使用者設定特定資料表的讀寫權限。
隨處可見：Android、iOS、Windows、Mac 內部都內建了 SQLite。	不適合海量資料：雖然理論支援到 281 TB，但超大型數據更適合分布式資料庫。

🎯 最佳適用場景：

行動裝置與桌面軟體：App（iOS/Android）儲存用戶資料、瀏覽器（如 Chrome）儲存歷史紀錄。
物聯網與嵌入式設備 (IoT)：無人機、智慧家電、車載系統。
軟體開發與測試：在開發階段快速驗證功能，或作為單元測試的隔離資料庫。
低流量網站/工具：個人部落格、企業內部小型管理系統。

數字

let temp="update Score set";
temp=temp+"  chinese= " + chin ;
temp=temp+", mathematics= "+ math ;
temp=temp+", english= " + engl ;
temp=temp+", total= " + tot ;
temp=temp+", average= " + avg ;
temp=temp+" where name= '"+ name +"'";
msg.topic=temp;
return msg;

文字

var action = msg.topic;
var form = flow.get("student_form") || {};

var student_id = form.student_id ? form.student_id.trim() : "";
var name = form.name ? form.name.trim() : "";
var gender = form.gender ? form.gender.trim() : "女";
var birth = form.birth_date || "";
var school = form.grad_school ? form.grad_school.trim() : "";
var note = form.note ? form.note.trim() : "";
if (student_id === "") {
    node.error("【系統警告】更正資料失敗：必須提供欲修改之『學號』！");
         return null;
    }

let temp = "update students set";
temp = temp + "  name= '" + name +"'";
temp = temp + ", gender= '" + gender + "'";
temp = temp + ", birth_date= '" + birth + "'";
temp = temp + ", grad_school= '" + school + "'";
temp = temp + ", note= '" + note + "'";
temp = temp + " where student_id= '" + student_id + "'";
msg.topic = temp;
return msg;

這份 JSON 程式碼構建了一個非常完整且設計精良的學生資料管理系統（第一部分）。它採用了 Node-RED Dashboard 作為前端視覺化網頁，並以 SQLite 作為後端實體資料庫。

以下為您詳細拆解與說明這個程式的核心架構、資料流向與節點分工。

🏗️ 一、系統視覺與佈局架構 (UI Dashboard)

整個系統在網頁畫面上被劃分為三個主要區塊，利用寬度配置（Grid 系統）實現了「左側表單、右側按鍵、下方看板」的經典佈局：

+-------------------------------------------------------------------------+
|                          學生資料管理系統 (Tab)                          |
+----------------------------------------------------+--------------------+
|                                                    |                    |
|  1. 學生資料輸入欄位 (Group A, 寬度: 8)             | 2. 功能操作快捷鍵  |
|     - 學號、姓名、性別開關(Switch)、                 |    (Group B, 寬度: 4)|
|       出生年次、畢業科系、備註                       |    - 6 個實體按鈕  |
|                                                    |                    |
+----------------------------------------------------+--------------------+
|  3. 資料顯示面板 (Group C, 寬度: 12)                                     |
|     - 學生資料表格 (ui_table)                                            |
+-------------------------------------------------------------------------+

左側：ui_grp_left_form_switch_v2（寬度 8） 容納 6 個輸入元件。特別的是「性別」使用了 ui_switch，開啟傳送 "男"，關閉傳送 "女"。
右側：ui_grp_right_btn_switch_v2（寬度 4） 垂直排列 6 個功能按鈕（建立資料表、新增、更正、刪除、查詢、顯示所有）。
下方：ui_grp_bottom_table_switch_v2（寬度 12） 橫跨整個畫面，用來放置 ui_table 表格，呈現從 SQLite 查詢出來的最新資料。

🔄 二、核心資料流向 (Data Flow)

這個程式的精妙之處在於它解決了網頁表單常見的「即時觸發」問題。它將程序分為「輸入期」與「執行期」：

1. 輸入期：資料即時暫存

當使用者在左側網頁的 6 個輸入框（如學號、姓名）中輸入文字或切換性別時：

每個輸入節點都會發送一個帶有自己 msg.topic（例如 student_id）的事件。
這些事件會流向中間的 Change 節點 「即時暫存欄位資料」。
關鍵邏輯： 它會執行 flow.student_form[msg.topic] = msg.payload，把資料寫入 Node-RED 的 Flow 記憶體環境變數 中。此時完全不觸發資料庫。

2. 執行期：多鍵合一的 SQL 映射

當使用者點擊右側 6 個功能鍵中的任意一個時：

按鈕會發送它專屬的指令標籤（存放於 msg.topic），例如新增按鈕發送 "ADD"，更正按鈕發送 "UPDATE"。
訊號進入核心 Function 節點 「6鍵核心冒號映射邏輯」。

🧠 三、核心 Function 節點邏輯解析 (`func_sw_core_v2`)

這個 Function 節點是全系統的大腦，它負責從 Flow 記憶體中撈出剛剛暫存的 6 個欄位資料，並根據點擊的按鈕（action），利用 JavaScript 的 樣板字串（Template Literals） 動態組裝出純文字的 SQL 命令：

JavaScript
var action = msg.topic;
var form = flow.get("student_form") || {};

// 1. 從記憶體提取 6 個欄位資料，並進行嚴謹的修剪(trim)與防錯預設
var student_id = form.student_id ? form.student_id.trim() : "";
var name = form.name ? form.name.trim() : "";
var gender = form.gender ? form.gender.trim() : "女"; // 若沒動過開關，預設為女
var birth = form.birth_date || "";
var school = form.grad_school ? form.grad_school.trim() : "";
var note = form.note ? form.note.trim() : "";

// 2. 依據按鈕動作，組裝對應的 SQL 語句，並加上單引號防止字串報錯
switch (action) {
    case "CREATE_TABLE":
        msg.topic = `CREATE TABLE IF NOT EXISTS students (...);`;
        break;

    case "ADD":
        // 欄位防空驗證
        if (student_id === "" || name === "") { node.error("..."); return null; }
        // 【已修正】將變數直接安全地嵌入單引號之中
        msg.topic = `INSERT INTO students (...) VALUES ('${student_id}','${name}','${gender}','${birth}','${school}','${note}')`;
        break;

    case "UPDATE":
        // 組合更正字串
        msg.topic = `update students set name='${name}', gender='${gender}', birth_date='${birth}', grad_school='${school}', note='${note}' where student_id='${student_id}'`;
        break;

    case "DELETE":
        msg.topic = `DELETE FROM students where student_id= '${student_id}'`;
        break;

    case "QUERY":
        msg.topic = `SELECT * FROM students where student_id= '${student_id}'`;
        break;

    case "DISPLAY_ALL":
        msg.topic = `SELECT * FROM students ORDER BY student_id ASC;`;
        break;
}
return msg;

🗄️ 四、資料庫與後端顯示 (SQLite & Table)

SQLite 設定節點 (sqlite_config_switch_v2)
- 配置連接到本地的實體資料庫檔案 student.db，模式為 RWC（可讀、可寫、不存在則自動建立）。
SQLite 實體節點 (sqlite_node_switch_v2)
- 它的 SQL Type 被配置為 via msg.topic（即配合 sqlquery: "msg.topic"）。這意味著它會直接接收前面 Function 節點組裝出來的字串命令並在資料庫內執行。
前端表格顯示 (ui_table_switch_v2)
- 當執行的是 QUERY 或 DISPLAY_ALL 時，SQLite 資料庫會回傳一個包含查詢結果的 JSON 陣列物件。
- 此資料流入 ui_table 節點後，表格會依據預設好的 6 個欄頭（學號、姓名、性別、出生年次、畢業科系、備註）自動將資料對齊、渲染並顯示在網頁最下方。

💡 系統優點總結

資料與介面分離：輸入欄位時不會頻繁衝擊資料庫，只有點擊右側功能鍵時才進行單次、精確的資料處理。
字串安全封裝：程式在 SQL 拼接過程中，為每個變數（如 name、school）都外包了單引號 '${name}'，完美解決了 SQLite 之前將中文誤判為 no such column 的錯誤。
高相容性結構：利用 flow context 暫存，即使未來增加第 7、第 8 個科目或成績欄位，也只需要在 Change 節點與核心 Function 節點中擴充變數，整體架構極具彈性。

alex9ufo 聰明人求知心切

2026年6月9日星期二

Node-Red +SQLite <範例1>

💡 核心特性 (Key Features)

1. 嵌入式與伺服器無關 (Serverless)

2. 單一檔案儲存 (Single-File Database)

3. 零配置 (Zero-Configuration)

4. 跨平台與高相容性

5. 動態型別系統 (Manifest Typing)

🛠️ 主要功能 (Major Capabilities)

⚖️ 優缺點與適用場景

🎯 最佳適用場景：

🏗️ 一、系統視覺與佈局架構 (UI Dashboard)

🔄 二、核心資料流向 (Data Flow)

1. 輸入期：資料即時暫存

2. 執行期：多鍵合一的 SQL 映射

🧠 三、核心 Function 節點邏輯解析 (`func_sw_core_v2`)

🗄️ 四、資料庫與後端顯示 (SQLite & Table)

💡 系統優點總結

沒有留言:

張貼留言

Node-Red --> MQTT --> Fuxa 開源碼網頁式圖控平台

2026年6月9日 星期二

Node-Red +SQLite <範例1>

💡 核心特性 (Key Features)

1. 嵌入式與伺服器無關 (Serverless)

2. 單一檔案儲存 (Single-File Database)

3. 零配置 (Zero-Configuration)

4. 跨平台與高相容性

5. 動態型別系統 (Manifest Typing)

🛠️ 主要功能 (Major Capabilities)

⚖️ 優缺點與適用場景

🎯 最佳適用場景：

🏗️ 一、 系統視覺與佈局架構 (UI Dashboard)

🔄 二、 核心資料流向 (Data Flow)

1. 輸入期：資料即時暫存

2. 執行期：多鍵合一的 SQL 映射

🧠 三、 核心 Function 節點邏輯解析 (func_sw_core_v2)

🗄️ 四、 資料庫與後端顯示 (SQLite & Table)

💡 系統優點總結

沒有留言:

張貼留言

Node-Red --> MQTT --> Fuxa 開源碼網頁式圖控平台

2026年6月9日星期二

🏗️ 一、系統視覺與佈局架構 (UI Dashboard)

🔄 二、核心資料流向 (Data Flow)

🧠 三、核心 Function 節點邏輯解析 (`func_sw_core_v2`)

🗄️ 四、資料庫與後端顯示 (SQLite & Table)