Chuyển đến nội dung chính

Nhập & Xuất

TablePro hỗ trợ import dữ liệu từ file CSV, JSON và SQL, cũng như export dữ liệu theo nhiều định dạng (CSV, JSON, SQL và Excel XLSX) để sao lưu, di chuyển hoặc phân tích.

Export Dữ Liệu

Tùy Chọn Export

Export dữ liệu từ kết quả query hoặc bảng:
  1. Chạy query hoặc mở bảng
  2. Click nút Export trong toolbar
  3. Chọn định dạng export
  4. Chọn đích đến và tùy chọn
  5. Click Export
Export dialog

Định Dạng Export

Comma-Separated ValuesTốt nhất cho:
  • Excel và ứng dụng bảng tính
  • Công cụ phân tích dữ liệu
  • Trao đổi dữ liệu đơn giản
Tùy chọn:
Tùy chọnMô tảMặc định
DelimiterKý tự phân tách giá trị, (dấu phẩy)
QuoteKý tự để trích dẫn chuỗi"
HeaderBao gồm tên cột
NULL asCách biểu diễn NULLChuỗi rỗng
Formula sanitizationNgăn chặn CSV injection
Decimal formatDấu chấm hoặc dấu phẩy cho số thập phânDấu chấm
Line break formatLF, CRLF, hoặc CRLF
Ví dụ output:
id,name,email,created_at
1,"John Doe",[email protected],2024-01-15 10:30:00
2,"Jane Smith",[email protected],2024-01-16 14:45:00

Export Kết Quả Query

Để export kết quả của query cụ thể:
  1. Viết và thực thi query
  2. Click Export khi kết quả được hiển thị
  3. Chỉ kết quả hiển thị được export
Đối với export lớn, sử dụng phân trang hoặc LIMIT trong query để kiểm soát kích thước export.

Export Toàn Bộ Bảng

Để export tất cả dữ liệu từ bảng:
  1. Click vào bảng trong sidebar
  2. Click Export mà không áp dụng bộ lọc nào
  3. Hoặc chạy SELECT * FROM table_name và export
Bạn có thể export nhiều bảng cùng lúc bằng cách chọn chúng trong sidebar trước khi click Export. Mỗi bảng có thể có tùy chọn riêng cho cấu trúc (DDL) và dữ liệu.

Export Chỉ Cấu Trúc

Để export chỉ cấu trúc bảng (DDL):
  1. Mở tab Structure của bảng
  2. Đi đến tab con DDL
  3. Sao chép câu lệnh CREATE TABLE
Hoặc sử dụng lệnh cụ thể theo database:
-- MySQL
SHOW CREATE TABLE users;

-- PostgreSQL
pg_dump -s -t users database_name

Dán từ Clipboard (CSV/TSV)

Bạn có thể dán dữ liệu dạng bảng trực tiếp từ clipboard vào bảng dữ liệu. TablePro tự động phát hiện nội dung clipboard là định dạng CSV (phân tách bằng dấu phẩy) hay TSV (phân tách bằng tab). Cách hoạt động:
  1. Sao chép dữ liệu từ bảng tính, trình soạn thảo văn bản hoặc nguồn khác
  2. Chọn một hàng trong bảng dữ liệu
  3. Nhấn Cmd+V để dán
TablePro sử dụng trình phân tích CSV tuân thủ RFC 4180, hỗ trợ:
  • Trường được trích dẫn có dấu phẩy bên trong (ví dụ: "New York, NY")
  • Dấu ngoặc kép thoát (ví dụ: "He said ""hello""")
  • Giá trị nhiều dòng trong trường được trích dẫn
  • Tự động phát hiện hàng tiêu đề (bỏ qua nếu tên cột khớp)
Định dạng được tự động phát hiện dựa trên nội dung: nếu dữ liệu chứa nhiều tab hơn dấu phẩy, nó được phân tích dạng TSV; ngược lại là CSV. Dữ liệu sao chép từ Excel hoặc Google Sheets thường là dạng tab-separated.

Import Dữ Liệu

Tùy Chọn Import

Import dữ liệu vào database:
  1. Click File > Import (hoặc nút Import)
  2. Chọn file nguồn
  3. Cấu hình tùy chọn import
  4. Xem trước dữ liệu
  5. Click Import
Import dialog

Định Dạng Import

Import File CSVTùy chọn cấu hình:
Tùy chọnMô tả
DelimiterKý tự phân tách trường (phẩy, tab, dấu chấm phẩy)
Quote characterKý tự dùng để trích dẫn
Escape characterKý tự để escape dấu ngoặc kép
Has headerHàng đầu tiên chứa tên cột
Skip rowsSố hàng bỏ qua ở đầu
NULL representationChuỗi để hiểu là NULL
EncodingEncoding file (UTF-8, Latin-1, v.v.)
Đảm bảo encoding CSV của bạn khớp với encoding database để tránh vấn đề ký tự.

Quy Trình Import

1

Chọn File

Chọn file CSV, JSON hoặc SQL của bạn
2

Cấu Hình Tùy Chọn

Đặt delimiter, encoding và các tùy chọn khác
3

Map Cột

Khớp cột file với cột bảng
4

Xem Trước

Xem lại vài hàng đầu trước khi import
5

Import

Thực thi import và theo dõi tiến trình

Map Cột

Khi import, bạn có thể map cột nguồn với cột đích:
Column mapping
  • Auto-match: Các cột có tên khớp được tự động map
  • Manual mapping: Kéo cột hoặc sử dụng dropdown để map
  • Skip columns: Bỏ qua các cột bạn không muốn import
  • Default values: Đặt giá trị mặc định cho các cột bắt buộc không được map

Chế Độ Import

Chế độMô tảSử dụng khi
InsertThêm hàng mớiImport dữ liệu mới
ReplaceXóa khớp, chèn mớiLàm mới toàn bộ bảng
UpdateCập nhật khớp, chèn mớiCập nhật tăng dần
Chế độ Replace xóa dữ liệu hiện có. Luôn sao lưu các bảng quan trọng trước.

Xem Trước Dữ Liệu

Xem Trước Trước Khi Import

Tính năng xem trước hiển thị:
  • 100 hàng đầu tiên của dữ liệu
  • Loại cột được phát hiện
  • Vấn đề phân tích tiềm ẩn
  • Xử lý giá trị NULL
Data preview

Xem Trước Trước Khi Export

Xem những gì sẽ được export:
  • Tổng số hàng
  • Kích thước file ước tính
  • Mẫu dữ liệu

Tiến Trình và Lỗi

Tiến Trình Import

Import lớn hiển thị tiến trình:
  • Hàng đã xử lý / tổng số hàng
  • Thời gian còn lại ước tính
  • Batch hiện tại
Import progress

Xử Lý Lỗi

Khi lỗi xảy ra trong quá trình import:
Tùy chọnHành vi
Stop on first errorDừng import ngay lập tức
Skip errorsTiếp tục, ghi log hàng lỗi
Rollback on errorHoàn tác tất cả thay đổi nếu có lỗi
Chi tiết lỗi bao gồm:
  • Số hàng
  • Thông báo lỗi
  • Dữ liệu có vấn đề

Log Lỗi

Các hàng thất bại được ghi log để xem lại:
Row 45: Data too long for column 'name' at row 1
Row 89: Duplicate entry '[email protected]' for key 'email'
Row 123: Column count doesn't match value count

Nén

TablePro hỗ trợ nén gzip cho cả import và export:

Export Nén

  • Bật tùy chọn “Compress with gzip” khi export
  • File output nhận phần mở rộng .gz
  • Giảm đáng kể kích thước file cho export lớn

Import Nén

  • TablePro tự động phát hiện file .gz
  • Giải nén tức thì trong quá trình import (FileDecompressor.swift)
  • Không cần giải nén thủ công

Thực Hành Tốt Nhất

Export

  1. Lọc trước: Chỉ export những gì bạn cần
    SELECT * FROM orders WHERE status = 'completed' AND year(created_at) = 2024;
    
  2. Cân nhắc kích thước file: Sử dụng LIMIT cho bảng rất lớn
    SELECT * FROM logs ORDER BY created_at DESC LIMIT 100000;
    
  3. Chọn định dạng phù hợp:
    • CSV cho công cụ phân tích dữ liệu
    • JSON cho API/web
    • SQL cho di chuyển database
    • XLSX cho chia sẻ với người dùng không kỹ thuật qua Excel

Import

  1. Sao lưu trước: Luôn sao lưu trước khi import số lượng lớn
  2. Kiểm tra với mẫu: Import vài hàng trước
    -- Tạo bảng test
    CREATE TABLE users_import_test LIKE users;
    -- Import mẫu vào bảng test
    
  3. Xác thực loại dữ liệu: Đảm bảo dữ liệu nguồn khớp với cột đích
  4. Sử dụng transaction: Đối với import quan trọng, bật chế độ transaction
  5. Tắt index: Đối với import rất lớn, cân nhắc:
    -- Tắt key (MySQL)
    ALTER TABLE users DISABLE KEYS;
    -- Import dữ liệu
    ALTER TABLE users ENABLE KEYS;
    

Khắc Phục Sự Cố

Vấn Đề Export

“File too large”
  • Sử dụng LIMIT trong query
  • Export theo batch
  • Chọn định dạng nhỏ gọn hơn (CSV vs JSON)
“Character encoding issues”
  • Xác minh encoding database
  • Export với encoding UTF-8
  • Kiểm tra ký tự đặc biệt

Vấn Đề Import

“Column count mismatch”
  • Kiểm tra thiết lập delimiter
  • Xác minh CSV có đúng số cột
  • Tìm dấu phẩy không được trích dẫn trong dữ liệu
“Invalid value for type”
  • Kiểm tra định dạng ngày khớp với kỳ vọng database
  • Xác minh giá trị số không chứa dấu phẩy
  • Kiểm tra văn bản trong cột số
“Duplicate key error”
  • Dữ liệu chứa bản sao cho cột unique
  • Cân nhắc sử dụng chế độ REPLACE
  • Xóa bản sao trước khi import
“Foreign key constraint”
  • Import bảng cha trước
  • Tạm thời tắt kiểm tra foreign key:
    SET FOREIGN_KEY_CHECKS=0;
    -- Import
    SET FOREIGN_KEY_CHECKS=1;
    

Phím Tắt

Hành độngPhím tắt
ExportCmd+Shift+E
ImportCmd+Shift+I

Các Bước Tiếp Theo