mirror of
https://git.osgeo.org/gitea/postgis/postgis
synced 2024-10-24 09:02:37 +00:00
Added manual pages provided by Roberto Boati <roberto.boati@daisyred.com>
git-svn-id: http://svn.osgeo.org/postgis/trunk@1589 b70326c6-7e19-0410-871a-916f4a2858ee
This commit is contained in:
Sandro Santilli
parent
0ad94edf51
commit
1bd8b8dcc7
|
|
@ -66,5 +66,6 @@ clean:
|
|||
maintainer-clean: clean
|
||||
@rm -f html/*.html
|
||||
|
||||
install: html/postgis.html man/shp2pgsql.1 man/pgsql2shp.1
|
||||
|
||||
.PHONY: html
|
||||
|
|
|
|||
69
doc/man/pgsql2shp.1
Normal file
69
doc/man/pgsql2shp.1
Normal file
|
|
@ -0,0 +1,69 @@
|
|||
.TH "pgsql2shp" "1" "" "" "PostGIS"
|
||||
.SH "NAME"
|
||||
.LP
|
||||
pgsql2shp - postgis to shapefile dumper
|
||||
.SH "SYNTAX"
|
||||
.LP
|
||||
pgsql2shp [\fIoptions\fR] \fIdatabase\fR [\fIschema\fR\fB.\fR]\fItable\fR
|
||||
.br
|
||||
pgsql2shp [\fIoptions\fR] \fIdatabase\fR \fIquery\fR
|
||||
.SH "DESCRIPTION"
|
||||
.LP
|
||||
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.
|
||||
.SH "OPTIONS"
|
||||
.LP
|
||||
The commandline options are:
|
||||
|
||||
.TP
|
||||
\fB\-f\fR <\fIfilename\fR>
|
||||
Write the output to a particular filename.
|
||||
|
||||
.TP
|
||||
\fB\-h\fR <\fIhost\fR>
|
||||
The database host to connect to.
|
||||
|
||||
.TP
|
||||
\fB\-p\fR <\fIport\fR>
|
||||
The port to connect to on the database host.
|
||||
|
||||
|
||||
.TP
|
||||
\fB\-P\fR <\fIpassword\fR>
|
||||
The password to use when connecting to the database.
|
||||
|
||||
|
||||
.TP
|
||||
\fB\-u\fR <\fIuser\fR>
|
||||
The username to use when connecting to the database.
|
||||
|
||||
.TP
|
||||
\fB\-g\fR <\fIgeometry column\fR>
|
||||
In the case of tables with multiple geometry columns, the geometry column to use when writing the shape file.
|
||||
|
||||
.TP
|
||||
\fB\-b\fR
|
||||
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.
|
||||
|
||||
.TP
|
||||
\fB\-r\fR
|
||||
Raw mode. Do not drop the gid field, or escape column names.
|
||||
|
||||
.TP
|
||||
\fB\-d\fR
|
||||
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.
|
||||
|
||||
|
||||
.SH "AUTHORS"
|
||||
.LP
|
||||
Originally written by Jeff Lounsbury <jeffloun@refractions.net>.
|
||||
Improved and maintained by Sandro Santilli <strk@refractions.net>.
|
||||
|
||||
This application uses functionality from shapelib 1.2.9
|
||||
by Frank Warmerdam <warmerda@gdal.velocet.ca> to write to ESRI Shape files.
|
||||
.SH "SEE ALSO"
|
||||
.LP
|
||||
shp2pgsql(1)
|
||||
64
doc/man/shp2pgsql.1
Normal file
64
doc/man/shp2pgsql.1
Normal file
|
|
@ -0,0 +1,64 @@
|
|||
.TH "shp2pgsql" "1" "" "" "PostGIS"
|
||||
.SH "NAME"
|
||||
.LP
|
||||
shp2pgsql - shapefile to postgis loader
|
||||
.SH "SYNTAX"
|
||||
.LP
|
||||
shp2pgsql [\fIoptions\fR] \fIshapefile\fR [\fIschema\fR\fB.\fR]\fItable\fR
|
||||
.SH "DESCRIPTION"
|
||||
.LP
|
||||
The shp2pgsql data loader converts ESRI Shape files into SQL suitable for insertion into a PostGIS/PostgreSQL database. Produced output is NOT compatible
|
||||
with pre\-1.0.0 versions of PostGIS.
|
||||
.SH "OPTIONS"
|
||||
.LP
|
||||
The loader has several operating modes distinguished by command line flags:
|
||||
|
||||
.TP
|
||||
\fB\-d\fR
|
||||
Drops the database table before creating a new table with the data in the Shape file.
|
||||
|
||||
.TP
|
||||
\fB\-a\fR
|
||||
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.
|
||||
|
||||
.TP
|
||||
\fB\-c\fR
|
||||
Creates a new table and populates it from the Shape file. This is the default mode.
|
||||
|
||||
.TP
|
||||
\fB\-D\fR
|
||||
Creates a new table and populates it from the Shape file. This uses the PostgreSQL "dump" format for the output data and is much faster to load than the default "insert" SQL format. Use this for very large data sets.
|
||||
|
||||
.TP
|
||||
\fB\-s\fR <\fISRID\fR>
|
||||
Creates and populates the geometry tables with the specified SRID.
|
||||
|
||||
.TP
|
||||
\fB\-k\fR
|
||||
Keep idendifiers case (column, schema and attributes). Note that attributes in Shapefile are all UPPERCASE.
|
||||
|
||||
|
||||
.TP
|
||||
\fB\-i\fR
|
||||
Coerce all integers to standard 32\-bit integers, do not create 64\-bit bigints, even if the DBF header signature appears to warrant it.
|
||||
.SH "EXAMPLES"
|
||||
.LP
|
||||
An example session using the loader to create an input file and uploading it might look like this:
|
||||
|
||||
# \fBshp2pgsql shaperoads roadstable roadsdb > roads.sql\fR
|
||||
.br
|
||||
# \fBpsql \-d roadsdb \-f roads.sql\fR
|
||||
|
||||
A conversion and upload can be done all in one step using UNIX pipes:
|
||||
|
||||
# \fBshp2pgsql shaperoads roadstable roadsdb | psql \-d roadsdb\fR
|
||||
.SH "AUTHORS"
|
||||
.LP
|
||||
Originally written by Jeff Lounsbury <jeffloun@refractions.net>.
|
||||
Improved and maintained by Sandro Santilli <strk@refractions.net>.
|
||||
|
||||
This application uses functionality from shapelib 1.2.9
|
||||
by Frank Warmerdam <warmerda@gdal.velocet.ca> to read from ESRI Shape files.
|
||||
.SH "SEE ALSO"
|
||||
.LP
|
||||
pgsql2shp(1)
|
||||
Loading…
Reference in a new issue