pgsql2shp(1) PostGIS pgsql2shp(1)NAME
pgsql2shp - postgis to shapefile dumper
SYNTAX
pgsql2shp [options] database [schema.]table
pgsql2shp [options] database query
DESCRIPTION
The pgsql2shp table dumper connects directly to the database and converts a table (possibly created by user query) into a shape file. It is
compatible with all versions of PostGIS.
Version: 1.1.5 (2006/10/06)
USAGE
The <database> is the name of the database to connect to.
The <table> is the (optionally schema-qualified) table to read spatial data from. Alternatively, you can specify a QUERY whose result will
be written into the shapefile.
OPTIONS
The commandline options are:
-f <filename>
Write the output to a particular filename.
-h <host>
The database host to connect to.
-p <port>
The port to connect to on the database host.
-P <password>
The password to use when connecting to the database.
-u <user>
The username to use when connecting to the database.
-g <geometry column>
In the case of tables with multiple geometry columns, the geometry column to use when writing the shape file.
-b Use a binary cursor. When used on pre-1.0.0 PostGIS versions this will reduce the likelihood of coordinate drift due to conversion
to and from WKT format. Coordinate drifts will not occur with PostGIS 1.0.0 and newer versions. It will be slightly faster, but
might fail if any NON-gemetry column lacks a cast to text.
-r Raw mode. Do not drop the gid field, or escape column names.
-d For backward compatibility: write a 3-dimensional shape file when dumping from old (pre-1.0.0) postgis databases (the default is to
write a 2-dimensional shape file in that case). Starting from postgis-1.0.0+, dimensions are fully encoded.
-k Keep idendifiers case (don't uppercase field names).
-? Display version and usage information.
INSTALLATION
To compile the program from source, simply run "make" in the source directory. Then copy the binary in your shell search path (or wherever
you like). This text is also available as a man page in the ../doc/man/ directory, ready for copying it into the manual search path on
unixoid systems.
EXAMPLES
An example session using the dumper to create shape file from a database might look like this:
# pgsql2shp -f myfile -p 5555 my_db roads_table
AUTHORS
Originally written by Jeff Lounsbury <jeffloun@refractions.net>. Improved and maintained by Sandro Santilli <strk@refractions.net>.
Includes small contributions and improvements by others.
This application uses functionality from shapelib 1.2.9 by Frank Warmerdam <warmerda@gdal.velocet.ca> to write to ESRI Shape files.
SEE ALSO shp2pgsql(1)
More information is available at http://postgis.refractions.net
pgsql2shp(1)
Check Out this Related Man Page
shp2pgsql(1) PostGIS shp2pgsql(1)NAME
shp2pgsql - shapefile to postgis loader
SYNTAX
shp2pgsql [options] shapefile [schema.]table
DESCRIPTION
The shp2pgsql data loader converts ESRI Shape files into SQL suitable for insertion into a PostGIS/PostgreSQL database.
Version: 1.1.5 (2006/10/06)
USAGE
The <shapefile> is the name of the shape file, without any extension information. For example, 'roads' would be the name of the shapefile
comprising the 'roads.shp', 'roads.shx', and 'roads.dbf' files.
The <tablename> is the (optionally schema-qualified) name of the database table you want the data stored in in the database. Within that
table, the geometry will be placed in the 'geo_value' column by default.
OPTIONS
The loader has several operating modes distinguished by command line flags:
(Note that -a, -c, -d and -p are mutually exclusive.)
-d Drops the database table before creating a new table with the data in the Shape file.
-a Appends data from the Shape file into the database table. Note that to use this option to load multiple files, the files must have
the same attributes and same data types.
-c Creates a new table and populates it from the Shape file. This is the default mode.
-p Only produces the table creation SQL code, without adding any actual data. This can be used if you need to completely separate the
table creation and data loading steps.
-D Use the PostgreSQL "dump" format for the output data. This can be combined with -a, -c and -d. It is much faster to load than the
default "insert" SQL format. Use this for very large data sets.
-s <SRID>
Creates and populates the geometry tables with the specified SRID.
-g <geometry_column>
Specify the name of the geometry column (mostly useful in append mode).
-k Keep idendifiers case (column, schema and attributes). Note that attributes in Shapefile are usually all UPPERCASE.
-i Coerce all integers to standard 32-bit integers, do not create 64-bit bigints, even if the DBF header signature appears to warrant
it.
-S Generate simple Geometries instead of MULTIgeometries. Shape files don't differ between LINESTRINGs and MULTILINESTRINGs, so
shp2pgsql generates MULTILINESTRINGs by default. This switch will produce LINESTRINGs instead, but shp2pgsql will fail when it hits
a real MULTILINESTRING. The same works for POLYGONs vs. MULTIPOLYGONs.
-w Output WKT format, for use with older (0.x) versions of PostGIS. Note that this will introduce coordinate drifts and will drop M
values from shapefiles.
-W <encoding>
Specify the character encoding of Shapefile's attributes. If this option is used the output will be encoded in UTF-8.
-I Create a GiST index on the geometry column.
-N <policy>
Specify NULL geometries handling policy (insert,skip,abort).
-? Display version and usage information.
INSTALLATION
To compile the program from source, simply run "make" in the source directory. Then copy the binary in your shell search path (or wherever
you like). This text is also available as a man page in the ../doc/man/ directory, ready for copying it into the manual search path on
unixoid systems.
EXAMPLES
An example session using the loader to create an input file and uploading it might look like this:
# shp2pgsql shaperoads roadstable roadsdb > roads.sql
# psql -d roadsdb -f roads.sql
A conversion and upload can be done all in one step using UNIX pipes:
# shp2pgsql shaperoads roadstable roadsdb | psql -d roadsdb
AUTHORS
Originally written by Jeff Lounsbury <jeffloun@refractions.net>. Improved and maintained by Sandro Santilli <strk@refractions.net>.
Includes small contributions and improvements by others.
This application uses functionality from shapelib 1.2.9 by Frank Warmerdam <warmerda@gdal.velocet.ca> to read from ESRI Shape files.
SEE ALSO pgsql2shp(1)
More information is available at http://postgis.refractions.net
shp2pgsql(1)