csv2psql
Tool for transforming CSV into SQL statements
See examples
Formalities
Status
Features
- Works outside of box
- Customizable (parameters can be tweaked)
- Extendable (external modules can bring functionality)
- Database aware
- SQL Dialects sensitive
Getting started
gem install csv2psql
Usage
Simple conversion
csv2psql convert data/sample.csv
Global help
csv2psql help
NAME
csv2psql - csv2psql 0.0.12 (Codename: Prudent owl)
SYNOPSIS
csv2psql [global options] command [command options] [arguments...]
GLOBAL OPTIONS
-d, --delimiter=arg - Column delimiter (default: ,)
-h, --[no-]header - Header row included (default: enabled)
--help - Show this message
-l, --limit=arg - How many rows process (default: -1)
-q, --quote=arg - Quoting character (default: ")
-s, --separator=arg - Line separator (default: none)
--skip=arg - How many rows skip (default: -1)
COMMANDS
analyze - Analyze csv file
convert - Convert csv file
help - Shows a list of commands or help for one command
schema - Generate schema for file
version - Print version info```
Analyze help
csv2psql help analyze
NAME
analyze - Analyze csv file
SYNOPSIS
csv2psql [global options] analyze [command options]
COMMAND OPTIONS
-f, --format=arg - Output format (default: json)
Convert help
csv2psql help convert
NAME
convert - Convert csv file
SYNOPSIS
csv2psql [global options] convert [command options]
COMMAND OPTIONS
--[no-]create-table - Crate SQL Table before inserts
--[no-]drop-table - Drop SQL Table before inserts
-t, --table=arg - Table to insert to (default: none)
--[no-]transaction - Import in transaction block (default: enabled)
--[no-]truncate-table - Truncate SQL Table before inserts
Schema help
csv2psql help schema
NAME
schema - Generate schema for file
SYNOPSIS
csv2psql [global options] schema [command options]
COMMAND OPTIONS
-f, --format=arg - Output format (default: json)
Example
Input CSV
cat data/sample.csv
id,Firstname,Lastname,Address.Street,Address.City,Address.Details.Note
12345,Joe,Doe,"#2140 Taylor Street, 94133",San Francisco,Pool available
45678,Jack,Plumber,"#111 Sutter St, 94104",San Francisco,Korean Deli near to main entrance
Convert CSV
csv2psql convert data/sample.csv
BEGIN;
-- Table: my_table
INSERT INTO (id, firstname, lastname, address_street, address_city, address_details_note) VALUES('12345', 'Joe', 'Doe', '#2140 Taylor Street, 94133', 'San Francisco', 'Pool available');
INSERT INTO (id, firstname, lastname, address_street, address_city, address_details_note) VALUES('45678', 'Jack', 'Plumber', '#111 Sutter St, 94104', 'San Francisco', 'Korean Deli near to main entrance');
COMMIT;
Convert CSV - Create table
csv2psql convert --create-table -t pokus data/sample.csv
BEGIN;
-- Table: pokus
CREATE TABLE pokus(
id TEXT,
firstname TEXT,
lastname TEXT,
address_street TEXT,
address_city TEXT,
address_details_note TEXT
)
WITH (
OIDS=FALSE
);
INSERT INTO pokus(id, firstname, lastname, address_street, address_city, address_details_note) VALUES('12345', 'Joe', 'Doe', '#2140 Taylor Street, 94133', 'San Francisco', 'Pool available');
INSERT INTO pokus(id, firstname, lastname, address_street, address_city, address_details_note) VALUES('45678', 'Jack', 'Plumber', '#111 Sutter St, 94104', 'San Francisco', 'Korean Deli near to main entrance');
COMMIT;
Convert CSV - Stream directly to Postgres client (psql)
csv2psql convert --create-table -t hokus data/sample.csv | psql
BEGIN
CREATE TABLE
INSERT 0 1
INSERT 0 1
COMMIT
Convert CSV - Full load
csv2psql convert --create-table --drop-table --truncate-table -t test data/sample.csv
BEGIN;
DROP TABLE IF EXISTS test;
CREATE TABLE test(
id TEXT,
firstname TEXT,
lastname TEXT,
address_street TEXT,
address_city TEXT,
address_details_note TEXT
)
WITH (
OIDS=FALSE
);
TRUNCATE test;
INSERT INTO test(id, firstname, lastname, address_street, address_city, address_details_note) VALUES('12345', 'Joe', 'Doe', '#2140 Taylor Street, 94133', 'San Francisco', 'Pool available');
INSERT INTO test(id, firstname, lastname, address_street, address_city, address_details_note) VALUES('45678', 'Jack', 'Plumber', '#111 Sutter St, 94104', 'San Francisco', 'Korean Deli near to main entrance');
COMMIT;
Convert CSV - Load CIA Factbook automagically
csv2psql convert --create-table --drop-table --truncate-table --no-transaction -t test data/cia-data-all.csv | psql
Analyze CSV - Show as table
csv2psql analyze --format=table tmp/sfpd_incident_2013.csv
+------------+--------+-----------+---------+------+--------+------+
| tmp/sfpd_incident_2013.csv |
+------------+--------+-----------+---------+------+--------+------+
| column | Bigint | Character | Decimal | Null | String | Uuid |
+------------+--------+-----------+---------+------+--------+------+
| IncidntNum | 132145 | 0 | 0 | 0 | 132145 | 0 |
| Category | 0 | 0 | 0 | 0 | 132145 | 0 |
| Descript | 0 | 0 | 0 | 0 | 132145 | 0 |
| DayOfWeek | 0 | 0 | 0 | 0 | 132145 | 0 |
| Date | 0 | 0 | 0 | 0 | 132145 | 0 |
| Time | 0 | 0 | 0 | 0 | 132145 | 0 |
| PdDistrict | 0 | 0 | 0 | 0 | 132145 | 0 |
| Resolution | 0 | 0 | 0 | 0 | 132145 | 0 |
| Location | 0 | 0 | 0 | 0 | 132145 | 0 |
| X | 0 | 0 | 132145 | 0 | 132145 | 0 |
| Y | 0 | 0 | 132145 | 0 | 132145 | 0 |
+------------+--------+-----------+---------+------+--------+------+
Schema guess
csv2psql schema -f table ./data/census_SFOH_2010.csv
+-------------------------------------------------+---------+---------+
| ./data/census_SFOH_2010.csv |
+-------------------------------------------------+---------+---------+
| column | type | null |
+-------------------------------------------------+---------+---------+
| MSA | text | false |
| Tract ID | bigint | false |
| White Alone | bigint | false |
| Black or African American alone | bigint | false |
| Asian alone | bigint | false |
| Family Households | bigint | false |
| Nonfamily Households | bigint | false |
| Household income: < 10k | bigint | false |
| Household income: 10-15k | bigint | false |
| Household income: 15-20k | bigint | false |
| Household income: 20-25k | bigint | false |
| Household income: 25-30k | bigint | false |
| Household income: 30-35k | bigint | false |
| Household income: 35-40k | bigint | false |
| Household income: 40-45k | bigint | false |
| Household income: 45-50k | bigint | false |
| Household income: 50-60k | bigint | false |
| Household income: 60-75k | bigint | false |
| Household income: 75-100k | bigint | false |
| Household income: 100-125k | bigint | false |
| Household income: 125-150k | bigint | false |
| Household income: 150-200k | bigint | false |
| Household income: > 200k | bigint | false |
| With wage or salary income | bigint | false |
| No wage or salary income | bigint | false |
| With self-employment income | bigint | false |
| No self-employment income | bigint | false |
| With interest dividends or net rental income | bigint | false |
| No interest dividends or net rental income | bigint | false |
| With Social Security income | bigint | false |
| No Social Security income | bigint | false |
| With Supplemental Security Income (SSI) | bigint | false |
| No Supplemental Security Income (SSI) | bigint | false |
| With public assistance income | bigint | false |
| No public assistance income | bigint | false |
| With cash public assistance or Food Stamps/SNAP | bigint | false |
| No cash public assistance or Food Stamps/SNAP | bigint | false |
| With retirement income | bigint | false |
| No retirement income | bigint | false |
| Per capita income (2010 dollars) | bigint | true |
| Housing units | bigint | false |
| Occupancy status: Occupied | bigint | false |
| Occupancy status: Vacant | bigint | false |
| Housing tenure: Owner-occupied | bigint | false |
| Housing tenure: Renter-occupied | bigint | false |
| Median number of rooms | decimal | true |
| Median gross rent (dollars) | bigint | true |
| Median value for owner-occupied housing | bigint | true |
+-------------------------------------------------+---------+---------+
Contributing to csv2psql
- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
- Fork the project
- Start a feature/bugfix branch
- Commit and push until you are happy with your contribution
- Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
- Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
Copyright
Copyright (c) 2014 Tomas Korcak. See LICENSE for details.