全域性自定義表格

# 概述

Global Custom Table（全域性自定義表格）是 Edge Admin 提供的強大功能，允許管理員建立和管理自定義資料表，用於儲存和組織特定的業務資料。該功能提供了靈活的資料結構定義和管理能力，支援多種資料型別和查詢方式。

# 建立全域性自定義表格

# 步驟 1：訪問管理介面

1. 登入 Edge Admin 管理後臺
2. 導航至 全域性配置 > 全域性自定義表格
3. 點選 新建自定義表格 按鈕

# 步驟 2：配置表格基本資訊

# 基本配置

• 表名稱：輸入表的名稱（僅支援英文字母、數字和下劃線，用於系統內部標識）
• 描述：新增表的用途描述，便於後續管理和維護
• 是否傳送事件：當變更表格資料時，是否傳送對應的事件通知到相關係統，通常需與 Edge Admin 的 Lua 外掛配合使用。

# 資料欄位配置

資料欄位是儲存業務資料的核心結構，每個欄位包含以下屬性：

# 支援的欄位型別

# 使用示例

以下透過一個完整的使用者資訊管理示例，演示全域性自定義表格的使用方法。

# 1. 建立使用者資訊表格

建立一個名為 example_users 的使用者資訊表，包含以下欄位：

• username：使用者名稱（文字型別，查詢鍵，唯一）
• age：年齡（數字型別）
• enable：是否啟用（布林值型別）
• ip：IP 地址（IP 地址型別）
• domain：域名（域名型別）
• array：標籤陣列（陣列型別）
• ip_array：IP 地址列表（IP 地址陣列型別）
• domain_array：域名列表（域名陣列型別）

# 2. 新增測試資料

新增一條測試使用者資料：

• 使用者名稱：oredge
• 年齡：10
• 啟用狀態：true
• IP 地址：1.2.3.4
• 域名：openresty.com
• 標籤：["openresty", "edge"]
• IP 列表：["1.2.3.4", "2.3.4.5"]
• 域名列表：["openresty.com", "doc.openresty.com"]

# 3. 建立 Lua 查詢模組

建立一個名為 check_user 的 Lua 模組，用於查詢使用者資訊：

local ct = require("custom_table")
local cjson_encode = require("cjson.safe").encode
local get_uri_args = ngx.req.get_uri_args
local ngx_say = ngx.say

local _M = {}

function _M.go()
    -- 獲取 URI 引數中的使用者名稱
    local uri_args = get_uri_args()
    local username = uri_args.username

    if not username then
        ngx_say("Error: username parameter is required")
        return
    end

    -- 查詢使用者資訊
    local res, err = ct.get("example_users", { username = username })
    if not res then
        ngx_say("Error: ", err or "User Not Found")
        return
    end

    -- 返回使用者資訊
    ngx_say("Hello ", res.username, ", your info: ", cjson_encode(res))
end

return _M

在 Lua 模組中，透過使用 custom_table 模組來獲取自定義資料：

local ct = require("custom_table")
local res, err = ct.get("table_name", { field = "value" })

# 4. 在應用中引用 Lua 模組

在應用的 Edge Language 規則中呼叫 Lua 模組：

true =>
    foreign-call(module: "check_user", func: "go");

# 5. 測試驗證

配置釋出完成後，進行功能測試：

測試 1：查詢存在的使用者

$ curl --resolve oredge-example.com:80:127.0.0.1 'http://oredge-example.com/?username=oredge'
Hello oredge, your info: {"enable":true,"domain_array":["openresty.com","doc.openresty.com"],"ip_array":["1.2.3.4","2.3.4.5"],"username":"oredge","domain":"openresty.com","ip":"1.2.3.4","age":10,"array":["openresty","edge"]}

測試 2：查詢不存在的使用者

$ curl --resolve oredge-example.com:80:127.0.0.1 'http://oredge-example.com/?username=notfound'
Error: User Not Found