807

How can I write a stored procedure that imports data from a CSV file and populates the table?

9

21 Answers 21

934

Take a look at this short article.


The solution is paraphrased here:

Create your table:

CREATE TABLE zip_codes
(ZIP char(5), LATITUDE double precision, LONGITUDE double precision,
CITY varchar, STATE char(2), COUNTY varchar, ZIP_CLASS varchar);

Copy data from your CSV file to the table:

COPY zip_codes FROM '/path/to/csv/ZIP_CODES.txt' WITH (FORMAT csv);
11
  • 70
    actually use \copy would do the same trick if you do not have the super user access; it complaints on my Fedora 16 when using COPY with a non-root account.
    – asksw0rder
    Commented Oct 15, 2012 at 17:07
  • 92
    TIP: you can indicate what columns you have in the CSV using zip_codes(col1, col2, col3). The columns must be listed in the same order that they appear in the file. Commented Jan 2, 2013 at 5:16
  • 8
    @asksw0rder does \copy have the same syntax? bcoz I'm getting a syntax error with \copy
    – JhovaniC
    Commented May 29, 2013 at 19:59
  • 8
    Should I include the header row?
    – bernie2436
    Commented Oct 27, 2013 at 23:09
  • 152
    You can easily include the header row -- just add HEADER in the options: COPY zip_codes FROM '/path/to/csv/ZIP_CODES.txt' DELIMITER ',' CSV HEADER; postgresql.org/docs/9.1/static/sql-copy.html Commented Nov 8, 2013 at 15:17
341

If you don't have permission to use COPY (which work on the db server), you can use \copy instead (which works in the db client). Using the same example as Bozhidar Batsov:

Create your table:

CREATE TABLE zip_codes
(ZIP char(5), LATITUDE double precision, LONGITUDE double precision,
CITY varchar, STATE char(2), COUNTY varchar, ZIP_CLASS varchar);

Copy data from your CSV file to the table:

\copy zip_codes FROM '/path/to/csv/ZIP_CODES.txt' DELIMITER ',' CSV

Mind that \copy ... must be written in one line and without a ; at the end!

You can also specify the columns to read:

\copy zip_codes(ZIP,CITY,STATE) FROM '/path/to/csv/ZIP_CODES.txt' DELIMITER ',' CSV

See the documentation for COPY:

Do not confuse COPY with the psql instruction \copy. \copy invokes COPY FROM STDIN or COPY TO STDOUT, and then fetches/stores the data in a file accessible to the psql client. Thus, file accessibility and access rights depend on the client rather than the server when \copy is used.

And note:

For identity columns, the COPY FROM command will always write the column values provided in the input data, like the INSERT option OVERRIDING SYSTEM VALUE.

13
  • \copy voters(ZIP,CITY) FROM '/Users/files/Downloads/WOOD.TXT' DELIMITER ',' CSV HEADER; ERROR: extra data after last expected column CONTEXT: COPY voters, line 2: "OH0012781511,87,26953,HOUSEHOLDER,SHERRY,LEIGH,,11/26/1965,08/19/1988,,211 N GARFIELD ST , ,BLOOMD..."
    – JZ.
    Commented Sep 6, 2015 at 17:29
  • @JZ. I had a similar error. It was because I had extra blank columns. Check your csv and if you have blank columns, that could be the reason. Commented Jul 8, 2016 at 4:32
  • 5
    This is somewhat misleading: the difference between COPY and \copy is much more than just permissions, and you can't simply add a `` to make it magically work. See the description (in the context of export) here: stackoverflow.com/a/1517692/157957
    – IMSoP
    Commented Jan 26, 2017 at 16:29
  • @IMSoP: you're right, I added a mention of server and client to clarify
    – bjelli
    Commented Jan 27, 2017 at 9:03
  • 3
    @Sebastian: the important difference is that \copy works from the client. so you still have to transmit all the data to the server. with COPY (no slash) you first upload all the data to the server with other means (sftp, scp) and then do the import on the server. but transmitting 1.5 MB does not sound like it should talk 3 hours - no matter which way you do it.
    – bjelli
    Commented May 29, 2018 at 20:49
105

One quick way of doing this is with the Python Pandas library (version 0.15 or above works best). This will handle creating the columns for you - although obviously the choices it makes for data types might not be what you want. If it doesn't quite do what you want you can always use the 'create table' code generated as a template.

Here's a simple example:

import pandas as pd
df = pd.read_csv('mypath.csv')
df.columns = [c.lower() for c in df.columns] # PostgreSQL doesn't like capitals or spaces

from sqlalchemy import create_engine
engine = create_engine('postgresql://username:password@localhost:5432/dbname')

df.to_sql("my_table_name", engine)

And here's some code that shows you how to set various options:

# Set it so the raw SQL output is logged
import logging
logging.basicConfig()
logging.getLogger('sqlalchemy.engine').setLevel(logging.INFO)

df.to_sql("my_table_name2",
          engine,
          if_exists="append",  # Options are ‘fail’, ‘replace’, ‘append’, default ‘fail’
          index = False, # Do not output the index of the dataframe
          dtype = {'col1': sqlalchemy.types.NUMERIC,
                   'col2': sqlalchemy.types.String}) # Datatypes should be SQLAlchemy types
5
  • 6
    In addition, the if_exists parameter can be set to replace or append to an existing table, e.g. df.to_sql("fhrs", engine, if_exists='replace') Commented Apr 30, 2015 at 0:47
  • 1
    username and password : need to create Login and assign DB to user. If uses pgAdmin, then create "Login/Group role" using GUI Commented Mar 24, 2017 at 12:52
  • 17
    Pandas is a super slow way of loading to sql (vs csv files). Can be orders of magnitude slower.
    – user48956
    Commented May 4, 2017 at 18:46
  • 1
    This could be a way to write data but it is super slow even with batch and good computing power. Using CSVs is a good way to accomplish this. Commented Jul 13, 2018 at 14:09
  • 1
    df.to_sql() is really slow, you can use d6tstack.utils.pd_to_psql() from d6tstack see performance comparison
    – citynorman
    Commented Dec 4, 2018 at 4:07
47

Most other solutions here require that you create the table in advance/manually. This may not be practical in some cases (e.g., if you have a lot of columns in the destination table). So, the approach below may come handy.

Providing the path and column count of your CSV file, you can use the following function to load your table to a temp table that will be named as target_table:

The top row is assumed to have the column names.

create or replace function data.load_csv_file
(
    target_table text,
    csv_path text,
    col_count integer
)

returns void as $$

declare

iter integer; -- dummy integer to iterate columns with
col text; -- variable to keep the column name at each iteration
col_first text; -- first column name, e.g., top left corner on a csv file or spreadsheet

begin
    create table temp_table ();

    -- add just enough number of columns
    for iter in 1..col_count
    loop
        execute format('alter table temp_table add column col_%s text;', iter);
    end loop;

    -- copy the data from csv file
    execute format('copy temp_table from %L with delimiter '','' quote ''"'' csv ', csv_path);

    iter := 1;
    col_first := (select col_1 from temp_table limit 1);

    -- update the column names based on the first row which has the column names
    for col in execute format('select unnest(string_to_array(trim(temp_table::text, ''()''), '','')) from temp_table where col_1 = %L', col_first)
    loop
        execute format('alter table temp_table rename column col_%s to %s', iter, col);
        iter := iter + 1;
    end loop;

    -- delete the columns row
    execute format('delete from temp_table where %s = %L', col_first, col_first);

    -- change the temp table name to the name given as parameter, if not blank
    if length(target_table) > 0 then
        execute format('alter table temp_table rename to %I', target_table);
    end if;

end;

$$ language plpgsql;
7
  • 1
    Hi Mehmet, thanks for the answer you posted but when I run your code I get the following error message : ERROR: schema "data" does not exist Commented Nov 8, 2016 at 5:34
  • user2867432 you need to change schema name that you use accordingly (e.g., public)
    – mehmet
    Commented Nov 8, 2016 at 13:05
  • 2
    Hi Mehmet, Thanks for solution, it's perfect but This works only if the postgres DB user is superuser, is ther any way to make it work without superuser?
    – Geeme
    Commented Jun 23, 2017 at 9:05
  • 1
    Geeme: read "security definer" here, but I have not used it myself.
    – mehmet
    Commented Jun 23, 2017 at 16:55
  • 2
    Beautiful answer! I am not going to too generic though in my code for readability for others. Commented Jan 15, 2020 at 9:33
37

You could also use pgAdmin, which offers a GUI to do the import. That's shown in this SO thread. The advantage of using pgAdmin is that it also works for remote databases.

Much like the previous solutions though, you would need to have your table on the database already. Each person has his own solution, but I usually open the CSV file in Excel, copy the headers, paste special with transposition on a different worksheet, place the corresponding data type on the next column, and then just copy and paste that to a text editor together with the appropriate SQL table creation query like so:

CREATE TABLE my_table (
    /* Paste data from Excel here for example ... */
    col_1 bigint,
    col_2 bigint,
    /* ... */
    col_n bigint
)
1
  • 1
    pls show a couple of sample rows of your pasted data
    – dcorking
    Commented Apr 19, 2018 at 11:07
35
  1. Create a table first

  2. Then use the copy command to copy the table details:

     copy table_name (C1,C2,C3....)
     from 'path to your CSV file' delimiter ',' csv header;
    

NOTE:

  • columns and order are specified by C1,C2,C3.. in SQL
  • The header option just skips one line from the input, not according to columns' name.
1
  • 5
    How is this not the accepted answer? Why would I write a python script when the database already has a command to do this?
    – Wes
    Commented May 17, 2019 at 4:02
27
COPY table_name FROM 'path/to/data.csv' DELIMITER ',' CSV HEADER;
0
21

As Paul mentioned, import works in pgAdmin:

Right-click on table → Import

Select a local file, format and coding.

Here is a German pgAdmin GUI screenshot:

pgAdmin import GUI

A similar thing you can do with DbVisualizer (I have a license and am not sure about free version).

Right-click on a table → Import Table Data...

DbVisualizer import GUI

1
  • 3
    DBVisualizer took 50 seconds to import 1400 rows with three fields -- and I had to cast everything back from a String to whatever it was supposed to be.
    – Noumenon
    Commented Sep 29, 2016 at 10:46
16

How to import CSV file data into a PostgreSQL table

Steps:

  1. Need to connect a PostgreSQL database in the terminal

     psql -U postgres -h localhost
    
  2. Need to create a database

     create database mydb;
    
  3. Need to create a user

     create user siva with password 'mypass';
    
  4. Connect with the database

     \c mydb;
    
  5. Need to create a schema

     create schema trip;
    
  6. Need to create a table

     create table trip.test(VendorID int,passenger_count int,trip_distance decimal,RatecodeID int,store_and_fwd_flag varchar,PULocationID int,DOLocationID int,payment_type decimal,fare_amount decimal,extra decimal,mta_tax decimal,tip_amount decimal,tolls_amount int,improvement_surcharge decimal,total_amount
     );
    
  7. Import csv file data to postgresql

     COPY trip.test(VendorID int,passenger_count int,trip_distance decimal,RatecodeID int,store_and_fwd_flag varchar,PULocationID int,DOLocationID int,payment_type decimal,fare_amount decimal,extra decimal,mta_tax decimal,tip_amount decimal,tolls_amount int,improvement_surcharge decimal,total_amount) FROM '/home/Documents/trip.csv' DELIMITER ',' CSV HEADER;
    
  8. Find the given table data

     select * from trip.test;
    
3
  • 1
    Why do we need datatype on the copy command? I mean on step 7 Commented Jun 27, 2022 at 8:46
  • No need to use the columns name and types unless the order of the columns differs between the table and the CSV file. Commented Aug 9, 2024 at 6:02
  • My COPY command was: copy a_event from '/home/ludo/nobackup/a_event.csv' with (delimiter ',', format csv, header) where type = 'D' and datetime1 < timestamptz '2020-03-09 00:00:00+01'; just to give an example of the syntax. Commented Aug 9, 2024 at 6:03
11

Use this SQL code:

copy table_name(atribute1,attribute2,attribute3...)
from 'E:\test.csv' delimiter ',' csv header

The header keyword lets the DBMS know that the CSV file have a header with attributes.

For more, visit Import CSV File Into PostgreSQL Table.

10

This is a personal experience with PostgreSQL, and I am still waiting for a faster way.

  1. Create a table skeleton first if the file is stored locally:

     drop table if exists ur_table;
     CREATE TABLE ur_table
     (
         id serial NOT NULL,
         log_id numeric,
         proc_code numeric,
         date timestamp,
         qty    int,
         name varchar,
         price money
     );
     COPY
         ur_table(id, log_id, proc_code, date, qty, name, price)
     FROM '\path\xxx.csv' DELIMITER ',' CSV HEADER;
    
  2. When the \path\xxx.csv file is on the server, PostgreSQL doesn't have the permission to access the server. You will have to import the .csv file through the pgAdmin built in functionality.

    Right click the table name and choose import.

    Enter image description here

If you still have the problem, please refer this tutorial: Import CSV File Into PostgreSQL Table

8

You can also use pgfutter, or, even better, pgcsv.

These tools create the table columns from you, based on the CSV header.

pgfutter is quite buggy, and I'd recommend pgcsv.

Here's how to do it with pgcsv:

sudo pip install pgcsv
pgcsv --db 'postgresql://localhost/postgres?user=postgres&password=...' my_table my_file.csv
1
  • This works fine. But you should give --db string wthout single quotes in this format: postgresql://user:secret@localhost
    – CoolWolf
    Commented Sep 30, 2024 at 8:09
7

In Python, you can use this code for automatic PostgreSQL table creation with column names:

import pandas, csv

from io import StringIO
from sqlalchemy import create_engine

def psql_insert_copy(table, conn, keys, data_iter):
    dbapi_conn = conn.connection
    with dbapi_conn.cursor() as cur:
        s_buf = StringIO()
        writer = csv.writer(s_buf)
        writer.writerows(data_iter)
        s_buf.seek(0)
        columns = ', '.join('"{}"'.format(k) for k in keys)
        if table.schema:
            table_name = '{}.{}'.format(table.schema, table.name)
        else:
            table_name = table.name
        sql = 'COPY {} ({}) FROM STDIN WITH CSV'.format(table_name, columns)
        cur.copy_expert(sql=sql, file=s_buf)

engine = create_engine('postgresql://user:password@localhost:5432/my_db')

df = pandas.read_csv("my.csv")
df.to_sql('my_table', engine, schema='my_schema', method=psql_insert_copy)

It's also relatively fast. I can import more than 3.3 million rows in about 4 minutes.

4

DBeaver Community Edition (dbeaver.io) makes it trivial to connect to a database, then import a CSV file for upload to a PostgreSQL database. It also makes it easy to issue queries, retrieve data, and download result sets to CSV, JSON, SQL, or other common data formats.

It is a FOSS multi-platform database tool for SQL programmers, DBAs and analysts that supports all popular databases: MySQL, PostgreSQL, SQLite, Oracle, DB2, SQL Server, Sybase, MS Access, Teradata, Firebird, Hive, Presto, etc. It's a viable FOSS competitor to TOAD for Postgres, TOAD for SQL Server, or Toad for Oracle.

I have no affiliation with DBeaver. I love the price (FREE!) and full functionality, but I wish they would open up this DBeaver/Eclipse application more and make it easy to add analytics widgets to DBeaver / Eclipse, rather than requiring users to pay for the $199 annual subscription just to create graphs and charts directly within the application. My Java coding skills are rusty and I don't feel like taking weeks to relearn how to build Eclipse widgets, (only to find that DBeaver has probably disabled the ability to add third-party widgets to the DBeaver Community Edition.)

2
  • 2
    It would have been nice to understand how to actually use DBeaver to import a CSV file. Anyway, this might help: dbeaver.com/docs/wiki/Data-transfer
    – umbe1987
    Commented Apr 17, 2020 at 10:01
  • Peter suggested that I move this question to comments: "Can DBeaver power users who are Java developers provide some insight about the steps to create analytics widgets to add into the Community Edition of DBeaver? " I would like to know if the analytics plugins are also open source, and how to create them. Commented Apr 14, 2022 at 4:33
4

You can create a Bash file as import.sh (that your CSV format is a tab delimiter):

#!/usr/bin/env bash

USER="test"
DB="postgres"
TBALE_NAME="user"
CSV_DIR="$(pwd)/csv"
FILE_NAME="user.txt"

echo $(psql -d $DB -U $USER  -c "\copy $TBALE_NAME from '$CSV_DIR/$FILE_NAME' DELIMITER E'\t' csv" 2>&1 |tee /dev/tty)

And then run this script.

1
  • What do you mean by "your CSV format is a tab delimiter"? Commented Apr 10, 2022 at 22:03
3

I created a small tool that imports csv file into PostgreSQL super easy. It is just a command and it will create and populate the tables, but unfortunately, at the moment, all fields automatically created uses the type TEXT:

csv2pg users.csv -d ";" -H 192.168.99.100 -U postgres -B mydatabase

The tool can be found on https://github.com/eduardonunesp/csv2pg

2
  • 2
    You made a separate tool for the equivalent of psql -h 192.168.99.100 -U postgres mydatabase -c "COPY users FROM 'users.csv' DELIMITER ';' CSV"? I guess the part where it creates the table is nice, but since every field is text it's not super useful
    – GammaGames
    Commented Oct 17, 2019 at 14:52
  • 2
    Ops, thanks for the heads up. Yes, I did it, well it took just a few hours and I learned cool stuff in Go and pq and database API in Go. Commented Oct 18, 2019 at 15:17
3

These are some great answers but over complicated for me. I just need to load in a CSV file into postgreSQL without creating a table first.

Here is my way:

libraries

import pandas as pd
import os
import psycopg2 as pg
from sqlalchemy  import create_engine

Use environmental Variable to get your password

password = os.environ.get('PSW')

create our engine

engine = create_engine(f"postgresql+psycopg2://postgres:{password}@localhost:5432/postgres")

The break down of engine requirements:

  • engine = create_engine(dialect+driver://username:password@host:port/database)

Break Down

  • postgresql+psycopg2 = dialect+driver
  • postgres = username
  • password = password from my environmental variable. You can type in password if needed but not recommended
  • localhost = host
  • 5432 = port
  • postgres = database

Get your CSV file path, I had to use an encoding aspect. reason why can be found Here

data = pd.read_csv(r"path, encoding= 'unicode_escape')

Send data to Postgress SQL:

data.to_sql('test', engine, if_exists='replace')

Break Down

  • test = table name you want table to be
  • engine = engine created above. AKA our connection
  • if_exsists = will replace old table if there. Use this with caution.

All Together:

import pandas as pd
import os
import psycopg2 as pg
from sqlalchemy  import create_engine

password = os.environ.get('PSW')

engine = create_engine(f"postgresql+psycopg2://postgres:{password}@localhost:5432/postgres")

data = pd.read_csv(r"path, encoding= 'unicode_escape')
data.to_sql('test', engine, if_exists='replace')
3

You have 3 options to import CSV files to PostgreSQL: First, using the COPY command through the command line.

enter image description here

Second, using the pgAdmin tool’s import/export.

enter image description here

Third, using a cloud solution like Skyvia which gets the CSV file from an online location like an FTP source or a cloud storage like Google Drive.

enter image description here

2
  • 1
    Please review Why not upload images of code/errors when asking a question? (e.g., "Images should only be used to illustrate problems that can't be made clear in any other way, such as to provide screenshots of a user interface.) and take the appropriate action (it covers answers as well). Thanks in advance. Commented Apr 10, 2022 at 22:12
  • It applies at least to the first image. The last image is unreadable (possibly lost fidelity due to falsely being converted to JPEG (unsuitable for screenshots)). Commented Apr 10, 2022 at 22:13
2

Create a table and have the required columns that are used for creating a table in the CSV file.

  1. Open postgres and right click on the target table which you want to load. Select import and Update the following steps in the file options section

  2. Now browse your file for the filename

  3. Select CSV in format

  4. Encoding as ISO_8859_5

Now go to Misc. options. Check header and click on import.

2

If you need a simple mechanism to import from text/parse multiline CSV content, you could use:

CREATE TABLE t   -- OR INSERT INTO tab(col_names)
AS
SELECT
   t.f[1] AS col1
  ,t.f[2]::int AS col2
  ,t.f[3]::date AS col3
  ,t.f[4] AS col4
FROM (
  SELECT regexp_split_to_array(l, ',') AS f
  FROM regexp_split_to_table(
$$a,1,2016-01-01,bbb
c,2,2018-01-01,ddd
e,3,2019-01-01,eee$$, '\n') AS l) t;

DBFiddle Demo

2

You can use the Pandas library if the file is not very large.

Be careful when using iter over Pandas dataframes. I am doing this here to demonstrate the possibility. One could also consider the pd.Dataframe.to_sql() function when copying from a dataframe to an SQL table.

Assuming you have created the table you want, you could:

import psycopg2
import pandas as pd
data=pd.read_csv(r'path\to\file.csv', delimiter=' ')

#prepare your data and keep only relevant columns

data.drop(['col2', 'col4','col5'], axis=1, inplace=True)
data.dropna(inplace=True)
print(data.iloc[:3])


conn=psycopg2.connect("dbname=db user=postgres password=password")
cur=conn.cursor()

for index,row in data.iterrows():
      cur.execute('''insert into table (col1,col3,col6)
    VALUES (%s,%s,%s)''', (row['col1'], row['col3'], row['col6'])

cur.close()
conn.commit()

conn.close()
print('\n db connection closed.')

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.