25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。
TypeScript aicliclickhousedatabasedatabase-clientdatabase-managementdockerguimcpmongodbmysqlpostgresqlredisrustsql-serversqlitetaurivue
import type { DatabaseType } from "@/types/database";
import type { TableImportJsonShape, TableImportParseOptions, TableImportSourceFormat, TableImportTextEncoding } from "@/lib/backend/api";
export const IMPORT_SKIP_TARGET = "";
export type TableImportGeneratorKey = "uuid" | "uuid_simple" | "current_timestamp" | "current_date" | "sequence";
export interface TableImportGeneratorOption {
value: TableImportGeneratorKey;
labelKey: string;
}
export const TABLE_IMPORT_GENERATOR_OPTIONS: ReadonlyArray<TableImportGeneratorOption> = [
{ value: "uuid", labelKey: "tableImport.generatorUuid" },
{ value: "uuid_simple", labelKey: "tableImport.generatorUuidSimple" },
{ value: "current_timestamp", labelKey: "tableImport.generatorCurrentTimestamp" },
{ value: "current_date", labelKey: "tableImport.generatorCurrentDate" },
{ value: "sequence", labelKey: "tableImport.generatorSequence" },
];
export interface ImportColumnMappingLike {
sourceColumn: string;
targetColumn: string;
targetDataType?: string | null;
generator?: string | null;
}
export interface ImportMappingValidationResult {
valid: boolean;
errors: string[];
duplicateTargets: string[];
}
export interface ImportTargetColumnLike {
name: string;
is_nullable?: boolean;
column_default?: string | null;
extra?: string | null;
is_primary_key?: boolean;
}
export interface TableImportProgressLike {
status: "running" | "done" | "error" | "cancelled";
phase?: "preparing" | "detectingEncoding" | "reading" | "writing" | "finalizing" | "done";
rowsImported: number;
totalRows: number;
totalRowsExact?: boolean;
bytesRead?: number;
totalBytes?: number;
}
export type TableImportWizardStep = "source" | "options" | "mapping" | "review" | "execution";
export const TABLE_IMPORT_ENCODING_OPTIONS: ReadonlyArray<{ value: TableImportTextEncoding; labelKey: string }> = [
{ value: "auto", labelKey: "tableImport.encodingAuto" },
{ value: "utf8", labelKey: "tableImport.encodingUtf8" },
{ value: "gbk", labelKey: "tableImport.encodingGbk" },
{ value: "utf16Le", labelKey: "tableImport.encodingUtf16Le" },
{ value: "utf16Be", labelKey: "tableImport.encodingUtf16Be" },
];
export const TABLE_IMPORT_WIZARD_STEPS: TableImportWizardStep[] = ["source", "options", "mapping", "review", "execution"];
export function formatTableImportElapsed(ms: number): string {
const elapsedMs = Math.max(0, Number.isFinite(ms) ? Math.round(ms) : 0);
if (elapsedMs < 1000) return `${elapsedMs} ms`;
const seconds = elapsedMs / 1000;
if (seconds < 60) return `${seconds.toFixed(1)} s`;
const minutes = Math.floor(seconds / 60);
return `${minutes}m ${Math.round(seconds % 60)}s`;
}
export function resolveTableImportElapsed(liveElapsedMs: number, backendElapsedMs: number | undefined, terminal: boolean): number {
const live = Math.max(0, Number.isFinite(liveElapsedMs) ? liveElapsedMs : 0);
const backend = backendElapsedMs === undefined || !Number.isFinite(backendElapsedMs) ? undefined : Math.max(0, backendElapsedMs);
if (terminal && backend !== undefined) return backend;
return Math.max(live, backend ?? 0);
}
export function previewValueForGenerator(generator: string, sequence = 1): string {
const normalized = generator.toLowerCase().replace(/[-_]/g, "");
switch (normalized) {
case "uuid":
case "uuidv4":
return "<UUID>";
case "uuidsimple":
case "uuidnohyphens":
case "uuid32":
return "<UUID32>";
case "currenttimestamp":
case "now":
case "datetime":
return "<NOW>";
case "currentdate":
case "today":
case "date":
return "<TODAY>";
case "sequence":
case "autoincrement":
return `<SEQ:${sequence}>`;
default:
return `<${generator}>`;
}
}
export function formatTableImportPreviewCell(value: unknown, generator?: string | null, rowIndex = 0): string {
if (generator) {
return previewValueForGenerator(generator, rowIndex + 1);
}
if (value === null) return "NULL";
if (value !== null && typeof value === "object" && !Array.isArray(value)) {
const marker = value as Record<string, unknown>;
if (Object.keys(marker).length === 1 && marker.$dbxSqlImportExpression === "currentTimestamp") return "CURRENT_TIMESTAMP";
}
if (typeof value === "object") return JSON.stringify(value);
return String(value);
}
export function tableImportProgressPercent(progress: TableImportProgressLike | null | undefined): number {
if (!progress) return 0;
if (progress.status === "done") return 100;
let percent = 0;
const totalRows = progress.totalRows ?? 0;
const totalBytes = progress.totalBytes ?? 0;
if (progress.phase === "detectingEncoding") {
percent = totalBytes > 0 ? ((progress.bytesRead ?? 0) / totalBytes) * 10 : 0;
} else if (progress.phase === "writing" || progress.phase === "finalizing") {
if (progress.totalRowsExact !== false && totalRows > 0) {
percent = 10 + (progress.rowsImported / totalRows) * 89;
} else if (totalBytes > 0) {
percent = 10 + ((progress.bytesRead ?? 0) / totalBytes) * 89;
}
} else if (progress.totalRowsExact !== false && totalRows > 0) {
percent = (progress.rowsImported / totalRows) * 100;
} else if (totalBytes > 0) {
percent = ((progress.bytesRead ?? 0) / totalBytes) * 100;
}
return Math.min(99, Math.max(0, Math.round(percent)));
}
export interface TableImportParseSettings {
format: TableImportSourceFormat;
delimiter: string;
decimalSeparator?: "." | ",";
textEncoding: TableImportTextEncoding;
titleRow: number;
dataStartRow: number;
lastDataRow: number;
trimValues: boolean;
emptyStringAsNull: boolean;
sheetName?: string;
jsonShape: TableImportJsonShape;
databaseType?: DatabaseType | null;
}
/**
* 导入时分隔文本的「空字段即 NULL」默认值。
*
* 导出端默认把 NULL 写成 `\N` 字面量、空字符串才写成空字段,所以导入端默认必须
* 保留空字段(不当作 NULL),否则 DBX 自己导出的 CSV 在导入时会把空字符串还原成
* NULL,写回 `NOT NULL DEFAULT ''` 的列就会报「不允许为 null」。
*/
export function defaultTableImportEmptyStringAsNull(_format: TableImportSourceFormat): boolean {
return false;
}
export function buildTableImportParseOptions(settings: TableImportParseSettings): TableImportParseOptions {
const isDelimited = settings.format === "csv" || settings.format === "tsv" || settings.format === "delimited";
// SQL 脚本与分隔文本一样是纯文本源,需要传递编码供后端解码(支持 GBK 等常见转储编码)
const isTextSource = isDelimited || settings.format === "sql";
return {
delimiter: settings.format === "tsv" ? "\\t" : settings.format === "csv" ? "," : settings.delimiter,
decimalSeparator: isDelimited ? (settings.decimalSeparator ?? ".") : null,
encoding: isTextSource ? settings.textEncoding : null,
titleRow: settings.titleRow,
dataStartRow: settings.dataStartRow,
lastDataRow: settings.lastDataRow,
trimValues: settings.trimValues,
emptyStringAsNull: settings.emptyStringAsNull,
// 勾选「空字符串作为 NULL」= 退回旧行为:关闭 NULL 字面量,空字段一律当 NULL。
// 不勾选时留空,由后端使用与导出端一致的默认字面量 `\N`。
nullLiteral: settings.emptyStringAsNull ? "" : undefined,
sheetName: settings.format === "excel" ? settings.sheetName || null : null,
jsonShape: settings.format === "json" ? settings.jsonShape : null,
// SQL 脚本需要按源方言解析字符串转义与标识符大小写(取目标连接的数据库类型)
sqlDialect: settings.format === "sql" ? (settings.databaseType ?? null) : null,
};
}
export function normalizeImportColumnName(name: string): string {
return name.trim().toLowerCase().replace(/[_-]+/g, " ").replace(/\s+/g, " ");
}
export function autoMapImportColumns(sourceColumns: string[], targetColumns: string[], mode: "name" | "position" | "auto" = "auto"): Record<string, string> {
if (mode === "position") {
return Object.fromEntries(sourceColumns.map((source, index) => [source, targetColumns[index] ?? IMPORT_SKIP_TARGET]));
}
const exactTargets = new Map(targetColumns.map((column) => [column, column]));
const normalizedTargets = new Map(targetColumns.map((column) => [normalizeImportColumnName(column), column]));
const byName = Object.fromEntries(sourceColumns.map((source) => [source, exactTargets.get(source) ?? normalizedTargets.get(normalizeImportColumnName(source)) ?? IMPORT_SKIP_TARGET]));
if (mode === "auto") {
const hasAnyMatched = Object.values(byName).some((target) => target !== IMPORT_SKIP_TARGET);
if (!hasAnyMatched && targetColumns.length > 0) {
return Object.fromEntries(sourceColumns.map((source, index) => [source, targetColumns[index] ?? IMPORT_SKIP_TARGET]));
}
}
return byName;
}
export function validateImportMappings(mappings: ImportColumnMappingLike[]): ImportMappingValidationResult {
const activeMappings = mappings.filter((mapping) => mapping.targetColumn.trim());
const errors: string[] = [];
const duplicateTargets: string[] = [];
if (activeMappings.length === 0) {
errors.push("No columns mapped for import");
}
const seen = new Set<string>();
for (const mapping of activeMappings) {
const key = mapping.targetColumn.trim().toLowerCase();
if (seen.has(key) && !duplicateTargets.includes(mapping.targetColumn)) {
duplicateTargets.push(mapping.targetColumn);
}
seen.add(key);
if (Object.prototype.hasOwnProperty.call(mapping, "targetDataType") && !String(mapping.targetDataType || "").trim()) {
errors.push(`Target data type cannot be empty: ${mapping.targetColumn}`);
}
}
if (duplicateTargets.length) {
errors.push(`Target column mapped more than once: ${duplicateTargets.join(", ")}`);
}
return { valid: errors.length === 0, errors, duplicateTargets };
}
export function requiredImportTargetColumns(columns: ImportTargetColumnLike[], mappedTargetColumns: string[]): string[] {
const mapped = new Set(mappedTargetColumns.map((column) => column.toLowerCase()));
return columns
.filter((column) => !mapped.has(column.name.toLowerCase()))
.filter(
(column) =>
column.is_nullable === false &&
!column.column_default &&
!String(column.extra || "")
.toLowerCase()
.includes("auto"),
)
.map((column) => column.name);
}
export function nextTableImportWizardStep(step: TableImportWizardStep): TableImportWizardStep {
const index = TABLE_IMPORT_WIZARD_STEPS.indexOf(step);
return TABLE_IMPORT_WIZARD_STEPS[Math.min(TABLE_IMPORT_WIZARD_STEPS.length - 1, Math.max(0, index) + 1)];
}
export function previousTableImportWizardStep(step: TableImportWizardStep): TableImportWizardStep {
const index = TABLE_IMPORT_WIZARD_STEPS.indexOf(step);
return TABLE_IMPORT_WIZARD_STEPS[Math.max(0, index - 1)];
}
type ImportInferredType = "boolean" | "integer" | "decimal" | "date" | "timestamp" | "json" | "text";
function hasNumericLeadingZero(value: string): boolean {
const unsigned = value.trim().replace(/^[+-]/, "");
return unsigned.length > 1 && unsigned[0] === "0" && /\d/.test(unsigned[1] || "");
}
function isLikelyDate(value: string): boolean {
return /^\d{4}[-/]\d{2}[-/]\d{2}$/.test(value.trim());
}
function isLikelyTimestamp(value: string): boolean {
const trimmed = value.trim();
return /^\d{4}[-/]\d{2}[-/]\d{2}[ T]\d{2}:\d{2}:\d{2}(?:\.\d+)?$/.test(trimmed) || /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(trimmed);
}
function inferStringType(value: string): ImportInferredType {
const trimmed = value.trim();
if (!trimmed) return "text";
if (isLikelyTimestamp(trimmed)) return "timestamp";
if (isLikelyDate(trimmed)) return "date";
if (!hasNumericLeadingZero(trimmed)) {
if (/^[+-]?\d+$/.test(trimmed)) return "integer";
if (/^[+-]?(?:\d+\.\d*|\d*\.\d+|\d+e[+-]?\d+|\d+\.\d*e[+-]?\d+|\d*\.\d+e[+-]?\d+)$/i.test(trimmed) && Number.isFinite(Number(trimmed))) {
return "decimal";
}
}
return "text";
}
function inferValueType(value: unknown): ImportInferredType | null {
if (value == null) return null;
if (typeof value === "boolean") return "boolean";
if (typeof value === "number") return Number.isInteger(value) ? "integer" : "decimal";
if (typeof value === "string") return inferStringType(value);
if (typeof value === "object") return "json";
return "text";
}
function mergeInferredType(current: ImportInferredType | null, next: ImportInferredType): ImportInferredType {
if (!current || current === next) return next;
if (current === "text" || next === "text") return "text";
if ((current === "integer" && next === "decimal") || (current === "decimal" && next === "integer")) return "decimal";
if ((current === "date" && next === "timestamp") || (current === "timestamp" && next === "date")) return "timestamp";
return "text";
}
function inferColumnType(rows: unknown[][], sourceIndex: number): ImportInferredType {
let inferred: ImportInferredType | null = null;
for (const row of rows) {
const valueType = inferValueType(row[sourceIndex]);
if (!valueType) continue;
inferred = mergeInferredType(inferred, valueType);
if (inferred === "text") break;
}
return inferred || "text";
}
export function importDataTypeForDatabase(inferredType: ImportInferredType, databaseType?: DatabaseType): string {
switch (inferredType) {
case "boolean":
if (["mysql", "doris", "starrocks", "goldendb", "sundb", "databend"].includes(databaseType || "")) return "TINYINT(1)";
if (databaseType === "sqlserver") return "BIT";
if (databaseType === "sqlite" || databaseType === "rqlite" || databaseType === "turso" || databaseType === "cloudflare-d1") return "INTEGER";
if (databaseType === "oracle" || databaseType === "oceanbase-oracle" || databaseType === "dameng") return "NUMBER(1)";
if (databaseType === "clickhouse") return "UInt8";
return "BOOLEAN";
case "integer":
if (databaseType === "sqlite" || databaseType === "rqlite" || databaseType === "turso" || databaseType === "cloudflare-d1") return "INTEGER";
if (databaseType === "oracle" || databaseType === "oceanbase-oracle" || databaseType === "dameng") return "NUMBER(19)";
if (databaseType === "clickhouse") return "Int64";
return "BIGINT";
case "decimal":
if (["postgres", "gaussdb", "opengauss", "redshift", "kingbase", "highgo", "uxdb", "kwdb", "vastbase"].includes(databaseType || "")) return "DOUBLE PRECISION";
if (databaseType === "sqlserver") return "FLOAT";
if (databaseType === "sqlite" || databaseType === "rqlite" || databaseType === "turso" || databaseType === "cloudflare-d1") return "REAL";
if (databaseType === "oracle" || databaseType === "oceanbase-oracle" || databaseType === "dameng") return "BINARY_DOUBLE";
if (databaseType === "clickhouse") return "Float64";
return "DOUBLE";
case "date":
if (databaseType === "sqlite" || databaseType === "rqlite" || databaseType === "turso" || databaseType === "cloudflare-d1") return "TEXT";
if (databaseType === "clickhouse") return "Date";
return "DATE";
case "timestamp":
if (["mysql", "doris", "starrocks", "goldendb", "sundb", "databend"].includes(databaseType || "")) return "DATETIME";
if (databaseType === "sqlserver") return "DATETIME2";
if (databaseType === "sqlite" || databaseType === "rqlite" || databaseType === "turso" || databaseType === "cloudflare-d1") return "TEXT";
if (databaseType === "clickhouse") return "DateTime64";
return "TIMESTAMP";
case "json":
if (["postgres", "gaussdb", "opengauss", "kingbase", "highgo", "uxdb", "kwdb", "vastbase"].includes(databaseType || "")) return "JSONB";
if (databaseType === "mysql" || databaseType === "databend") return "JSON";
return importDataTypeForDatabase("text", databaseType);
case "text":
default:
if (databaseType === "sqlserver") return "NVARCHAR(MAX)";
if (databaseType === "oracle" || databaseType === "oceanbase-oracle" || databaseType === "dameng") return "CLOB";
if (databaseType === "clickhouse") return "String";
if (["hive", "argo", "trino", "prestosql", "databricks"].includes(databaseType || "")) return "STRING";
return "TEXT";
}
}
export function suggestImportTargetDataTypes(columns: string[], rows: unknown[][], databaseType?: DatabaseType): Record<string, string> {
return Object.fromEntries(columns.map((column, index) => [column, importDataTypeForDatabase(inferColumnType(rows, index), databaseType)]));
}
export function suggestDataTypeForGenerator(generator: string, databaseType?: DatabaseType): string {
const normalized = generator.toLowerCase().replace(/[-_]/g, "");
switch (normalized) {
case "uuid":
case "uuidv4":
if (["postgres", "gaussdb", "opengauss", "kingbase", "highgo", "uxdb", "kwdb", "vastbase"].includes(databaseType || "")) return "UUID";
if (databaseType === "sqlserver") return "UNIQUEIDENTIFIER";
return "VARCHAR(36)";
case "uuidsimple":
case "uuidnohyphens":
case "uuid32":
return "VARCHAR(32)";
case "currenttimestamp":
case "now":
case "datetime":
return importDataTypeForDatabase("timestamp", databaseType);
case "currentdate":
case "today":
case "date":
return importDataTypeForDatabase("date", databaseType);
case "sequence":
case "autoincrement":
return importDataTypeForDatabase("integer", databaseType);
default:
return importDataTypeForDatabase("text", databaseType);
}
}