CSV2PSQL

CSV2PSQL — пакет для быстрого импорта CSV файлов в PostgreSQL с автоматическим созданием таблиц, определением типов данных и внешних ключей.

Пользователь просто указывает свои данные PostgreSQL и путь к CSV-файлам, и пакет делает всю работу.

Автор

Nekruz Ikromov — t.me/inekruz

Особенности пакета

• CSV файлы с разделителем ;
• Заголовки столбцов на русском — автоматически транслитерируются в английские имена
• Числа с запятой 1,23 преобразуются в 1.23
• Символ % убирается, оставляя только число
• Автоматически создаются таблицы и определяются типы данных (INTEGER, BIGINT, NUMERIC, BOOLEAN, DATE, TEXT)
• Автоматическая вставка данных и создание внешних ключей между таблицами, если значения совпадают
• Быстрая batch вставка больших CSV файлов

Установка

Глобально (CLI доступен из любой папки):

npm install -g csv2psql

Локально в проект:

npm install csv2psql

Использование через CLI

После глобальной установки можно запустить команду:

csv2psql

Программа запросит:

1. Host PostgreSQL (localhost по умолчанию)
2. Port PostgreSQL (5432 по умолчанию)
3. User PostgreSQL
4. Password
5. Database
6. Путь к папке с CSV файлами

Пример работы через CLI:

csv2psql

После ввода данных CSV файлы будут автоматически импортированы в PostgreSQL с созданием таблиц и связей.

Использование через скрипт Node.js

Пакет можно использовать как модуль внутри собственного скрипта:

const path = require('path');
const { importCSV } = require('csv2psql/lib/importer');

(async () => {
  try {
    await importCSV({
      host: 'localhost',          // адрес PostgreSQL
      port: 5432,                 // порт PostgreSQL
      user: 'postgres',           // имя пользователя
      password: 'mypassword',     // пароль
      database: 'my_database',    // имя базы данных
      folderPath: path.resolve('./csv_files') // путь к папке с CSV файлами
    });
    console.log('✅ Импорт CSV завершён!');
  } catch (err) {
    console.error('Ошибка при импорте CSV:', err.message);
  }
})();

Шаги:

1. Создайте скрипт, например import_my_csv.js.
2. Укажите путь к своей папке с CSV файлами.
3. Запустите скрипт:

node import_my_csv.js

Все CSV файлы из указанной папки будут импортированы автоматически.

Пример CSV файла

users.csv:

ID;Имя;Возраст;Зарплата
1;Иван;30;12345,67
2;Мария;25;23456,78

После импорта будет создана таблица в PostgreSQL:

| id | imya | vozrast | zarplata | | -- | ----- | ------- | -------- | | 1 | Иван | 30 | 12345.67 | | 2 | Мария | 25 | 23456.78 |

Лицензия

MIT

Контакты автора

Telegram: t.me/inekruz