fdb2 1.0.33 → 1.0.34

package/dist/server/service/database/clickhouse-connection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ClickHouse 连接封装
+ * ClickHouse 没有官方 TypeORM 驱动，这里直接使用其 HTTP 接口（默认端口 8123）。
+ * 该对象对外暴露与 TypeORM DataSource 类似的最小接口：
+ *   query(sql, params?) / options / isInitialized / destroy()
+ * 以便复用现有 BaseDatabaseService 体系。
+ */
+export declare class ClickHouseConnection {
+    options: any;
+    isInitialized: boolean;
+    private baseUrl;
+    private auth?;
+    private defaultDatabase;
+    private timeout;
+    constructor(connectionConfig: any);
+    /**
+     * 执行 SQL。
+     * - 读查询（SELECT/SHOW/DESCRIBE/EXPLAIN/WITH）返回解析后的行数组（JSONEachRow）。
+     * - 其它（DDL/DML）返回空数组。
+     */
+    query(sql: string, params?: any[]): Promise<any>;
+    /**
+     * 解析 JSONEachRow 单行。
+     * ClickHouse 可能输出 NaN/Infinity（非法 JSON），解析失败时回退为原始字符串。
+     */
+    private static safeParse;
+    /**
+     * 执行查询并返回原始文本（用于导出 CSV/原生格式）。
+     */
+    queryRaw(sql: string, format?: string): Promise<string>;
+    destroy(): Promise<void>;
+    private databasePath;
+    private post;
+    /** 将 SQL 中的 ? 占位符按顺序替换为安全字面量（仅用于服务内部兜底） */
+    private static fillParams;
+    /**
+     * 转义 ClickHouse 字符串字面量。
+     * ClickHouse 字符串中以反斜杠作为转义符：\\ 表示反斜杠，\' 表示单引号，
+     * 不能使用 SQL 标准的双写单引号（''）。
+     */
+    static escapeLiteral(value: any): string;
+    private static escapeString;
+}
+//# sourceMappingURL=clickhouse-connection.d.ts.map

package/dist/server/service/database/clickhouse-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse-connection.d.ts","sourceRoot":"","sources":["../../../../server/service/database/clickhouse-connection.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,qBAAa,oBAAoB;IACxB,OAAO,EAAE,GAAG,CAAC;IACb,aAAa,UAAQ;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,OAAO,CAAS;gBAEZ,gBAAgB,EAAE,GAAG;IA0BjC;;;;OAIG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAsBtD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAgBxB;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,IAAI;IA0CZ,2CAA2C;IAC3C,OAAO,CAAC,MAAM,CAAC,UAAU;IAQzB;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM;IAcxC,OAAO,CAAC,MAAM,CAAC,YAAY;CAG5B"}

package/dist/server/service/database/clickhouse-connection.js

@@ -0,0 +1,210 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClickHouseConnection = void 0;
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
+const url = __importStar(require("url"));
+/**
+ * ClickHouse 连接封装
+ * ClickHouse 没有官方 TypeORM 驱动，这里直接使用其 HTTP 接口（默认端口 8123）。
+ * 该对象对外暴露与 TypeORM DataSource 类似的最小接口：
+ *   query(sql, params?) / options / isInitialized / destroy()
+ * 以便复用现有 BaseDatabaseService 体系。
+ */
+class ClickHouseConnection {
+    options;
+    isInitialized = true;
+    baseUrl;
+    auth;
+    defaultDatabase;
+    timeout;
+    constructor(connectionConfig) {
+        const config = connectionConfig || {};
+        const secure = !!(config.options && (config.options.secure || config.options.ssl));
+        const proto = secure ? 'https' : 'http';
+        const host = config.host || 'localhost';
+        const port = config.port || 8123;
+        this.baseUrl = `${proto}://${host}:${port}`;
+        this.defaultDatabase = config.database && config.database !== 'default' ? config.database : 'default';
+        this.timeout = Number((config.options && config.options.requestTimeout) || 30000);
+        this.options = {
+            type: 'clickhouse',
+            host,
+            port,
+            username: config.username,
+            password: config.password,
+            database: config.database || this.defaultDatabase,
+            ...(config.options || {})
+        };
+        // ClickHouse 默认用户为 default；即使未填用户名也应携带鉴权头
+        const username = config.username || 'default';
+        const token = Buffer.from(`${username}:${config.password || ''}`).toString('base64');
+        this.auth = `Basic ${token}`;
+    }
+    /**
+     * 执行 SQL。
+     * - 读查询（SELECT/SHOW/DESCRIBE/EXPLAIN/WITH）返回解析后的行数组（JSONEachRow）。
+     * - 其它（DDL/DML）返回空数组。
+     */
+    async query(sql, params) {
+        let finalSql = sql;
+        if (params && params.length) {
+            finalSql = ClickHouseConnection.fillParams(sql, params);
+        }
+        const isRead = /^\s*(select|with|show|describe|desc|explain|exists|use)\b/i.test(finalSql);
+        if (isRead) {
+            // 去掉结尾分号，避免 "...; FORMAT ..." 语法错误
+            const cleanSql = finalSql.replace(/;\s*$/, '');
+            // 使用 JSONStringsEachRow：所有值均以字符串返回，避免 UInt64 等超出 JS 安全整数范围导致精度丢失
+            const text = await this.post(`${cleanSql} FORMAT JSONStringsEachRow`);
+            if (!text || !text.trim())
+                return [];
+            return text
+                .split('\n')
+                .map((line) => line.trim())
+                .filter((line) => line.length > 0)
+                .map((line) => ClickHouseConnection.safeParse(line));
+        }
+        await this.post(finalSql);
+        return [];
+    }
+    /**
+     * 解析 JSONEachRow 单行。
+     * ClickHouse 可能输出 NaN/Infinity（非法 JSON），解析失败时回退为原始字符串。
+     */
+    static safeParse(line) {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            try {
+                const normalized = line
+                    .replace(/:\s*NaN/g, ': null')
+                    .replace(/:\s*Infinity/g, ': null')
+                    .replace(/:\s*-Infinity/g, ': null');
+                return JSON.parse(normalized);
+            }
+            catch {
+                return line;
+            }
+        }
+    }
+    /**
+     * 执行查询并返回原始文本（用于导出 CSV/原生格式）。
+     */
+    async queryRaw(sql, format = 'CSVWithNames') {
+        return this.post(`${sql.replace(/;\s*$/, '')} FORMAT ${format}`);
+    }
+    async destroy() {
+        this.isInitialized = false;
+    }
+    databasePath() {
+        return `/?database=${encodeURIComponent(this.defaultDatabase)}`;
+    }
+    post(body) {
+        return new Promise((resolve, reject) => {
+            const parsed = url.parse(this.baseUrl);
+            const data = Buffer.from(body, 'utf8');
+            const headers = {
+                'Content-Type': 'text/plain; charset=utf-8',
+                'Content-Length': data.length
+            };
+            if (this.auth)
+                headers['Authorization'] = this.auth;
+            const lib = parsed.protocol === 'https:' ? https : http;
+            const req = lib.request({
+                hostname: parsed.hostname,
+                port: parsed.port,
+                path: this.databasePath(),
+                method: 'POST',
+                headers
+            }, (res) => {
+                const chunks = [];
+                res.on('data', (c) => chunks.push(c));
+                res.on('end', () => {
+                    const text = Buffer.concat(chunks).toString('utf8');
+                    const status = res.statusCode || 0;
+                    if (status >= 400) {
+                        reject(new Error(`ClickHouse 错误 (${status}): ${text.trim()}`));
+                    }
+                    else {
+                        resolve(text);
+                    }
+                });
+            });
+            req.on('error', (err) => reject(err));
+            req.setTimeout(this.timeout, () => {
+                req.destroy(new Error(`ClickHouse 请求超时（${this.timeout}ms）`));
+            });
+            req.write(data);
+            req.end();
+        });
+    }
+    /** 将 SQL 中的 ? 占位符按顺序替换为安全字面量（仅用于服务内部兜底） */
+    static fillParams(sql, params) {
+        let i = 0;
+        return sql.replace(/\?/g, () => {
+            const v = params[i++];
+            return ClickHouseConnection.escapeLiteral(v);
+        });
+    }
+    /**
+     * 转义 ClickHouse 字符串字面量。
+     * ClickHouse 字符串中以反斜杠作为转义符：\\ 表示反斜杠，\' 表示单引号，
+     * 不能使用 SQL 标准的双写单引号（''）。
+     */
+    static escapeLiteral(value) {
+        if (value === null || value === undefined)
+            return 'NULL';
+        if (typeof value === 'number')
+            return String(value);
+        if (typeof value === 'boolean')
+            return value ? 'true' : 'false';
+        if (value instanceof Date) {
+            const s = value.toISOString().slice(0, 19).replace('T', ' ');
+            return `'${ClickHouseConnection.escapeString(s)}'`;
+        }
+        if (typeof value === 'object') {
+            return `'${ClickHouseConnection.escapeString(JSON.stringify(value))}'`;
+        }
+        return `'${ClickHouseConnection.escapeString(String(value))}'`;
+    }
+    static escapeString(s) {
+        return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    }
+}
+exports.ClickHouseConnection = ClickHouseConnection;
+//# sourceMappingURL=clickhouse-connection.js.map

package/dist/server/service/database/clickhouse-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse-connection.js","sourceRoot":"","sources":["../../../../server/service/database/clickhouse-connection.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAC7B,6CAA+B;AAC/B,yCAA2B;AAE3B;;;;;;GAMG;AACH,MAAa,oBAAoB;IACxB,OAAO,CAAM;IACb,aAAa,GAAG,IAAI,CAAC;IACpB,OAAO,CAAS;IAChB,IAAI,CAAU;IACd,eAAe,CAAS;IAExB,OAAO,CAAS;IAExB,YAAY,gBAAqB;QAC/B,MAAM,MAAM,GAAG,gBAAgB,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACnF,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,GAAG,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACtG,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,CAAC;QAElF,IAAI,CAAC,OAAO,GAAG;YACb,IAAI,EAAE,YAAY;YAClB,IAAI;YACJ,IAAI;YACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,eAAe;YACjD,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;SAC1B,CAAC;QAEF,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,SAAS,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,MAAc;QACrC,IAAI,QAAQ,GAAG,GAAG,CAAC;QACnB,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC5B,QAAQ,GAAG,oBAAoB,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,MAAM,GAAG,4DAA4D,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3F,IAAI,MAAM,EAAE,CAAC;YACX,mCAAmC;YACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/C,iEAAiE;YACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,4BAA4B,CAAC,CAAC;YACtE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,OAAO,EAAE,CAAC;YACrC,OAAO,IAAI;iBACR,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;iBAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;iBACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,SAAS,CAAC,IAAY;QACnC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI;qBACpB,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;qBAC7B,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC;qBAClC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;gBACvC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,SAAiB,cAAc;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC7B,CAAC;IAEO,YAAY;QAClB,OAAO,cAAc,kBAAkB,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;IAClE,CAAC;IAEO,IAAI,CAAC,IAAY;QACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACvC,MAAM,OAAO,GAAwB;gBACnC,cAAc,EAAE,2BAA2B;gBAC3C,gBAAgB,EAAE,IAAI,CAAC,MAAM;aAC9B,CAAC;YACF,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YAEpD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACxD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CACrB;gBACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE;gBACzB,MAAM,EAAE,MAAM;gBACd,OAAO;aACR,EACD,CAAC,GAAG,EAAE,EAAE;gBACN,MAAM,MAAM,GAAa,EAAE,CAAC;gBAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACpD,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;oBACnC,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;wBAClB,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,MAAM,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;oBACjE,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CACF,CAAC;YACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBAChC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChB,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2CAA2C;IACnC,MAAM,CAAC,UAAU,CAAC,GAAW,EAAE,MAAa;QAClD,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE;YAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;YACtB,OAAO,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,KAAU;QAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAChE,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC7D,OAAO,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,oBAAoB,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,oBAAoB,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;IACjE,CAAC;IAEO,MAAM,CAAC,YAAY,CAAC,CAAS;QACnC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;CACF;AA1KD,oDA0KC"}

package/dist/server/service/database/clickhouse-connection.ts

@@ -0,0 +1,182 @@
+import * as http from 'http';
+import * as https from 'https';
+import * as url from 'url';
+
+/**
+ * ClickHouse 连接封装
+ * ClickHouse 没有官方 TypeORM 驱动，这里直接使用其 HTTP 接口（默认端口 8123）。
+ * 该对象对外暴露与 TypeORM DataSource 类似的最小接口：
+ *   query(sql, params?) / options / isInitialized / destroy()
+ * 以便复用现有 BaseDatabaseService 体系。
+ */
+export class ClickHouseConnection {
+  public options: any;
+  public isInitialized = true;
+  private baseUrl: string;
+  private auth?: string;
+  private defaultDatabase: string;
+
+  private timeout: number;
+
+  constructor(connectionConfig: any) {
+    const config = connectionConfig || {};
+    const secure = !!(config.options && (config.options.secure || config.options.ssl));
+    const proto = secure ? 'https' : 'http';
+    const host = config.host || 'localhost';
+    const port = config.port || 8123;
+    this.baseUrl = `${proto}://${host}:${port}`;
+    this.defaultDatabase = config.database && config.database !== 'default' ? config.database : 'default';
+    this.timeout = Number((config.options && config.options.requestTimeout) || 30000);
+
+    this.options = {
+      type: 'clickhouse',
+      host,
+      port,
+      username: config.username,
+      password: config.password,
+      database: config.database || this.defaultDatabase,
+      ...(config.options || {})
+    };
+
+    // ClickHouse 默认用户为 default；即使未填用户名也应携带鉴权头
+    const username = config.username || 'default';
+    const token = Buffer.from(`${username}:${config.password || ''}`).toString('base64');
+    this.auth = `Basic ${token}`;
+  }
+
+  /**
+   * 执行 SQL。
+   * - 读查询（SELECT/SHOW/DESCRIBE/EXPLAIN/WITH）返回解析后的行数组（JSONEachRow）。
+   * - 其它（DDL/DML）返回空数组。
+   */
+  async query(sql: string, params?: any[]): Promise<any> {
+    let finalSql = sql;
+    if (params && params.length) {
+      finalSql = ClickHouseConnection.fillParams(sql, params);
+    }
+    const isRead = /^\s*(select|with|show|describe|desc|explain|exists|use)\b/i.test(finalSql);
+    if (isRead) {
+      // 去掉结尾分号，避免 "...; FORMAT ..." 语法错误
+      const cleanSql = finalSql.replace(/;\s*$/, '');
+      // 使用 JSONStringsEachRow：所有值均以字符串返回，避免 UInt64 等超出 JS 安全整数范围导致精度丢失
+      const text = await this.post(`${cleanSql} FORMAT JSONStringsEachRow`);
+      if (!text || !text.trim()) return [];
+      return text
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .map((line) => ClickHouseConnection.safeParse(line));
+    }
+    await this.post(finalSql);
+    return [];
+  }
+
+  /**
+   * 解析 JSONEachRow 单行。
+   * ClickHouse 可能输出 NaN/Infinity（非法 JSON），解析失败时回退为原始字符串。
+   */
+  private static safeParse(line: string): any {
+    try {
+      return JSON.parse(line);
+    } catch {
+      try {
+        const normalized = line
+          .replace(/:\s*NaN/g, ': null')
+          .replace(/:\s*Infinity/g, ': null')
+          .replace(/:\s*-Infinity/g, ': null');
+        return JSON.parse(normalized);
+      } catch {
+        return line;
+      }
+    }
+  }
+
+  /**
+   * 执行查询并返回原始文本（用于导出 CSV/原生格式）。
+   */
+  async queryRaw(sql: string, format: string = 'CSVWithNames'): Promise<string> {
+    return this.post(`${sql.replace(/;\s*$/, '')} FORMAT ${format}`);
+  }
+
+  async destroy(): Promise<void> {
+    this.isInitialized = false;
+  }
+
+  private databasePath(): string {
+    return `/?database=${encodeURIComponent(this.defaultDatabase)}`;
+  }
+
+  private post(body: string): Promise<string> {
+    return new Promise((resolve, reject) => {
+      const parsed = url.parse(this.baseUrl);
+      const data = Buffer.from(body, 'utf8');
+      const headers: Record<string, any> = {
+        'Content-Type': 'text/plain; charset=utf-8',
+        'Content-Length': data.length
+      };
+      if (this.auth) headers['Authorization'] = this.auth;
+
+      const lib = parsed.protocol === 'https:' ? https : http;
+      const req = lib.request(
+        {
+          hostname: parsed.hostname,
+          port: parsed.port,
+          path: this.databasePath(),
+          method: 'POST',
+          headers
+        },
+        (res) => {
+          const chunks: Buffer[] = [];
+          res.on('data', (c: Buffer) => chunks.push(c));
+          res.on('end', () => {
+            const text = Buffer.concat(chunks).toString('utf8');
+            const status = res.statusCode || 0;
+            if (status >= 400) {
+              reject(new Error(`ClickHouse 错误 (${status}): ${text.trim()}`));
+            } else {
+              resolve(text);
+            }
+          });
+        }
+      );
+      req.on('error', (err) => reject(err));
+      req.setTimeout(this.timeout, () => {
+        req.destroy(new Error(`ClickHouse 请求超时（${this.timeout}ms）`));
+      });
+      req.write(data);
+      req.end();
+    });
+  }
+
+  /** 将 SQL 中的 ? 占位符按顺序替换为安全字面量（仅用于服务内部兜底） */
+  private static fillParams(sql: string, params: any[]): string {
+    let i = 0;
+    return sql.replace(/\?/g, () => {
+      const v = params[i++];
+      return ClickHouseConnection.escapeLiteral(v);
+    });
+  }
+
+  /**
+   * 转义 ClickHouse 字符串字面量。
+   * ClickHouse 字符串中以反斜杠作为转义符：\\ 表示反斜杠，\' 表示单引号，
+   * 不能使用 SQL 标准的双写单引号（''）。
+   */
+  static escapeLiteral(value: any): string {
+    if (value === null || value === undefined) return 'NULL';
+    if (typeof value === 'number') return String(value);
+    if (typeof value === 'boolean') return value ? 'true' : 'false';
+    if (value instanceof Date) {
+      const s = value.toISOString().slice(0, 19).replace('T', ' ');
+      return `'${ClickHouseConnection.escapeString(s)}'`;
+    }
+    if (typeof value === 'object') {
+      return `'${ClickHouseConnection.escapeString(JSON.stringify(value))}'`;
+    }
+    return `'${ClickHouseConnection.escapeString(String(value))}'`;
+  }
+
+  private static escapeString(s: string): string {
+    return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+  }
+}

package/dist/server/service/database/clickhouse.service.d.ts

@@ -0,0 +1,138 @@
+import { DataSource } from 'typeorm';
+import { BaseDatabaseService } from './base.service';
+import { TableEntity, ColumnEntity, IndexEntity, ForeignKeyEntity } from '../../model/database.entity';
+/**
+ * ClickHouse数据库服务实现
+ * ClickHouse 是列式 OLAP 数据库，使用 HTTP 接口（默认 8123）。
+ * 注意：ClickHouse 不支持事务、外键、存储过程，主键通过 ORDER BY 体现。
+ */
+export declare class ClickHouseService extends BaseDatabaseService {
+    getDatabaseType(): string;
+    private escape;
+    /**
+     * 获取ClickHouse数据库列表
+     */
+    getDatabases(dataSource: DataSource): Promise<string[]>;
+    /**
+     * 获取ClickHouse表/视图列表
+     */
+    getTables(dataSource: DataSource, database: string): Promise<TableEntity[]>;
+    /**
+     * 获取表数据（分页）。
+     * 必须使用 `库`.`表` 限定名，因为连接默认库可能与目标库不同。
+     */
+    getTableData(dataSource: DataSource, databaseName: string, tableName: string, page?: number, pageSize?: number, where?: string, orderBy?: string): Promise<{
+        data: any[];
+        total: number;
+    }>;
+    /**
+     * 获取ClickHouse列信息
+     */
+    getColumns(dataSource: DataSource, database: string, table: string): Promise<ColumnEntity[]>;
+    /**
+     * 获取ClickHouse索引信息（主键 + 数据跳数索引）
+     */
+    getIndexes(dataSource: DataSource, database: string, table: string): Promise<IndexEntity[]>;
+    /**
+     * ClickHouse不支持外键
+     */
+    getForeignKeys(dataSource: DataSource, database: string, table: string): Promise<ForeignKeyEntity[]>;
+    /**
+     * 获取ClickHouse数据库大小
+     */
+    getDatabaseSize(dataSource: DataSource, database: string): Promise<number>;
+    /**
+     * 获取ClickHouse视图列表
+     */
+    getViews(dataSource: DataSource, database: string): Promise<any[]>;
+    /**
+     * 获取ClickHouse视图定义
+     */
+    getViewDefinition(dataSource: DataSource, database: string, viewName: string): Promise<string>;
+    /**
+     * ClickHouse不支持存储过程
+     */
+    getProcedures(dataSource: DataSource, database: string): Promise<any[]>;
+    getProcedureDefinition(dataSource: DataSource, database: string, procedureName: string): Promise<string>;
+    /**
+     * 创建ClickHouse数据库
+     */
+    createDatabase(dataSource: DataSource, databaseName: string, options?: any): Promise<void>;
+    /**
+     * 删除ClickHouse数据库
+     */
+    dropDatabase(dataSource: DataSource, databaseName: string): Promise<void>;
+    /**
+     * 导出数据库架构
+     */
+    exportSchema(dataSource: DataSource, databaseName: string): Promise<string>;
+    /**
+     * 查看ClickHouse日志（query_log，可能未开启）
+     */
+    viewLogs(dataSource: DataSource, database?: string, limit?: number): Promise<any[]>;
+    /**
+     * 备份ClickHouse数据库
+     */
+    backupDatabase(dataSource: DataSource, databaseName: string, options?: any): Promise<string>;
+    /**
+     * 将单表数据以 INSERT 语句追加到备份文件中。
+     * 使用 JSONStringsEachRow（见连接封装），UInt64 等大整数以字符串形式安全导出。
+     */
+    private appendTableData;
+    /**
+     * 将 SQL 文本拆分为语句，正确处理单/双引号、反引号标识符与 -- /* 注释中的分号。
+     */
+    private static splitSqlStatements;
+    /**
+     * 恢复ClickHouse数据库
+     */
+    restoreDatabase(dataSource: DataSource, databaseName: string, filePath: string, options?: any): Promise<void>;
+    /**
+     * 导出表数据到 SQL 文件
+     */
+    exportTableDataToSQL(dataSource: DataSource, databaseName: string, tableName: string, options?: any): Promise<string>;
+    /**
+     * 导出表数据到 CSV 文件
+     */
+    exportTableDataToCSV(dataSource: DataSource, databaseName: string, tableName: string, options?: any): Promise<string>;
+    /**
+     * 导出表数据到 JSON 文件
+     */
+    exportTableDataToJSON(dataSource: DataSource, databaseName: string, tableName: string, options?: any): Promise<string>;
+    /**
+     * 导出表数据到 Excel 文件
+     */
+    exportTableDataToExcel(dataSource: DataSource, databaseName: string, tableName: string, options?: any): Promise<string>;
+    /**
+     * ClickHouse使用反引号作为标识符
+     */
+    quoteIdentifier(identifier: string): string;
+    /**
+     * 解析列类型：可空且类型本身不是 Nullable(...) 时包装 Nullable；
+     * 不附加 NOT NULL，避免与 Nullable(...) 冲突（ClickHouse 默认即非空）。
+     */
+    private resolveColumnType;
+    /**
+     * 修改表结构
+     * ClickHouse支持 ADD/MODIFY/DROP/COMMENT COLUMN，但不支持事务。
+     */
+    alterTable(dataSource: DataSource, databaseName: string, tableDiff: any): Promise<any>;
+    /**
+     * 批量插入数据
+     */
+    bulkInsert(dataSource: DataSource, databaseName: string, tableName: string, data: any[]): Promise<void>;
+    /**
+     * 插入单条数据
+     */
+    insertData(dataSource: DataSource, databaseName: string, tableName: string, data: any): Promise<void>;
+    /**
+     * 删除表
+     */
+    dropTable(dataSource: DataSource, databaseName: string, tableName: string): Promise<void>;
+    /**
+     * 创建表
+     * ClickHouse要求指定 ENGINE，默认使用 MergeTree。
+     */
+    createTable(dataSource: DataSource, databaseName: string, table: any): Promise<void>;
+}
+//# sourceMappingURL=clickhouse.service.d.ts.map

package/dist/server/service/database/clickhouse.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.service.d.ts","sourceRoot":"","sources":["../../../../server/service/database/clickhouse.service.ts"],"names":[],"mappings":"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"}