sheetjs-pg-table-demo/README.md

Sheetjs to PostgreSQL

Convert Excel sheets to PostgreSQL tables with correct data types.

This demo project serves as a refernce implementation for SheetJS + PostgreSQL integration. For more details, vist the SheetJS Documentation.

Features

• Automatic data type detection from Excel columns
• Support various data formats:
  • Numbers (integer and floating-point)
  • Dates
  • Booleans
  • Text
• Handles special number formats (scientific notations, high precision)
• Clean column names for PostgreSQL compatibility

Prerequisites

• Node.js
• PostgreSQL (16)
• Python 3.x

Installation

1. Install Python dependencies:

pip install -r test_files/requirements.txt

2. Install Node.js dependencies:

npm install i

Setup

1. Generate test_files:

python3 test_files/gen_test_files.py

2. Configure PostgreSQL connection in test.js

const client = new Client({
    host: 'localhost',
    database: 'SheetJSPG',
    user: 'postgres',
    password: '7509'
});

Run

node test.js

Test Files

The test suite includes various Excel files testing different data scenarios:

• number_formats.xlsx: Various numeric formats
• date_formats.xlsx: Date handling
• special_values.xlsx: Edge cases
• precision.xlsx: High-precision numbers
• string_formats.xlsx: Text handling
• boolean_formats.xlsx: Boolean values

Type Mapping

• Excel dates → PostgreSQL date
• Booleans → PostgreSQL boolean
• High-precision numbers → PostgreSQL numeric
• Standard numbers → PostgreSQL double precision
• Text/other → PostgreSQL text