⌘+k ctrl+k
1.1.3 (stable)
Search Shortcut cmd + k | ctrl + k
GDAL Integration

空间扩展集成了GDAL翻译库,用于读取和写入各种地理空间矢量文件格式的空间数据。有关如何在实践中使用此功能的详细信息,请参阅st_read表函数的文档。

为了使用户不必在系统上设置和安装额外的依赖项,空间扩展捆绑了其自己的GDAL库副本。这也意味着空间扩展的GDAL版本可能不是最新的,或者不支持系统范围内GDAL安装所支持的所有文件格式。请参阅关于st_drivers表函数的部分,以检查当前可用的GDAL驱动程序。

基于GDAL的COPY函数

空间扩展不仅支持通过ST_Read函数导入地理空间文件格式,还支持通过基于GDAL的COPY函数将DuckDB表导出为不同的地理空间矢量格式。

例如,要将表导出为带有生成边界框的GeoJSON文件,您可以使用以下查询:

COPY table TO 'some/file/path/filename.geojson'
WITH (FORMAT GDAL, DRIVER 'GeoJSON', LAYER_CREATION_OPTIONS 'WRITE_BBOX=YES');

可用选项:

  • FORMAT: 是唯一必需的选项,必须设置为 GDAL 以使用基于 GDAL 的复制函数。
  • DRIVER: 是用于导出的GDAL驱动程序。使用 ST_Drivers() 列出所有可用驱动程序的名称。
  • LAYER_CREATION_OPTIONS: 传递给GDAL驱动程序的选项列表。请参阅您正在使用的GDAL驱动程序的文档以获取可用选项的列表。
  • SRS: 设置一个空间参考系统作为元数据用于导出。这可以是一个WKT字符串、一个EPSG代码或一个proj字符串,基本上任何你通常可以传递给GDAL的内容。请注意,这不会对输入几何进行任何重投影,它只是设置元数据,如果目标驱动程序支持的话。

Limitations

请注意,GDAL集成仅支持基于矢量的驱动程序。不支持读取和写入栅格格式。