@yydb/light-db 0.0.0

package/dist/performance/index.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * 性能优化模块
+ * 提供列式存储、二进制序列化优化、异步批量写入、读写锁和惰性求值查询
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneratorUtils =
+    exports.lazyIterator =
+    exports.lazy =
+    exports.LazyQueryBuilder =
+    exports.LazyQueryIterator =
+    exports.ReentrantRWLock =
+    exports.RWLockManager =
+    exports.RWLock =
+    exports.WriteLockHandle =
+    exports.ReadLockHandle =
+    exports.BatchWriteManager =
+    exports.BatchWalWriter =
+    exports.BufferConcatenator =
+    exports.FastSerializer =
+    exports.OptimizedBufferReader =
+    exports.OptimizedBufferWriter =
+    exports.getGlobalBufferPool =
+    exports.BufferPool =
+    exports.ColumnarStorage =
+    exports.ColumnType =
+        void 0;
+// 类型导出
+var types_1 = require("./types");
+Object.defineProperty(exports, "ColumnType", {
+    enumerable: true,
+    get: function () {
+        return types_1.ColumnType;
+    },
+});
+// 列式存储导出
+var ColumnarStorage_1 = require("./ColumnarStorage");
+Object.defineProperty(exports, "ColumnarStorage", {
+    enumerable: true,
+    get: function () {
+        return ColumnarStorage_1.ColumnarStorage;
+    },
+});
+// 二进制序列化优化导出
+var OptimizedBuffer_1 = require("./OptimizedBuffer");
+Object.defineProperty(exports, "BufferPool", {
+    enumerable: true,
+    get: function () {
+        return OptimizedBuffer_1.BufferPool;
+    },
+});
+Object.defineProperty(exports, "getGlobalBufferPool", {
+    enumerable: true,
+    get: function () {
+        return OptimizedBuffer_1.getGlobalBufferPool;
+    },
+});
+Object.defineProperty(exports, "OptimizedBufferWriter", {
+    enumerable: true,
+    get: function () {
+        return OptimizedBuffer_1.OptimizedBufferWriter;
+    },
+});
+Object.defineProperty(exports, "OptimizedBufferReader", {
+    enumerable: true,
+    get: function () {
+        return OptimizedBuffer_1.OptimizedBufferReader;
+    },
+});
+Object.defineProperty(exports, "FastSerializer", {
+    enumerable: true,
+    get: function () {
+        return OptimizedBuffer_1.FastSerializer;
+    },
+});
+Object.defineProperty(exports, "BufferConcatenator", {
+    enumerable: true,
+    get: function () {
+        return OptimizedBuffer_1.BufferConcatenator;
+    },
+});
+// 异步批量写入导出
+var BatchWalWriter_1 = require("./BatchWalWriter");
+Object.defineProperty(exports, "BatchWalWriter", {
+    enumerable: true,
+    get: function () {
+        return BatchWalWriter_1.BatchWalWriter;
+    },
+});
+Object.defineProperty(exports, "BatchWriteManager", {
+    enumerable: true,
+    get: function () {
+        return BatchWalWriter_1.BatchWriteManager;
+    },
+});
+// 读写锁导出
+var RWLock_1 = require("./RWLock");
+Object.defineProperty(exports, "ReadLockHandle", {
+    enumerable: true,
+    get: function () {
+        return RWLock_1.ReadLockHandle;
+    },
+});
+Object.defineProperty(exports, "WriteLockHandle", {
+    enumerable: true,
+    get: function () {
+        return RWLock_1.WriteLockHandle;
+    },
+});
+Object.defineProperty(exports, "RWLock", {
+    enumerable: true,
+    get: function () {
+        return RWLock_1.RWLock;
+    },
+});
+Object.defineProperty(exports, "RWLockManager", {
+    enumerable: true,
+    get: function () {
+        return RWLock_1.RWLockManager;
+    },
+});
+Object.defineProperty(exports, "ReentrantRWLock", {
+    enumerable: true,
+    get: function () {
+        return RWLock_1.ReentrantRWLock;
+    },
+});
+// 惰性求值查询导出
+var LazyQuery_1 = require("./LazyQuery");
+Object.defineProperty(exports, "LazyQueryIterator", {
+    enumerable: true,
+    get: function () {
+        return LazyQuery_1.LazyQueryIterator;
+    },
+});
+Object.defineProperty(exports, "LazyQueryBuilder", {
+    enumerable: true,
+    get: function () {
+        return LazyQuery_1.LazyQueryBuilder;
+    },
+});
+Object.defineProperty(exports, "lazy", {
+    enumerable: true,
+    get: function () {
+        return LazyQuery_1.lazy;
+    },
+});
+Object.defineProperty(exports, "lazyIterator", {
+    enumerable: true,
+    get: function () {
+        return LazyQuery_1.lazyIterator;
+    },
+});
+Object.defineProperty(exports, "GeneratorUtils", {
+    enumerable: true,
+    get: function () {
+        return LazyQuery_1.GeneratorUtils;
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/performance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/performance/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,OAAO;AACP,iCAqBiB;AApBb,mGAAA,UAAU,OAAA;AAsBd,SAAS;AACT,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAExB,aAAa;AACb,qDAO2B;AANvB,6GAAA,UAAU,OAAA;AACV,sHAAA,mBAAmB,OAAA;AACnB,wHAAA,qBAAqB,OAAA;AACrB,wHAAA,qBAAqB,OAAA;AACrB,iHAAA,cAAc,OAAA;AACd,qHAAA,kBAAkB,OAAA;AAGtB,WAAW;AACX,mDAI0B;AAFtB,gHAAA,cAAc,OAAA;AACd,mHAAA,iBAAiB,OAAA;AAGrB,QAAQ;AACR,mCAMkB;AALd,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,gGAAA,MAAM,OAAA;AACN,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AAGnB,WAAW;AACX,yCAMqB;AALjB,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,iGAAA,IAAI,OAAA;AACJ,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA"}

package/dist/performance/types.d.ts

@@ -0,0 +1,247 @@
+/**
+ * 性能优化模块类型定义
+ * 包含列式存储、批量写入、读写锁等组件的类型定义
+ */
+/**
+ * 列类型枚举
+ */
+export declare enum ColumnType {
+    Int8 = "int8",
+    Int16 = "int16",
+    Int32 = "int32",
+    Int64 = "int64",
+    UInt8 = "uint8",
+    UInt16 = "uint16",
+    UInt32 = "uint32",
+    UInt64 = "uint64",
+    Float32 = "float32",
+    Float64 = "float64",
+    String = "string",
+    Boolean = "boolean",
+}
+/**
+ * 列定义接口
+ */
+export interface ColumnDefinition {
+    /** 列名称 */
+    name: string;
+    /** 列类型 */
+    type: ColumnType;
+    /** 是否可为空 */
+    nullable?: boolean;
+}
+/**
+ * 列式存储配置
+ */
+export interface ColumnarStorageOptions {
+    /** 列定义列表 */
+    columns: ColumnDefinition[];
+    /** 初始容量 */
+    initialCapacity?: number;
+    /** 是否自动扩容 */
+    autoGrow?: boolean;
+}
+/**
+ * 列式存储统计信息
+ */
+export interface ColumnarStorageStats {
+    /** 列数量 */
+    columnCount: number;
+    /** 行数量 */
+    rowCount: number;
+    /** 内存使用量（字节） */
+    memoryUsage: number;
+    /** 列统计信息 */
+    columns: ColumnStats[];
+}
+/**
+ * 列统计信息
+ */
+export interface ColumnStats {
+    /** 列名称 */
+    name: string;
+    /** 列类型 */
+    type: ColumnType;
+    /** 非空值数量 */
+    nonNullCount: number;
+    /** 内存使用量（字节） */
+    memoryUsage: number;
+}
+/**
+ * 批量写入配置
+ */
+export interface BatchWriteOptions {
+    /** 批量大小阈值（记录数） */
+    batchSize?: number;
+    /** 刷新间隔（毫秒） */
+    flushIntervalMs?: number;
+    /** fsync 策略 */
+    fsyncStrategy?: FsyncStrategyType;
+    /** fsync 批量大小 */
+    fsyncBatchSize?: number;
+    /** fsync 间隔（毫秒） */
+    fsyncIntervalMs?: number;
+}
+/**
+ * fsync 策略类型
+ */
+export type FsyncStrategyType = "always" | "batch" | "interval" | "manual";
+/**
+ * 批量写入统计信息
+ */
+export interface BatchWriteStats {
+    /** 待写入记录数 */
+    pendingCount: number;
+    /** 已写入记录数 */
+    writtenCount: number;
+    /** 上次刷新时间 */
+    lastFlushTime: number;
+    /** 上次 fsync 时间 */
+    lastFsyncTime: number;
+    /** 队列容量 */
+    queueCapacity: number;
+}
+/**
+ * 批量写入结果
+ */
+export interface BatchFlushResult {
+    /** 成功写入的记录数 */
+    recordsWritten: number;
+    /** 写入字节数 */
+    bytesWritten: number;
+    /** 刷新耗时（毫秒） */
+    durationMs: number;
+    /** 是否执行了 fsync */
+    fsynced: boolean;
+}
+/**
+ * 读写锁配置
+ */
+export interface RWLockOptions {
+    /** 最大等待时间（毫秒），0 表示无限等待 */
+    timeout?: number;
+    /** 是否启用公平模式 */
+    fair?: boolean;
+}
+/**
+ * 读写锁统计信息
+ */
+export interface RWLockStats {
+    /** 当前读锁持有者数量 */
+    readLockCount: number;
+    /** 当前写锁持有者数量（0 或 1） */
+    writeLockCount: number;
+    /** 等待读锁的数量 */
+    pendingReadCount: number;
+    /** 等待写锁的数量 */
+    pendingWriteCount: number;
+    /** 总读锁获取次数 */
+    totalReadAcquires: number;
+    /** 总写锁获取次数 */
+    totalWriteAcquires: number;
+}
+/**
+ * 惰性查询配置
+ */
+export interface LazyQueryOptions {
+    /** 是否启用索引优化 */
+    useIndex?: boolean;
+    /** 预取大小 */
+    prefetchSize?: number;
+}
+/**
+ * 惰性查询统计信息
+ */
+export interface LazyQueryStats {
+    /** 已迭代元素数量 */
+    iteratedCount: number;
+    /** 是否已完成 */
+    completed: boolean;
+    /** 是否使用了索引 */
+    usedIndex: boolean;
+    /** 索引名称 */
+    indexName?: string;
+}
+/**
+ * 聚合操作类型
+ */
+export type AggregationType = "sum" | "avg" | "min" | "max" | "count" | "countDistinct";
+/**
+ * 聚合结果
+ */
+export interface AggregationResult {
+    /** 聚合类型 */
+    type: AggregationType;
+    /** 字段名称 */
+    field: string;
+    /** 聚合值 */
+    value: number | bigint | null;
+    /** 计算的记录数 */
+    recordCount: number;
+}
+/**
+ * 范围查询条件
+ */
+export interface RangeCondition<T = unknown> {
+    /** 大于 */
+    gt?: T;
+    /** 大于等于 */
+    gte?: T;
+    /** 小于 */
+    lt?: T;
+    /** 小于等于 */
+    lte?: T;
+}
+/**
+ * Buffer 池配置
+ */
+export interface BufferPoolOptions {
+    /** 池大小 */
+    poolSize?: number;
+    /** 块大小 */
+    chunkSize?: number;
+    /** 是否启用预分配 */
+    preallocate?: boolean;
+}
+/**
+ * Buffer 池统计信息
+ */
+export interface BufferPoolStats {
+    /** 总块数 */
+    totalChunks: number;
+    /** 可用块数 */
+    availableChunks: number;
+    /** 已使用块数 */
+    usedChunks: number;
+    /** 总内存（字节） */
+    totalMemory: number;
+    /** 使用内存（字节） */
+    usedMemory: number;
+}
+/**
+ * 性能优化模块配置
+ */
+export interface PerformanceOptions {
+    /** 列式存储配置 */
+    columnarStorage?: ColumnarStorageOptions;
+    /** 批量写入配置 */
+    batchWrite?: BatchWriteOptions;
+    /** 读写锁配置 */
+    rwLock?: RWLockOptions;
+    /** Buffer 池配置 */
+    bufferPool?: BufferPoolOptions;
+}
+/**
+ * 性能优化统计信息
+ */
+export interface PerformanceStats {
+    /** 列式存储统计 */
+    columnarStorage?: ColumnarStorageStats;
+    /** 批量写入统计 */
+    batchWrite?: BatchWriteStats;
+    /** 读写锁统计 */
+    rwLock?: RWLockStats;
+    /** Buffer 池统计 */
+    bufferPool?: BufferPoolStats;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/performance/types.d.ts.map

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

package/dist/performance/types.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * 性能优化模块类型定义
+ * 包含列式存储、批量写入、读写锁等组件的类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColumnType = void 0;
+/**
+ * 列类型枚举
+ */
+var ColumnType;
+(function (ColumnType) {
+    ColumnType["Int8"] = "int8";
+    ColumnType["Int16"] = "int16";
+    ColumnType["Int32"] = "int32";
+    ColumnType["Int64"] = "int64";
+    ColumnType["UInt8"] = "uint8";
+    ColumnType["UInt16"] = "uint16";
+    ColumnType["UInt32"] = "uint32";
+    ColumnType["UInt64"] = "uint64";
+    ColumnType["Float32"] = "float32";
+    ColumnType["Float64"] = "float64";
+    ColumnType["String"] = "string";
+    ColumnType["Boolean"] = "boolean";
+})(ColumnType || (exports.ColumnType = ColumnType = {}));
+//# sourceMappingURL=types.js.map

package/dist/performance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/performance/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;GAEG;AACH,IAAY,UAaX;AAbD,WAAY,UAAU;IAClB,2BAAa,CAAA;IACb,6BAAe,CAAA;IACf,6BAAe,CAAA;IACf,6BAAe,CAAA;IACf,6BAAe,CAAA;IACf,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;AACvB,CAAC,EAbW,UAAU,0BAAV,UAAU,QAarB"}

package/dist/storage/Checkpoint.d.ts

@@ -0,0 +1,128 @@
+/**
+ * 检查点（Checkpoint）机制实现
+ * 将内存中的完整数据原子性写入新的 .light 文件
+ */
+import { CheckpointResult, RecordMap } from "../types";
+import { LightFileManager, PageManager } from "./LightFile";
+import { WalManager } from "./WALFile";
+import { WalIndexManager } from "./SHMFile";
+/**
+ * 检查点配置选项
+ */
+export interface CheckpointOptions {
+    /** 是否强制执行检查点（忽略阈值检查） */
+    force?: boolean;
+    /** 是否同步等待检查点完成 */
+    sync?: boolean;
+}
+/**
+ * 检查点管理器
+ * 负责管理检查点的创建和协调
+ */
+export declare class CheckpointManager {
+    private readonly lightFileManager;
+    private readonly walManager;
+    private readonly walIndexManager;
+    private readonly pageManager;
+    private readonly walThreshold;
+    private lastCheckpointTime;
+    private checkpointInProgress;
+    /**
+     * 创建检查点管理器
+     * @param lightFileManager Light 文件管理器
+     * @param walManager WAL 管理器
+     * @param walIndexManager WAL 索引管理器
+     * @param pageManager 页面管理器
+     * @param walThreshold WAL 文件大小阈值
+     */
+    constructor(
+        lightFileManager: LightFileManager,
+        walManager: WalManager,
+        walIndexManager: WalIndexManager,
+        pageManager: PageManager,
+        walThreshold?: number,
+    );
+    /**
+     * 检查是否需要执行检查点
+     */
+    shouldCheckpoint(): Promise<boolean>;
+    /**
+     * 执行检查点
+     * @param records 当前内存中的所有记录
+     */
+    execute(records: RecordMap): Promise<CheckpointResult>;
+    /**
+     * 将记录转换为页面
+     * @param records 记录映射
+     */
+    private buildPages;
+    /**
+     * 获取上次检查点时间
+     */
+    getLastCheckpointTime(): number | null;
+    /**
+     * 检查是否有检查点正在进行
+     */
+    isCheckpointInProgress(): boolean;
+    /**
+     * 获取 WAL 阈值
+     */
+    getWalThreshold(): number;
+}
+/**
+ * 自动检查点调度器
+ * 根据配置自动触发检查点
+ */
+export declare class AutoCheckpointScheduler {
+    private readonly checkpointManager;
+    private readonly interval;
+    private timer;
+    private running;
+    private getRecords;
+    /**
+     * 创建自动检查点调度器
+     * @param checkpointManager 检查点管理器
+     * @param interval 检查间隔（毫秒）
+     * @param getRecords 获取当前记录的函数
+     */
+    constructor(checkpointManager: CheckpointManager, interval: number, getRecords: () => RecordMap);
+    /**
+     * 启动调度器
+     */
+    start(): void;
+    /**
+     * 停止调度器
+     */
+    stop(): void;
+    /**
+     * 检查是否正在运行
+     */
+    isRunning(): boolean;
+}
+/**
+ * 增量检查点管理器
+ * 只将脏页写入文件，减少 I/O
+ */
+export declare class IncrementalCheckpointManager {
+    private readonly lightFileManager;
+    private readonly walManager;
+    private readonly pageManager;
+    private readonly walThreshold;
+    /**
+     * 创建增量检查点管理器
+     * @param lightFileManager Light 文件管理器
+     * @param walManager WAL 管理器
+     * @param pageManager 页面管理器
+     * @param walThreshold WAL 阈值
+     */
+    constructor(lightFileManager: LightFileManager, walManager: WalManager, pageManager: PageManager, walThreshold?: number);
+    /**
+     * 执行增量检查点
+     */
+    executeIncremental(): Promise<CheckpointResult>;
+    /**
+     * 检查是否需要增量检查点
+     */
+    shouldCheckpoint(): Promise<boolean>;
+}
+//# sourceMappingURL=Checkpoint.d.ts.map

package/dist/storage/Checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkpoint.d.ts","sourceRoot":"","sources":["../../src/storage/Checkpoint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAW,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,wBAAwB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,oBAAoB,CAAU;IAEtC;;;;;;;OAOG;gBAEC,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,WAAW,EACxB,YAAY,GAAE,MAA8B;IAWhD;;OAEG;IACU,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IASjD;;;OAGG;IACU,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2CnE;;;OAGG;IACH,OAAO,CAAC,UAAU;IAyClB;;OAEG;IACI,qBAAqB,IAAI,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACI,sBAAsB,IAAI,OAAO;IAIxC;;OAEG;IACI,eAAe,IAAI,MAAM;CAGnC;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAkB;IAEpC;;;;;OAKG;gBACS,iBAAiB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS;IAQ/F;;OAEG;IACI,KAAK,IAAI,IAAI;IAiBpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAQnB;;OAEG;IACI,SAAS,IAAI,OAAO;CAG9B;AAED;;;GAGG;AACH,qBAAa,4BAA4B;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC;;;;;;OAMG;gBAEC,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,YAAY,GAAE,MAA8B;IAQhD;;OAEG;IACU,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAsC5D;;OAEG;IACU,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;CASpD"}