Release/260325

.github/workflows/ci.yml

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-22.04
+    timeout-minutes: 40
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Cache Bun dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            node_modules
+            ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
+      - name: Install frontend dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Setup Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust build artifacts
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: src-tauri -> src-tauri/target
+
+      - name: Run unit tests
+        run: bun run test:unit
+
+      - name: Run service tests
+        run: bun run test:service
+
+      - name: Run rust unit tests
+        run: bun run test:rust:unit
+
+      - name: Run integration tests (MySQL + Postgres with testcontainers)
+        run: IT_DB=all bun run test:integration
+
+      - name: Docker diagnostics on failure
+        if: failure()
+        run: |
+          echo "==== docker ps -a ===="
+          docker ps -a || true
+          echo "==== recent mysql/postgres logs ===="
+          for image in mysql:8.0 postgres:16-alpine; do
+            for id in $(docker ps -aq --filter "ancestor=${image}"); do
+              echo "--- logs for $id (${image}) ---"
+              docker logs "$id" || true
+            done
+          done

.gitignore

@@ -33,3 +33,9 @@ reference
 # plan
 .trae/documents/
 .cursor/plans/
+
+# skills
+.trae/skills/*
+
+# example
+githubworkflowexample/*

README.md

@@ -36,6 +36,7 @@ English | [简体中文](README_CN.md) | [日本語](README_JA.md)
 - Connect to PostgreSQL, MySQL, MariaDB (MySQL-compatible), TiDB (MySQL-compatible), SQLite, SQL Server, and ClickHouse (preview, currently read-only)
 - Write and run SQL with syntax highlighting, auto-completion, and one-click formatting
 - Browse query results in a data grid with filtering, sorting, pagination, and export
+- Import `.sql` files into MySQL/MariaDB/TiDB/PostgreSQL/SQLite/DuckDB/SQL Server with all-or-nothing rollback
 - Save and reuse frequently used SQL scripts with Saved Queries
 - Use the AI sidebar to draft SQL and explain queries (optional)
 - Access remote databases through SSH tunneling

README_CN.md

@@ -36,6 +36,7 @@
 - 连接 PostgreSQL、MySQL、MariaDB（MySQL 兼容）、TiDB（MySQL 兼容）、SQLite、SQL Server 与 ClickHouse（预览版，当前只读）
 - 编写与执行 SQL：语法高亮、自动补全、一键格式化
 - 在数据网格中浏览结果，支持过滤、排序、分页与导出
+- 支持将 `.sql` 文件导入 MySQL/MariaDB/TiDB/PostgreSQL/SQLite/DuckDB/SQL Server，并在失败时全量回滚
 - 使用 Saved Queries 保存并复用常用 SQL 脚本
 - 使用 AI 侧边栏辅助写 SQL、解释查询（可选）
 - 通过 SSH 隧道访问远程数据库

docs/zh/Development/DEVELOPMENT.md

@@ -51,6 +51,103 @@ bun run test:rust:unit
 bun run test:integration
 ```
 
+### 集成测试自动化（MySQL + MariaDB + Postgres + ClickHouse + SQL Server + DuckDB）
+
+- 默认执行 `bun run test:integration` 会自动启动/销毁 MySQL、MariaDB、Postgres、ClickHouse 与 SQL Server 容器（DuckDB 使用本地临时文件，不依赖容器）。
+- 可通过 `IT_DB` 指定目标数据库：
+  ```bash
+  IT_DB=mysql bun run test:integration
+  IT_DB=mariadb bun run test:integration
+  IT_DB=postgres bun run test:integration
+  IT_DB=clickhouse bun run test:integration
+  IT_DB=mssql bun run test:integration
+  IT_DB=duckdb bun run test:integration
+  IT_DB=all bun run test:integration
+  ```
+- 如需复用你本地已经启动的数据库（兼容旧流程），可设置：
+  ```bash
+  IT_REUSE_LOCAL_DB=1 bun run test:integration
+  ```
+
+### 集成测试常见环境变量（可选覆盖）
+
+- MySQL: `MYSQL_HOST` `MYSQL_PORT` `MYSQL_USER` `MYSQL_PASSWORD` `MYSQL_DB`
+- MariaDB: `MARIADB_HOST` `MARIADB_PORT` `MARIADB_USER` `MARIADB_PASSWORD` `MARIADB_DB`
+- Postgres: `POSTGRES_HOST` `POSTGRES_PORT` `POSTGRES_USER` `POSTGRES_PASSWORD` `POSTGRES_DB`
+- ClickHouse: `CLICKHOUSE_HOST` `CLICKHOUSE_PORT` `CLICKHOUSE_USER` `CLICKHOUSE_PASSWORD` `CLICKHOUSE_DB`
+- SQL Server: `MSSQL_HOST` `MSSQL_PORT` `MSSQL_USER` `MSSQL_PASSWORD` `MSSQL_DB`
+- DuckDB: `DUCKDB_IT_DB_PATH`（可选）`DUCKDB_DB_PATH`（可选）
+- 兼容 Postgres 常见别名: `PG_HOST` `PG_PORT` `PGUSER` `PGPASSWORD` `PGDATABASE`
+
+### 排障建议
+
+- 镜像拉取慢：先手动执行 `docker pull mysql:8.0`、`docker pull mariadb:11`、`docker pull postgres:16-alpine`、`docker pull clickhouse/clickhouse-server:24.3` 和 `docker pull mcr.microsoft.com/mssql/server:2022-latest` 预热。
+- 端口冲突：集成测试默认使用 Docker 动态映射端口，通常不会冲突；如本地复用模式冲突，请调整 `*_PORT`。
+- Apple 芯片兼容：若首次拉取较慢，建议预先拉取镜像并等待 Docker Desktop 完成架构层初始化。
+
+### 推荐工作流
+
+- 日常开发：优先执行 `test:unit` + `test:service`。
+- 提交前：按需执行 `test:integration` 做数据库回归。
+- PR：CI 会固定执行集成测试作为质量兜底。
+
+### 功能开发后怎么跑测试（实践版）
+
+1. 开发过程中（高频、快速反馈）
+
+- 先跑：
+  ```bash
+  bun run test:unit
+  bun run test:service
+  ```
+- 适用：前端逻辑、业务逻辑、小范围改动的快速验证。
+
+2. 改动涉及数据库行为时（中频）
+
+- 跑：
+  ```bash
+  IT_DB=all bun run test:integration
+  ```
+- 或按需只跑单库：
+  ```bash
+  IT_DB=mysql bun run test:integration
+  IT_DB=mariadb bun run test:integration
+  IT_DB=postgres bun run test:integration
+  IT_DB=clickhouse bun run test:integration
+  IT_DB=mssql bun run test:integration
+  IT_DB=duckdb bun run test:integration
+  ```
+- 适用：连接参数、驱动逻辑、执行 SQL、表/库元数据、DDL/DML、类型映射相关改动。
+
+3. 提交前（低频但建议）
+
+- 至少跑一次：
+  ```bash
+  IT_DB=all bun run test:integration
+  ```
+- PR 流水线会再次自动跑，作为最终兜底。
+
+### 这套集成测试覆盖什么 / 不覆盖什么
+
+- 能覆盖：
+  - Rust 数据库层真实连库能力
+  - 常见数据库操作链路（连接、建表、查询、元数据、DDL）
+  - 驱动兼容与类型映射问题
+- 不覆盖：
+  - 前端 UI 的“点点点”交互流程（这属于 E2E/UI 自动化范畴）
+  - 纯视觉样式问题
+
+### 什么时候可以不跑集成测试
+
+- 仅改文案、样式、纯前端展示层，且不影响数据库交互。
+- 仅改与数据库完全无关的代码。
+- 快速迭代中间版本可不跑；合并前建议补跑一次。
+
+### 容器清理说明
+
+- 默认模式（未设置 `IT_REUSE_LOCAL_DB=1`）下，测试使用 testcontainers 拉起临时容器，测试结束后会自动销毁。
+- 设置 `IT_REUSE_LOCAL_DB=1` 时，测试会连接你手动准备的数据库实例，不会自动删除你自己的容器。
+
 ## 代码格式化
 
 ```bash

package.json

@@ -5,7 +5,7 @@
     "url": "git+https://github.com/codeErrorSleep/dbpaw.git"
   },
   "private": true,
-  "version": "0.2.9",
+  "version": "0.3.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

scripts/db-onboard.sh

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: scripts/db-onboard.sh <db> [--skip-gate] [--skip-matrix]"
+  exit 1
+fi
+
+db="$1"
+shift || true
+
+skip_gate=0
+skip_matrix=0
+
+for arg in "$@"; do
+  case "$arg" in
+    --skip-gate)
+      skip_gate=1
+      ;;
+    --skip-matrix)
+      skip_matrix=1
+      ;;
+    *)
+      echo "[error] unknown option: $arg"
+      echo "Usage: scripts/db-onboard.sh <db> [--skip-gate] [--skip-matrix]"
+      exit 1
+      ;;
+  esac
+done
+
+root_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "${root_dir}"
+
+context_file="src-tauri/tests/common/${db}_context.rs"
+integration_file="src-tauri/tests/${db}_integration.rs"
+command_file="src-tauri/tests/${db}_command_integration.rs"
+stateful_file="src-tauri/tests/${db}_stateful_command_integration.rs"
+tracker_file="docs/zh/Development/MYSQL_TEST_COVERAGE_GAP_TRACKER.md"
+
+echo "[step] scaffold check: ${db}"
+missing=0
+for file in "${context_file}" "${integration_file}" "${command_file}" "${stateful_file}"; do
+  if [[ ! -f "${file}" ]]; then
+    echo "[missing] ${file}"
+    missing=1
+  else
+    echo "[ok] ${file}"
+  fi
+done
+
+if [[ ${missing} -ne 0 ]]; then
+  echo "[error] scaffold is incomplete for '${db}'."
+  echo "[hint] finish scaffold first, then rerun scripts/db-onboard.sh ${db}"
+  exit 1
+fi
+
+if [[ ${skip_gate} -eq 0 ]]; then
+  echo "[step] gate syntax check"
+  bash -n scripts/test-integration.sh
+
+  echo "[step] compile smoke: ${db}_integration"
+  cargo test --manifest-path src-tauri/Cargo.toml --test "${db}_integration" --no-run
+
+  echo "[step] compile smoke: ${db}_command_integration"
+  cargo test --manifest-path src-tauri/Cargo.toml --test "${db}_command_integration" --no-run
+
+  echo "[step] compile smoke: ${db}_stateful_command_integration"
+  cargo test --manifest-path src-tauri/Cargo.toml --test "${db}_stateful_command_integration" --no-run
+
+  echo "[step] integration gate run: IT_DB=${db}"
+  IT_DB="${db}" bash scripts/test-integration.sh
+else
+  echo "[skip] gate run skipped by --skip-gate"
+fi
+
+if [[ ${skip_matrix} -eq 0 ]]; then
+  echo "[step] matrix sync check"
+  test_count="$(rg -n "async fn test_${db}_" src-tauri/tests --glob "*.rs" || true)"
+  test_count="$(printf "%s\n" "${test_count}" | sed '/^$/d' | wc -l | tr -d ' ')"
+  echo "[info] detected test functions for ${db}: ${test_count}"
+  if [[ -f "${tracker_file}" ]]; then
+    tracker_hits="$(rg -n "test_${db}_" "${tracker_file}" || true)"
+    tracker_hits="$(printf "%s\n" "${tracker_hits}" | sed '/^$/d' | wc -l | tr -d ' ')"
+    if [[ "${tracker_hits}" -eq 0 ]]; then
+      echo "[warn] tracker has no '${db}' test entries yet: ${tracker_file}"
+      echo "[next] sync capability matrix and command coverage sections for '${db}'"
+    else
+      echo "[ok] tracker already contains ${tracker_hits} '${db}' test entries"
+    fi
+  else
+    echo "[warn] tracker file not found: ${tracker_file}"
+  fi
+else
+  echo "[skip] matrix sync check skipped by --skip-matrix"
+fi
+
+echo "[done] db onboarding pipeline finished for '${db}'"