@yydb/light-db 0.0.0

package/dist/storage/Checkpoint.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * 检查点（Checkpoint）机制实现
+ * 将内存中的完整数据原子性写入新的 .light 文件
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IncrementalCheckpointManager = exports.AutoCheckpointScheduler = exports.CheckpointManager = void 0;
+const constants_1 = require("../constants");
+const errors_1 = require("../errors");
+/**
+ * 检查点管理器
+ * 负责管理检查点的创建和协调
+ */
+class CheckpointManager {
+    /**
+     * 创建检查点管理器
+     * @param lightFileManager Light 文件管理器
+     * @param walManager WAL 管理器
+     * @param walIndexManager WAL 索引管理器
+     * @param pageManager 页面管理器
+     * @param walThreshold WAL 文件大小阈值
+     */
+    constructor(lightFileManager, walManager, walIndexManager, pageManager, walThreshold = constants_1.DEFAULT_WAL_THRESHOLD) {
+        this.lightFileManager = lightFileManager;
+        this.walManager = walManager;
+        this.walIndexManager = walIndexManager;
+        this.pageManager = pageManager;
+        this.walThreshold = walThreshold;
+        this.lastCheckpointTime = null;
+        this.checkpointInProgress = false;
+    }
+    /**
+     * 检查是否需要执行检查点
+     */
+    async shouldCheckpoint() {
+        if (this.checkpointInProgress) {
+            return false;
+        }
+        const walSize = await this.walManager.getFileSize();
+        return walSize >= this.walThreshold;
+    }
+    /**
+     * 执行检查点
+     * @param records 当前内存中的所有记录
+     */
+    async execute(records) {
+        if (this.checkpointInProgress) {
+            throw new errors_1.CheckpointError("Checkpoint already in progress");
+        }
+        this.checkpointInProgress = true;
+        try {
+            const currentLsn = this.walManager.getCurrentLsn();
+            await this.walManager.writeCheckpoint();
+            await this.walManager.sync();
+            const pages = this.buildPages(records);
+            await this.lightFileManager.writeSnapshot(pages, currentLsn);
+            await this.walManager.clear();
+            await this.walIndexManager.resetAfterCheckpoint(currentLsn);
+            this.pageManager.loadPages(pages);
+            this.pageManager.clearDirtyFlags();
+            this.lastCheckpointTime = Date.now();
+            const endTime = Date.now();
+            const bytesWritten = await this.lightFileManager.getFileSize();
+            return {
+                timestamp: endTime,
+                lsn: currentLsn,
+                pagesWritten: pages.size,
+                bytesWritten,
+            };
+        } catch (error) {
+            const err = error;
+            throw new errors_1.CheckpointError(`Checkpoint failed: ${err.message}`, this.walManager.getCurrentLsn());
+        } finally {
+            this.checkpointInProgress = false;
+        }
+    }
+    /**
+     * 将记录转换为页面
+     * @param records 记录映射
+     */
+    buildPages(records) {
+        const pages = new Map();
+        const pageSize = this.pageManager.getPageSize();
+        let currentPageId = 0;
+        let currentRecords = [];
+        let currentSize = 0;
+        const headerSize = 12;
+        const recordOverhead = 4 + 4 + 4;
+        for (const [key, value] of records) {
+            const keyLength = Buffer.byteLength(key, "utf8");
+            const recordSize = recordOverhead + keyLength + value.length;
+            if (currentSize + recordSize > pageSize - headerSize - 4 && currentRecords.length > 0) {
+                pages.set(currentPageId, {
+                    pageId: currentPageId,
+                    records: currentRecords.map((r) => ({ key: r.key, value: r.value })),
+                    checksum: 0,
+                });
+                currentPageId++;
+                currentRecords = [];
+                currentSize = 0;
+            }
+            currentRecords.push({ key, value });
+            currentSize += recordSize;
+        }
+        if (currentRecords.length > 0) {
+            pages.set(currentPageId, {
+                pageId: currentPageId,
+                records: currentRecords.map((r) => ({ key: r.key, value: r.value })),
+                checksum: 0,
+            });
+        }
+        return pages;
+    }
+    /**
+     * 获取上次检查点时间
+     */
+    getLastCheckpointTime() {
+        return this.lastCheckpointTime;
+    }
+    /**
+     * 检查是否有检查点正在进行
+     */
+    isCheckpointInProgress() {
+        return this.checkpointInProgress;
+    }
+    /**
+     * 获取 WAL 阈值
+     */
+    getWalThreshold() {
+        return this.walThreshold;
+    }
+}
+exports.CheckpointManager = CheckpointManager;
+/**
+ * 自动检查点调度器
+ * 根据配置自动触发检查点
+ */
+class AutoCheckpointScheduler {
+    /**
+     * 创建自动检查点调度器
+     * @param checkpointManager 检查点管理器
+     * @param interval 检查间隔（毫秒）
+     * @param getRecords 获取当前记录的函数
+     */
+    constructor(checkpointManager, interval, getRecords) {
+        this.checkpointManager = checkpointManager;
+        this.interval = interval;
+        this.timer = null;
+        this.running = false;
+        this.getRecords = getRecords;
+    }
+    /**
+     * 启动调度器
+     */
+    start() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        this.timer = setInterval(async () => {
+            try {
+                if (await this.checkpointManager.shouldCheckpoint()) {
+                    await this.checkpointManager.execute(this.getRecords());
+                }
+            } catch {
+                // 静默处理错误，避免影响定时器
+            }
+        }, this.interval);
+    }
+    /**
+     * 停止调度器
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.running = false;
+    }
+    /**
+     * 检查是否正在运行
+     */
+    isRunning() {
+        return this.running;
+    }
+}
+exports.AutoCheckpointScheduler = AutoCheckpointScheduler;
+/**
+ * 增量检查点管理器
+ * 只将脏页写入文件，减少 I/O
+ */
+class IncrementalCheckpointManager {
+    /**
+     * 创建增量检查点管理器
+     * @param lightFileManager Light 文件管理器
+     * @param walManager WAL 管理器
+     * @param pageManager 页面管理器
+     * @param walThreshold WAL 阈值
+     */
+    constructor(lightFileManager, walManager, pageManager, walThreshold = constants_1.DEFAULT_WAL_THRESHOLD) {
+        this.lightFileManager = lightFileManager;
+        this.walManager = walManager;
+        this.pageManager = pageManager;
+        this.walThreshold = walThreshold;
+    }
+    /**
+     * 执行增量检查点
+     */
+    async executeIncremental() {
+        const dirtyPages = this.pageManager.getDirtyPages();
+        if (dirtyPages.length === 0) {
+            return {
+                timestamp: Date.now(),
+                lsn: this.walManager.getCurrentLsn(),
+                pagesWritten: 0,
+                bytesWritten: 0,
+            };
+        }
+        const currentLsn = this.walManager.getCurrentLsn();
+        for (const page of dirtyPages) {
+            await this.lightFileManager.writePage(page);
+        }
+        await this.lightFileManager.sync();
+        const header = await this.lightFileManager.readHeader();
+        if (header) {
+            header.lastSnapshotLsn = currentLsn;
+            await this.lightFileManager.writeHeader(header);
+        }
+        this.pageManager.clearDirtyFlags();
+        const totalBytes = dirtyPages.length * this.pageManager.getPageSize();
+        return {
+            timestamp: Date.now(),
+            lsn: currentLsn,
+            pagesWritten: dirtyPages.length,
+            bytesWritten: totalBytes,
+        };
+    }
+    /**
+     * 检查是否需要增量检查点
+     */
+    async shouldCheckpoint() {
+        const dirtyPages = this.pageManager.getDirtyPages();
+        if (dirtyPages.length > 100) {
+            return true;
+        }
+        const walSize = await this.walManager.getFileSize();
+        return walSize >= this.walThreshold;
+    }
+}
+exports.IncrementalCheckpointManager = IncrementalCheckpointManager;
+//# sourceMappingURL=Checkpoint.js.map

package/dist/storage/Checkpoint.js.map

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

package/dist/storage/LightFile.d.ts

@@ -0,0 +1,227 @@
+/**
+ * .light 文件格式实现
+ * 主数据文件，存储数据库的完整快照
+ */
+import { LightHeader, Page, Record, PageMap, RecordMap } from "../types";
+/**
+ * Light 文件序列化器
+ * 负责将数据序列化为 .light 文件格式
+ */
+export declare class LightFileSerializer {
+    private readonly pageSize;
+    /**
+     * 创建序列化器
+     * @param pageSize 页面大小，默认 4KB
+     */
+    constructor(pageSize?: number);
+    /**
+     * 序列化文件头部
+     * @param header 头部数据
+     */
+    serializeHeader(header: LightHeader): Buffer;
+    /**
+     * 反序列化文件头部
+     * @param buffer 包含头部数据的 Buffer
+     */
+    deserializeHeader(buffer: Buffer): LightHeader;
+    /**
+     * 序列化单条记录
+     * @param record 记录数据
+     */
+    serializeRecord(record: Record): Buffer;
+    /**
+     * 反序列化单条记录
+     * @param buffer 包含记录数据的 Buffer
+     * @param startOffset 起始偏移量
+     */
+    deserializeRecord(
+        buffer: Buffer,
+        startOffset?: number,
+    ): {
+        record: Record;
+        bytesRead: number;
+    };
+    /**
+     * 序列化页面
+     * @param page 页面数据
+     */
+    serializePage(page: Page): Buffer;
+    /**
+     * 反序列化页面
+     * @param buffer 包含页面数据的 Buffer
+     * @param pageId 页面ID
+     */
+    deserializePage(buffer: Buffer, pageId: number): Page;
+    /**
+     * 序列化整个数据库快照
+     * @param pages 页面映射
+     * @param lastSnapshotLsn 上次快照的 LSN
+     */
+    serializeSnapshot(pages: PageMap, lastSnapshotLsn: bigint): Buffer;
+    /**
+     * 获取页面大小
+     */
+    getPageSize(): number;
+}
+/**
+ * Light 文件管理器
+ * 负责 .light 文件的读写操作
+ */
+export declare class LightFileManager {
+    private readonly basePath;
+    private readonly dbName;
+    private readonly serializer;
+    private handle;
+    /**
+     * 创建文件管理器
+     * @param basePath 数据库基础路径
+     * @param dbName 数据库名称
+     * @param pageSize 页面大小
+     */
+    constructor(basePath: string, dbName: string, pageSize?: number);
+    /**
+     * 获取 .light 文件路径
+     */
+    getFilePath(): string;
+    /**
+     * 获取临时文件路径
+     */
+    private getTempFilePath;
+    /**
+     * 打开文件
+     */
+    open(): Promise<void>;
+    /**
+     * 关闭文件
+     */
+    close(): Promise<void>;
+    /**
+     * 读取文件头部
+     */
+    readHeader(): Promise<LightHeader | null>;
+    /**
+     * 写入文件头部
+     * @param header 头部数据
+     */
+    writeHeader(header: LightHeader): Promise<void>;
+    /**
+     * 读取指定页面
+     * @param pageId 页面ID
+     */
+    readPage(pageId: number): Promise<Page | null>;
+    /**
+     * 写入指定页面
+     * @param page 页面数据
+     */
+    writePage(page: Page): Promise<void>;
+    /**
+     * 加载所有页面
+     */
+    loadAllPages(): Promise<PageMap>;
+    /**
+     * 加载所有记录到内存映射
+     */
+    loadAllRecords(): Promise<RecordMap>;
+    /**
+     * 原子性写入完整快照
+     * 先写临时文件，再 rename 确保原子性
+     * @param pages 页面映射
+     * @param lastSnapshotLsn 上次快照的 LSN
+     */
+    writeSnapshot(pages: PageMap, lastSnapshotLsn: bigint): Promise<void>;
+    /**
+     * 获取文件大小
+     */
+    getFileSize(): Promise<number>;
+    /**
+     * 同步到磁盘
+     */
+    sync(): Promise<void>;
+    /**
+     * 检查文件是否存在
+     */
+    exists(): Promise<boolean>;
+    /**
+     * 获取页面大小
+     */
+    getPageSize(): number;
+}
+/**
+ * 页面管理器
+ * 管理内存中的页面分配和回收
+ */
+export declare class PageManager {
+    private readonly pageSize;
+    private pages;
+    private nextPageId;
+    private dirtyPages;
+    /**
+     * 创建页面管理器
+     * @param pageSize 页面大小
+     */
+    constructor(pageSize?: number);
+    /**
+     * 创建新页面
+     */
+    createPage(): Page;
+    /**
+     * 获取页面
+     * @param pageId 页面ID
+     */
+    getPage(pageId: number): Page | undefined;
+    /**
+     * 获取或创建页面
+     * @param pageId 页面ID
+     */
+    getOrCreatePage(pageId: number): Page;
+    /**
+     * 标记页面为脏页
+     * @param pageId 页面ID
+     */
+    markDirty(pageId: number): void;
+    /**
+     * 获取所有脏页
+     */
+    getDirtyPages(): Page[];
+    /**
+     * 清除脏页标记
+     */
+    clearDirtyFlags(): void;
+    /**
+     * 加载页面数据
+     * @param pages 页面映射
+     */
+    loadPages(pages: PageMap): void;
+    /**
+     * 获取所有页面
+     */
+    getAllPages(): PageMap;
+    /**
+     * 获取页面数量
+     */
+    getPageCount(): number;
+    /**
+     * 计算记录在页面中的大小
+     * @param record 记录
+     */
+    calculateRecordSize(record: Record): number;
+    /**
+     * 获取页面可用空间
+     * @param page 页面
+     */
+    getAvailableSpace(page: Page): number;
+    /**
+     * 查找可以容纳记录的页面
+     * @param record 记录
+     */
+    findPageForRecord(record: Record): Page | null;
+    /**
+     * 获取下一个页面ID
+     */
+    getNextPageId(): number;
+    /**
+     * 获取页面大小
+     */
+    getPageSize(): number;
+}
+//# sourceMappingURL=LightFile.d.ts.map

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

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