GIS遥感数据工程【免费下载链接】gdalGDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.项目地址https://gitcode.com/gh_mirrors/gd/gdal点击查看免费下载导读gdal dataset是 GDAL 自 3.12 版本引入的、面向数据集文件级管理的统一子命令入口它把识别identify、完整性校验check、复制copy、重命名rename与删除delete五种常用操作收拢到同一个命名空间之下。本文以官方文档 gdal_dataset.rst 为核心骨架逐一详解五个子命令的选项、退出码语义与实战示例并结合 apps/gdalalg_dataset.cpp 等源码说明底层实现机制帮助你在日常数据管理中快速识别文件格式、批量校验数据完整性以及安全地复制、重命名和删除带伴生文件side-car files的完整数据集。gdal dataset总览一个入口、五类操作命令定位与版本gdal dataset是 GDAL 新版子命令式CLI即gdal 模块 操作 [选项]结构中的一个顶层命名空间对应源码 apps/gdalalg_dataset.cpp 中的GDALDatasetAlgorithm类版本GDAL 3.12 新增check子命令于 3.13 加入用途对数据文件执行多种管理操作包括识别数据类型、删除、重命名或复制文件能力范围不仅处理主文件还会联动处理伴生文件side-car/associated files例如.tfw世界文件、.aux、.msk等。从源码看GDALDatasetAlgorithm构造时通过RegisterSubAlgorithm()注册了五个子算法apps/gdalalg_dataset.cppRegisterSubAlgorithmGDALDatasetIdentifyAlgorithm(); RegisterSubAlgorithmGDALDatasetCheckAlgorithm(); RegisterSubAlgorithmGDALDatasetCopyAlgorithm(); RegisterSubAlgorithmGDALDatasetRenameAlgorithm(); RegisterSubAlgorithmGDALDatasetDeleteAlgorithm();注意GDALDatasetAlgorithm本身不可直接运行其RunImpl()会报错 The Run() method should not be called directly on the gdal dataset program.即它只是命令族容器必须搭配子命令使用。可用子命令一览子命令引入版本作用gdal dataset identify3.12识别能够打开数据集的一个或多个驱动drivergdal dataset check3.13检查读取数据集内容时是否存在错误gdal dataset copy3.12复制数据集文件含伴生文件gdal dataset rename3.12重命名数据集文件含伴生文件gdal dataset delete3.12删除一个或多个数据集含伴生文件通用退出码语义五个子命令均遵循 GDAL 新版 CLI 的统一返回码规范详见 return_code.rst成功返回状态码 0出错返回非零状态码例外以警告warning形式发出的非阻塞错误视为成功执行不影响返回码。check子命令在此基础上有特殊约定检测到读取错误时退出码为 1未检测到错误时退出码为 0详见下文。gdal dataset identify识别驱动与数据格式功能与基本用法gdal dataset identify用于报告能够打开一个或多个数据集的驱动名称。最基础的用法是直接指定文件$ gdal dataset identify NE1_50M_SR_W.tif NE1_50M_SR_W.tif: GTiff命令行入口的默认输出是文本格式从 Python APIgdal.Run(dataset, identify, ...)调用时默认输出为 JSON。这一点在源码 apps/gdalalg_dataset_identify.cpp 中有明确体现if (m_format.empty()) m_format IsCalledFromCommandLine() ? text : json;选项详解选项说明--filename FILENAME任意文件名或目录名必填可重复指定多个文件/目录-o, --output OUTPUT3.13指定输出矢量数据集输出字段至少包含filename与driver配合--detailed时还会包含layout如COG、file_list伴生文件列表、has_crs、has_geotransform、has_overview。注意该选项不是位置参数必须显式使用-o/--output开关后再跟名称-f, --of, --format, --output-format json\|text\|OTHER-VECTOR-FORMAT输出格式默认 JSONAPI 调用或 text命令行GDAL 3.13 起支持其他具备创建能力的矢量格式此时必须指定--output-r, --recursive递归扫描文件/文件夹以寻找数据集--force-recursive强制递归扫描文件夹即使文件夹本身被识别为有效格式也会继续深入递归--detailed3.13提高输出详细程度报告地理参考是否存在、GeoTIFF 是否云端优化COG等--report-failures对无法识别的文件类型也输出失败报告而不是静默跳过典型使用场景与示例场景一单文件识别JSON 输出$ gdal dataset identify --ofJSON NE1_50M_SR_W.tif[ { name: NE1_50M_SR_W.tif, driver: GTiff } ]场景二递归扫描目录批量报告数据格式$ gdal dataset identify -r 50m_raster/ NE1_50M_SR_W/ne1_50m.jpg: JPEG NE1_50M_SR_W/ne1_50m.png: PNG NE1_50M_SR_W/ne1_50m_20pct.tif: GTiff NE1_50M_SR_W/ne1_50m_band1.tif: GTiff NE1_50M_SR_W/ne1_50m_print.png: PNG NE1_50M_SR_W/NE1_50M_SR_W.aux: HFA NE1_50M_SR_W/NE1_50M_SR_W.tif: GTiff NE1_50M_SR_W/ne1_50m_sub.tif: GTiff NE1_50M_SR_W/ne1_50m_sub2.tif: GTiff可以看到递归模式会深入子目录并对每个文件包括.aux这样的伴生文件报告其识别到的驱动。场景三递归扫描并输出详细信息到 CSV$ gdal dataset identify --output out.csv --detailed -r 50m_raster/场景四检查 GeoTIFF 是否为云端优化COG配合--detailed可返回驱动与影像布局信息形如GTiff, layoutCOG, has CRS, has geotransform, has overview(s)$ gdal dataset identify /vsicurl/https://sentinel-cogs.s3.us-west-2.amazonaws.com/sentinel-s2-l2a-cogs/36/Q/WD/2020/7/S2A_36QWD_20200701_0_L2A/TCI.tif --detailed注意这里使用了/vsicurl/虚拟文件系统前缀说明该命令天然支持通过网络路径识别远端数据集。源码级实现要点从 apps/gdalalg_dataset_identify.cpp 可以看出 identify 的核心流程静默调用GDALIdentifyDriver(pszTarget, papszSiblingList)识别驱动——使用CPLQuietErrorHandler抑制识别失败时的错误噪音在--detailed模式下再以识别出的驱动名打开数据集GDALDataset::Open进一步提取layout仅对 GTiff 读取LAYOUT元数据项GDAL_MDD_IMAGE_STRUCTURE用于判断是否为 COGfile_list通过poDS-GetFileList()获得完整伴生文件清单has_crsGetSpatialRef() ! nullptrhas_geotransformGetGeoTransform()成功has_overview第一波段GetOverviewCount() 0根据输出目标分别生成文本行、JSON 数组或矢量要素写入filename/driver等字段。递归行为在Process()末尾实现当满足forceRecursive || (recursive 无识别结果)且目标是目录时遍历目录条目逐层下探并利用GDALCreateScaledProgress将子任务的进度缩放到整体进度区间。测试验证仓库自动化测试 autotest/utilities/test_gdalalg_dataset_identify.py 覆盖了典型行为JSON 输出gdal.Run(dataset, identify, filename../gcore/data/byte.tif)期望输出[{driver: GTiff, name: ../gcore/data/byte.tif}]文本输出期望得到../gcore/data/byte.tif: GTiff\n--report-failures对不存在的文件输出[{driver: None, name: /i_do/not/exist}]JSON或/i_do/not/exist: unrecognized文本递归模式filename../utilities/data, recursiveTrue能识别目录内的 Shapefile多文件输入可同时传入多个filename进度回调单调递增。gdal dataset check读取完整性校验功能与退出码语义gdal dataset check3.13检查读取数据集内容时是否存在错误检测到错误则程序退出码为 1或算法输出参数return-code置 1未检测到错误则退出码为 0。它接受栅格raster、矢量vector与多维栅格multidimensional raster三种类型的数据集。重要警告校验能力的边界官方文档明确给出了使用边界大多数驱动或数据格式没有内置的完整性机制。因此程序运行成功并不必然意味着数据集与刚生成时的状态完全一致。该程序执行的检查通常足以发现数据集相比预期大小被截断的情况但即使这一点对某些格式也不一定有保证例如 CSV 驱动可能无法检测出截断。选项选项说明--input FILENAME输入的矢量、栅格或多维数据集必填基本用法$ gdal dataset check NE1_50M_SR_W.tif源码级实现要点实现位于 apps/gdalalg_dataset_check.cppRunImpl()与CheckDataset()的检查逻辑覆盖了 GDAL 的全部三种数据模型子数据集subdatasets优先若数据集带有GDAL_MDD_SUBDATASETS元数据则先逐个打开并检查每个子数据集任一失败即置m_retCode 1并中止矢量图层通过GetLayers()遍历所有图层。若图层支持OLCFastGetArrowStream能力则优先走 Arrow 流GetArrowStream逐个批次读取要素否则退化为GetNextFeature()逐要素读取。出现CE_Failure即判定失败多维数组对根分组递归遍历CheckGroup对每个多维数组调用ProcessPerChunk()按块读取块缓冲区上限 10 MB见constexpr size_t BUFFER_SIZE 10 * 1024 * 1024;并释放动态内存类型常规栅格按GDALMD_INTERLEAVE元数据判断交错方式——PIXEL像素交错时对全部波段做一次窗口RasterIO否则逐波段IterateWindows(BUFFER_SIZE)分块读取每个窗口读取失败即置错误。进度计算方面代码以要素与像素等量换算RATIO_FEATURE_TO_PIXEL 100即 1 个要素 ≈ 100 个像素的计算/IO 代价来归一化进度百分比。测试验证测试文件 autotest/utilities/test_gdalalg_dataset_check.py 用于验证该命令对正常数据集的成功执行与对损坏数据的错误检测行为。gdal dataset copy复制数据集含伴生文件功能与选项gdal dataset copy创建数据集文件的副本包括可能的伴生/关联文件side-car files而不是像gdal_translate那样做格式转换。选项说明--source FILENAME源文件名或目录名必填--destination FILENAME目标文件名或目录名必填-f, --format FORMAT数据集格式帮助自动检测失败时的手动指定要求驱动具备GDAL_DCAP_OPEN能力分类为高级选项--overwrite允许覆盖已存在的目标文件/数据集默认情况下目标已存在会直接报错基本用法$ gdal dataset copy source.tif destination.tif覆盖行为与源码要点复制与重命名共享同一基类GDALDatasetCopyRenameCommonAlgorithmapps/gdalalg_dataset_copy.cpp其目标存在性检查逻辑非常严谨目标已存在且未指定--overwrite直接报错File/Dataset xxx already exists. Specify the --overwrite option to overwrite it.目标已存在且指定--overwrite根据存在类型处理——普通文件VSIUnlink()删除后继续目录拒绝操作报错要求用户手动删除源码注释明确We dont want the user to accidentally erase a non-GDAL dataset防止误删非 GDAL 数据集已识别的 GDAL 数据集调用GDALDriver::QuietDelete()安静删除后继续。随后调用GDALCopyDatasetFiles(hDriver, m_destination, m_source)完成文件级复制——这正是连同伴生文件一起复制的关键 API。可选的-f格式参数会通过GDALGetDriverByName()定位指定驱动否则依赖自动识别。gdal dataset rename重命名数据集含伴生文件功能与选项gdal dataset rename重命名数据集文件同样包含伴生文件。其选项与copy完全一致选项说明--source FILENAME源文件名或目录名必填--destination FILENAME目标文件名或目录名必填-f, --format FORMAT数据集格式覆盖自动格式检测--overwrite允许覆盖已存在的目标文件/数据集基本用法$ gdal dataset rename old_name.tif new_name.tif源码要点重命名同样走GDALDatasetCopyRenameCommonAlgorithm::RunImpl()差异仅在最后一行apps/gdalalg_dataset_copy.cppif (GetName() GDALDatasetCopyAlgorithm::NAME) return GDALCopyDatasetFiles(...) CE_None; else return GDALRenameDataset(hDriver, m_destination.c_str(), m_source.c_str()) CE_None;即底层调用GDALRenameDataset()完成连同伴生文件一起重命名覆盖检查逻辑与copy完全一致。测试见 autotest/utilities/test_gdalalg_dataset_rename.py。gdal dataset delete删除数据集含伴生文件功能与选项gdal dataset delete删除一个或多个数据集包括伴生/关联文件。选项说明--filename FILENAME任意文件名或目录名必填可重复指定多个-f, --format FORMAT数据集格式帮助自动检测失败时的手动指定要求驱动具备GDAL_DCAP_OPEN高级选项基本用法$ gdal dataset delete NE1_50M_SR_W.tif同时删除多个数据集$ gdal dataset delete NE1_50M_SR_W.tif other.tif源码要点实现位于 apps/gdalalg_dataset_delete.cpp对每个--filename调用GDALDeleteDataset(hDriver, datasetName)任一失败即整体返回失败。-f指定的驱动同样通过GDALGetDriverByName()解析。GDALDeleteDataset是驱动级删除 API驱动会负责清理包括伴生文件在内的全部关联文件。新旧 CLI 的对照与选型建议gdal dataset系列属于 GDAL 3.12 的新版子命令式 CLI。在选用时可以从以下几个角度权衡文件级 vs 内容级gdal dataset copy是原样复制文件适合备份、迁移、归档场景不会改变像素编码或压缩方式若需要转换格式、重投影或改变数据类型则应使用gdal_translate、gdalwarp等传统工具识别能力gdal dataset identify对目录递归批量识别 详细元数据报告COG 判定、伴生文件、CRS/地理变换/金字塔的覆盖比gdalinfo更适合脚本化的数据清点与质检安全性copy/rename的--overwrite对目录的保守处理拒绝自动删除非 GDAL 目录与delete的连伴生文件一并删除语义都体现了对误操作风险的防范设计。小结gdal dataset把数据集的五类文件级管理操作统一到单一命名空间配合--overwrite、--detailed、-r/--force-recursive、--report-failures等选项覆盖了识别 → 校验 → 复制 → 重命名 → 删除的完整数据管理链路。其底层分别映射到GDALIdentifyDriver、GDALDataset::Open、GDALCopyDatasetFiles、GDALRenameDataset、GDALDeleteDataset等驱动级 API并围绕伴生文件、子数据集、COG 布局、退出码等细节做了严谨设计。对于需要自动化处理大规模栅格/矢量数据集的工程实践这是一个值得优先掌握的新版 GDAL CLI 入口。进一步参考命令族总览文档doc/source/programs/gdal_dataset.rst各子命令文档gdal_dataset_identify.rst、gdal_dataset_check.rst、gdal_dataset_copy.rst、gdal_dataset_rename.rst、gdal_dataset_delete.rst实现源码apps/gdalalg_dataset.cpp 及同目录gdalalg_dataset_*.cpp自动化测试autotest/utilities/test_gdalalg_dataset.py 及同目录test_gdalalg_dataset_*.py赞分享GIS遥感数据工程【免费下载链接】gdalGDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.项目地址https://gitcode.com/gh_mirrors/gd/gdal点击查看免费下载相关推荐GDAL 文件管理机制详解RFC 12 的 GetFileList、重命名、复制与删除架构GDAL 文件管理机制详解RFC 12 的 GetFileList、重命名、复制与删除架构 本文围绕 GDAL 的官方设计文档 RFC 12: ImproveGIS遥感数据工程GDAL 命令行工具参数语法完全指南从符号约定到新一代 gdal 命令GDAL 命令行工具参数语法完全指南从符号约定到新一代 gdal 命令 导读 本文以 GDAL 官方文档《Syntax of arguments of coGIS遥感数据工程如何移除RedditVideoMakerBot命令行参数别名简单高效的配置优化指南如何移除RedditVideoMakerBot命令行参数别名简单高效的配置优化指南 RedditVideoMakerBot是一款强大的命令行工具能够帮助用户音视频工作流自动化上一篇Glances 常见问题排查指南编码、容器内存、依赖库与 Web UI 空白屏问题详解下一篇在 FAANG 团队中落地 Vibe Coding从设计文档到生产上线的完整 AI 协作工作流创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
GIS遥感数据工程【免费下载链接】gdalGDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.项目地址https://gitcode.com/gh_mirrors/gd/gdal点击查看免费下载导读gdal dataset是 GDAL 自 3.12 版本引入的、面向数据集文件级管理的统一子命令入口它把识别identify、完整性校验check、复制copy、重命名rename与删除delete五种常用操作收拢到同一个命名空间之下。本文以官方文档 gdal_dataset.rst 为核心骨架逐一详解五个子命令的选项、退出码语义与实战示例并结合 apps/gdalalg_dataset.cpp 等源码说明底层实现机制帮助你在日常数据管理中快速识别文件格式、批量校验数据完整性以及安全地复制、重命名和删除带伴生文件side-car files的完整数据集。gdal dataset总览一个入口、五类操作命令定位与版本gdal dataset是 GDAL 新版子命令式CLI即gdal 模块 操作 [选项]结构中的一个顶层命名空间对应源码 apps/gdalalg_dataset.cpp 中的GDALDatasetAlgorithm类版本GDAL 3.12 新增check子命令于 3.13 加入用途对数据文件执行多种管理操作包括识别数据类型、删除、重命名或复制文件能力范围不仅处理主文件还会联动处理伴生文件side-car/associated files例如.tfw世界文件、.aux、.msk等。从源码看GDALDatasetAlgorithm构造时通过RegisterSubAlgorithm()注册了五个子算法apps/gdalalg_dataset.cppRegisterSubAlgorithmGDALDatasetIdentifyAlgorithm(); RegisterSubAlgorithmGDALDatasetCheckAlgorithm(); RegisterSubAlgorithmGDALDatasetCopyAlgorithm(); RegisterSubAlgorithmGDALDatasetRenameAlgorithm(); RegisterSubAlgorithmGDALDatasetDeleteAlgorithm();注意GDALDatasetAlgorithm本身不可直接运行其RunImpl()会报错 The Run() method should not be called directly on the gdal dataset program.即它只是命令族容器必须搭配子命令使用。可用子命令一览子命令引入版本作用gdal dataset identify3.12识别能够打开数据集的一个或多个驱动drivergdal dataset check3.13检查读取数据集内容时是否存在错误gdal dataset copy3.12复制数据集文件含伴生文件gdal dataset rename3.12重命名数据集文件含伴生文件gdal dataset delete3.12删除一个或多个数据集含伴生文件通用退出码语义五个子命令均遵循 GDAL 新版 CLI 的统一返回码规范详见 return_code.rst成功返回状态码 0出错返回非零状态码例外以警告warning形式发出的非阻塞错误视为成功执行不影响返回码。check子命令在此基础上有特殊约定检测到读取错误时退出码为 1未检测到错误时退出码为 0详见下文。gdal dataset identify识别驱动与数据格式功能与基本用法gdal dataset identify用于报告能够打开一个或多个数据集的驱动名称。最基础的用法是直接指定文件$ gdal dataset identify NE1_50M_SR_W.tif NE1_50M_SR_W.tif: GTiff命令行入口的默认输出是文本格式从 Python APIgdal.Run(dataset, identify, ...)调用时默认输出为 JSON。这一点在源码 apps/gdalalg_dataset_identify.cpp 中有明确体现if (m_format.empty()) m_format IsCalledFromCommandLine() ? text : json;选项详解选项说明--filename FILENAME任意文件名或目录名必填可重复指定多个文件/目录-o, --output OUTPUT3.13指定输出矢量数据集输出字段至少包含filename与driver配合--detailed时还会包含layout如COG、file_list伴生文件列表、has_crs、has_geotransform、has_overview。注意该选项不是位置参数必须显式使用-o/--output开关后再跟名称-f, --of, --format, --output-format json\|text\|OTHER-VECTOR-FORMAT输出格式默认 JSONAPI 调用或 text命令行GDAL 3.13 起支持其他具备创建能力的矢量格式此时必须指定--output-r, --recursive递归扫描文件/文件夹以寻找数据集--force-recursive强制递归扫描文件夹即使文件夹本身被识别为有效格式也会继续深入递归--detailed3.13提高输出详细程度报告地理参考是否存在、GeoTIFF 是否云端优化COG等--report-failures对无法识别的文件类型也输出失败报告而不是静默跳过典型使用场景与示例场景一单文件识别JSON 输出$ gdal dataset identify --ofJSON NE1_50M_SR_W.tif[ { name: NE1_50M_SR_W.tif, driver: GTiff } ]场景二递归扫描目录批量报告数据格式$ gdal dataset identify -r 50m_raster/ NE1_50M_SR_W/ne1_50m.jpg: JPEG NE1_50M_SR_W/ne1_50m.png: PNG NE1_50M_SR_W/ne1_50m_20pct.tif: GTiff NE1_50M_SR_W/ne1_50m_band1.tif: GTiff NE1_50M_SR_W/ne1_50m_print.png: PNG NE1_50M_SR_W/NE1_50M_SR_W.aux: HFA NE1_50M_SR_W/NE1_50M_SR_W.tif: GTiff NE1_50M_SR_W/ne1_50m_sub.tif: GTiff NE1_50M_SR_W/ne1_50m_sub2.tif: GTiff可以看到递归模式会深入子目录并对每个文件包括.aux这样的伴生文件报告其识别到的驱动。场景三递归扫描并输出详细信息到 CSV$ gdal dataset identify --output out.csv --detailed -r 50m_raster/场景四检查 GeoTIFF 是否为云端优化COG配合--detailed可返回驱动与影像布局信息形如GTiff, layoutCOG, has CRS, has geotransform, has overview(s)$ gdal dataset identify /vsicurl/https://sentinel-cogs.s3.us-west-2.amazonaws.com/sentinel-s2-l2a-cogs/36/Q/WD/2020/7/S2A_36QWD_20200701_0_L2A/TCI.tif --detailed注意这里使用了/vsicurl/虚拟文件系统前缀说明该命令天然支持通过网络路径识别远端数据集。源码级实现要点从 apps/gdalalg_dataset_identify.cpp 可以看出 identify 的核心流程静默调用GDALIdentifyDriver(pszTarget, papszSiblingList)识别驱动——使用CPLQuietErrorHandler抑制识别失败时的错误噪音在--detailed模式下再以识别出的驱动名打开数据集GDALDataset::Open进一步提取layout仅对 GTiff 读取LAYOUT元数据项GDAL_MDD_IMAGE_STRUCTURE用于判断是否为 COGfile_list通过poDS-GetFileList()获得完整伴生文件清单has_crsGetSpatialRef() ! nullptrhas_geotransformGetGeoTransform()成功has_overview第一波段GetOverviewCount() 0根据输出目标分别生成文本行、JSON 数组或矢量要素写入filename/driver等字段。递归行为在Process()末尾实现当满足forceRecursive || (recursive 无识别结果)且目标是目录时遍历目录条目逐层下探并利用GDALCreateScaledProgress将子任务的进度缩放到整体进度区间。测试验证仓库自动化测试 autotest/utilities/test_gdalalg_dataset_identify.py 覆盖了典型行为JSON 输出gdal.Run(dataset, identify, filename../gcore/data/byte.tif)期望输出[{driver: GTiff, name: ../gcore/data/byte.tif}]文本输出期望得到../gcore/data/byte.tif: GTiff\n--report-failures对不存在的文件输出[{driver: None, name: /i_do/not/exist}]JSON或/i_do/not/exist: unrecognized文本递归模式filename../utilities/data, recursiveTrue能识别目录内的 Shapefile多文件输入可同时传入多个filename进度回调单调递增。gdal dataset check读取完整性校验功能与退出码语义gdal dataset check3.13检查读取数据集内容时是否存在错误检测到错误则程序退出码为 1或算法输出参数return-code置 1未检测到错误则退出码为 0。它接受栅格raster、矢量vector与多维栅格multidimensional raster三种类型的数据集。重要警告校验能力的边界官方文档明确给出了使用边界大多数驱动或数据格式没有内置的完整性机制。因此程序运行成功并不必然意味着数据集与刚生成时的状态完全一致。该程序执行的检查通常足以发现数据集相比预期大小被截断的情况但即使这一点对某些格式也不一定有保证例如 CSV 驱动可能无法检测出截断。选项选项说明--input FILENAME输入的矢量、栅格或多维数据集必填基本用法$ gdal dataset check NE1_50M_SR_W.tif源码级实现要点实现位于 apps/gdalalg_dataset_check.cppRunImpl()与CheckDataset()的检查逻辑覆盖了 GDAL 的全部三种数据模型子数据集subdatasets优先若数据集带有GDAL_MDD_SUBDATASETS元数据则先逐个打开并检查每个子数据集任一失败即置m_retCode 1并中止矢量图层通过GetLayers()遍历所有图层。若图层支持OLCFastGetArrowStream能力则优先走 Arrow 流GetArrowStream逐个批次读取要素否则退化为GetNextFeature()逐要素读取。出现CE_Failure即判定失败多维数组对根分组递归遍历CheckGroup对每个多维数组调用ProcessPerChunk()按块读取块缓冲区上限 10 MB见constexpr size_t BUFFER_SIZE 10 * 1024 * 1024;并释放动态内存类型常规栅格按GDALMD_INTERLEAVE元数据判断交错方式——PIXEL像素交错时对全部波段做一次窗口RasterIO否则逐波段IterateWindows(BUFFER_SIZE)分块读取每个窗口读取失败即置错误。进度计算方面代码以要素与像素等量换算RATIO_FEATURE_TO_PIXEL 100即 1 个要素 ≈ 100 个像素的计算/IO 代价来归一化进度百分比。测试验证测试文件 autotest/utilities/test_gdalalg_dataset_check.py 用于验证该命令对正常数据集的成功执行与对损坏数据的错误检测行为。gdal dataset copy复制数据集含伴生文件功能与选项gdal dataset copy创建数据集文件的副本包括可能的伴生/关联文件side-car files而不是像gdal_translate那样做格式转换。选项说明--source FILENAME源文件名或目录名必填--destination FILENAME目标文件名或目录名必填-f, --format FORMAT数据集格式帮助自动检测失败时的手动指定要求驱动具备GDAL_DCAP_OPEN能力分类为高级选项--overwrite允许覆盖已存在的目标文件/数据集默认情况下目标已存在会直接报错基本用法$ gdal dataset copy source.tif destination.tif覆盖行为与源码要点复制与重命名共享同一基类GDALDatasetCopyRenameCommonAlgorithmapps/gdalalg_dataset_copy.cpp其目标存在性检查逻辑非常严谨目标已存在且未指定--overwrite直接报错File/Dataset xxx already exists. Specify the --overwrite option to overwrite it.目标已存在且指定--overwrite根据存在类型处理——普通文件VSIUnlink()删除后继续目录拒绝操作报错要求用户手动删除源码注释明确We dont want the user to accidentally erase a non-GDAL dataset防止误删非 GDAL 数据集已识别的 GDAL 数据集调用GDALDriver::QuietDelete()安静删除后继续。随后调用GDALCopyDatasetFiles(hDriver, m_destination, m_source)完成文件级复制——这正是连同伴生文件一起复制的关键 API。可选的-f格式参数会通过GDALGetDriverByName()定位指定驱动否则依赖自动识别。gdal dataset rename重命名数据集含伴生文件功能与选项gdal dataset rename重命名数据集文件同样包含伴生文件。其选项与copy完全一致选项说明--source FILENAME源文件名或目录名必填--destination FILENAME目标文件名或目录名必填-f, --format FORMAT数据集格式覆盖自动格式检测--overwrite允许覆盖已存在的目标文件/数据集基本用法$ gdal dataset rename old_name.tif new_name.tif源码要点重命名同样走GDALDatasetCopyRenameCommonAlgorithm::RunImpl()差异仅在最后一行apps/gdalalg_dataset_copy.cppif (GetName() GDALDatasetCopyAlgorithm::NAME) return GDALCopyDatasetFiles(...) CE_None; else return GDALRenameDataset(hDriver, m_destination.c_str(), m_source.c_str()) CE_None;即底层调用GDALRenameDataset()完成连同伴生文件一起重命名覆盖检查逻辑与copy完全一致。测试见 autotest/utilities/test_gdalalg_dataset_rename.py。gdal dataset delete删除数据集含伴生文件功能与选项gdal dataset delete删除一个或多个数据集包括伴生/关联文件。选项说明--filename FILENAME任意文件名或目录名必填可重复指定多个-f, --format FORMAT数据集格式帮助自动检测失败时的手动指定要求驱动具备GDAL_DCAP_OPEN高级选项基本用法$ gdal dataset delete NE1_50M_SR_W.tif同时删除多个数据集$ gdal dataset delete NE1_50M_SR_W.tif other.tif源码要点实现位于 apps/gdalalg_dataset_delete.cpp对每个--filename调用GDALDeleteDataset(hDriver, datasetName)任一失败即整体返回失败。-f指定的驱动同样通过GDALGetDriverByName()解析。GDALDeleteDataset是驱动级删除 API驱动会负责清理包括伴生文件在内的全部关联文件。新旧 CLI 的对照与选型建议gdal dataset系列属于 GDAL 3.12 的新版子命令式 CLI。在选用时可以从以下几个角度权衡文件级 vs 内容级gdal dataset copy是原样复制文件适合备份、迁移、归档场景不会改变像素编码或压缩方式若需要转换格式、重投影或改变数据类型则应使用gdal_translate、gdalwarp等传统工具识别能力gdal dataset identify对目录递归批量识别 详细元数据报告COG 判定、伴生文件、CRS/地理变换/金字塔的覆盖比gdalinfo更适合脚本化的数据清点与质检安全性copy/rename的--overwrite对目录的保守处理拒绝自动删除非 GDAL 目录与delete的连伴生文件一并删除语义都体现了对误操作风险的防范设计。小结gdal dataset把数据集的五类文件级管理操作统一到单一命名空间配合--overwrite、--detailed、-r/--force-recursive、--report-failures等选项覆盖了识别 → 校验 → 复制 → 重命名 → 删除的完整数据管理链路。其底层分别映射到GDALIdentifyDriver、GDALDataset::Open、GDALCopyDatasetFiles、GDALRenameDataset、GDALDeleteDataset等驱动级 API并围绕伴生文件、子数据集、COG 布局、退出码等细节做了严谨设计。对于需要自动化处理大规模栅格/矢量数据集的工程实践这是一个值得优先掌握的新版 GDAL CLI 入口。进一步参考命令族总览文档doc/source/programs/gdal_dataset.rst各子命令文档gdal_dataset_identify.rst、gdal_dataset_check.rst、gdal_dataset_copy.rst、gdal_dataset_rename.rst、gdal_dataset_delete.rst实现源码apps/gdalalg_dataset.cpp 及同目录gdalalg_dataset_*.cpp自动化测试autotest/utilities/test_gdalalg_dataset.py 及同目录test_gdalalg_dataset_*.py赞分享GIS遥感数据工程【免费下载链接】gdalGDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.项目地址https://gitcode.com/gh_mirrors/gd/gdal点击查看免费下载相关推荐GDAL 文件管理机制详解RFC 12 的 GetFileList、重命名、复制与删除架构GDAL 文件管理机制详解RFC 12 的 GetFileList、重命名、复制与删除架构 本文围绕 GDAL 的官方设计文档 RFC 12: ImproveGIS遥感数据工程GDAL 命令行工具参数语法完全指南从符号约定到新一代 gdal 命令GDAL 命令行工具参数语法完全指南从符号约定到新一代 gdal 命令 导读 本文以 GDAL 官方文档《Syntax of arguments of coGIS遥感数据工程如何移除RedditVideoMakerBot命令行参数别名简单高效的配置优化指南如何移除RedditVideoMakerBot命令行参数别名简单高效的配置优化指南 RedditVideoMakerBot是一款强大的命令行工具能够帮助用户音视频工作流自动化上一篇Glances 常见问题排查指南编码、容器内存、依赖库与 Web UI 空白屏问题详解下一篇在 FAANG 团队中落地 Vibe Coding从设计文档到生产上线的完整 AI 协作工作流创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
