shp2pgsql 导入 Shp 到 PostGIS 空间数据库

news2025/5/25 4:18:33

前言

❝
shp2pgsql是PostGIS自带的命令行工具，用于将Shapefile文件声称SQL脚本导入到PostGIS空间数据库。

1. 安装 PostGIS

通过Application Stack Builder或者下载单独的PostGIS包进行安装。而shp2pgsql则是与PostGIS工具集成在一起，无需单独下载。该命令行工具可以在安装路径下的bin目录中找到。

也可以打开shp2pgsql图形界面工具，也就是上一节中的PostGIS Bundle for PostgreSQL来导入Shp数据。

2. shp2pgsql 选项参数

基本语法：

shp2pgsql [OPTIONS] shapefile路径 [schema.]table > roads.sql（输出SQL路径）

shp2pgsql [OPTIONS] shapefile路径 [schema.]table

选项介绍：

选项名称	选项描述	选项示例
`-c\|-a\|-d\|-p`	互斥选项，只能选择一个 `-c`：创建新表并从`Shapefile`填充它。这是默认模式。 `-a`：将`Shapefile`中的数据追加到数据库表中。要主义的是使用此选项加载多个文件，这些文件必须具有相同的属性和相同的数据类型。 `-d`：在使用`Shapefile`中的数据创建新表之前，先删除数据库表。 `-p`：只生成表创建`SQL`代码，不添加任何实际数据。如果需要完全分离表创建和数据加载步骤，可以使用此方法。	`shp2pgsql -c -D -s 4269 -i -I shaperoads.shp myschema.roadstable > roads.sql`
`-D`	输出数据使用`PostgreSQL`“转储”格式。这可以与-`a、-c`和`-d`组合使用。它的加载速度比默认的“插入”`SQL`格式快得多。将其用于非常大的数据集。
`-s [<FROM_SRID>:]<SRID>`	使用指定的`SRID`创建并填充几何图形表。可选地指定输入`shapefile`使用给定的`FROM_SRID`，在这种情况下，几何图形将被重新投影到目标`SRID`。	shp2pgsql -s 4326 C:countries.shp public.countriesSQL>C:countries.sql
`-k`	保持标识符的大小写（列、模式和属性）。请注意，`Shapefile`中的属性都是大写的。
`-i`	将所有整数强制转换为标准的32位整数，即使`DBF`标头签名似乎保证了这一点，也不要创建64位大整数。
`-I`	在几何体列上创建GiST索引。
`-m`	-m a_file_name指定一个文件，其中包含一组（长）列名到10个字符的DBF列名的映射。文件的内容是一行或多行两个名称，用空格分隔，没有尾随或前导空格。例如： COLUMNNAME DBFFIELD1 AVERYLONGCOLUMNNAME DBFFIELD2
`-S`	生成简单的几何图形，而不是`MULTIPOLYGON`。只有当所有几何体实际上都是单一的（即具有单个壳的多边形，或具有单个顶点的多边形）时，才能成功。
`-t <dimensionality>`	强制输出几何体具有指定的维度。使用以下字符串表示维度：`2D、3DZ、3DM、4D。` 如果输入的维度比指定的少，则输出将用零填充这些维度。如果输入具有指定的更多尺寸，则不需要的尺寸将被删除。
`-w`	输出`WKT`格式，而不是`WKB`。请注意，由于精度损失，这可能会引入坐标漂移。
`-e`	不使用事务，单独执行每条语句。当存在一些会产生错误的不良几何形状时，这允许加载大多数好数据。请注意，这不能与-D标志一起使用，因为“转储”格式总是使用事务。
`-W`	指定输入数据的编码（`dbf`文件）。使用时，`dbf`的所有属性都会从指定的编码转换为`UTF8`。生成的`SQL`输出将包含一个SET CLIENT_ENCODING to UTF8命令，以便后端能够从`UTF8`重新转换为数据库内部配置使用的任何编码。	shp2pgsql -s 4326 -I -W "UTF-8" C:countries.shp public.countriesSQL>C:countries.sql
`-N <policy>`	`NULL`几何处理策略（`insert*,skip,abort`）
`-n`	`-n`仅导入`DBF`文件。如果您的数据没有相应的`shapefile`，它将自动切换到此模式并仅加载`dbf`。因此，只有当您有一个完整的`shapefile`集，并且只需要属性数据而不需要几何体时，才需要设置此标志。
`-G`	在`WGS84`长纬度（`SRID=4326`）中使用地理类型而不是几何形状（需要经度/纬度数据）
`-T <tablespace>`	指定新表的表空间。除非同时使用`-X`参数，否则索引仍将使用默认表空间。`PostgreSQL`文档对何时使用自定义表空间有很好的描述。
`-X <tablespace>`	为新表的索引指定表空间。这适用于主键索引，也适用于`GIST`空间索引`if -I`。
`-Z`	使用此标志时，将阻止生成`ANALYZE`语句。如果没有`-Z`标志（默认行为），将生成`ANALYZE`语句。
`-?`	显示帮助	`shp2pgsql -?`