DBeaver 导出查询结果并保持字段类型的操作步骤

DBeaver 导出查询结果时，要同时保留数值内容和字段定义。CSV 本身不携带数据库类型；单独勾选引号或更换编码，不能让接收方自动识别 BIGINT、DECIMAL 或时间戳。可行做法是先记录查询结果列的类型、精度和空值约定，再导出未被展示格式改写的数据，接收方按这份定义读取。需要完整迁移表结构时，应另行提供 DDL 或采用数据库迁移流程。

例如订单编号被识别成数字后丢失前导零，金额被显示格式四舍五入，都会让“文件成功生成”与“数据可正确使用”变成两回事。下面以 CSV 加字段说明的交付方式操作，不把平面文件误当成数据库备份。

DBeaver Community 官方地址：https://dbeaver.io/

导出帮助：https://dbeaver.com/docs/dbeaver/Data-export/

步骤一：确认结果列类型并进入导出

先准备查询结果，选中结果网格中的单元格，在右侧 Panels → Metadata 查看列信息。记录列名、数据类型、长度、精度和小数位；计算表达式、拼接列和类型转换后的列，应按结果集元数据判断，不能只抄源表定义。

假设业务提供的结果列为下表。这是虚构的交付示例，实际以自己的驱动返回信息为准。

在结果网格右键选择 Export data，进入导出向导，选择 CSV 后点击 Next。可见确认状态是向导中的源对象确为当前查询结果，目标格式是 CSV；不要误从旁边的源表发起全表导出。

步骤二：设置数据读取范围与 CSV 表达

在向导的数据提取页面，决定是否使用 Use fetched rows。它只导出已经取回的结果；若网格还没加载完整数据，不能把它当成全量导出。需要重新读取数据时使用 Query the database，同时注意重新查询可能读到更新后的数据。只想导出选定部分才启用 Selected rows only 或 Selected columns only。

进入格式设置，建议以明确的 UTF-8 编码和列头交付，关闭 Format numbers，避免按地区习惯添加数字分组。NULL string 选择与真实数据不会混淆的标记，并在字段说明中记录。不存在通用的“永不冲突”标记，必须结合数据内容约定。

此时检查向导是否仍选中正确列，Format numbers 是否关闭，空值约定是否明确。字段中有分隔符、换行或引号时应使用一致的转义和引用规则；把所有值加引号也不保证表格软件会按文本导入。

如果此前使用了本地数据格式配置，留意数字分组、最大整数位数、最大小数位和舍入方式。DBeaver 的数据格式设置可影响值的显示；不要把金额只显示两位小数后的视觉结果，当成原数据只有两位。时间字段还需与接收方约定是否保留时区，避免省掉偏移量后产生歧义。

步骤三：保存文件并配套字段定义

在输出文件设置中选择本地保存位置，命名为 orders-export.csv，再到最终汇总页确认源、格式和目标文件。点击 Finish 开始导出；若当前版本显示 Proceed，先继续余下配置页，再在最后一页点击 Finish。

等待任务结束，确认任务没有报错或取消，再查看目标文件。把实际导出行数与所选范围对照，而不是只确认文件存在。若是重新查询导出，结果变化还可能来自并发更新，需要业务定义一致性时间点。

另建 orders-fields.txt，写入前面记录的列顺序、类型、精度、小数位、可空性、编码、分隔符、空值标记和时间约定。这里的说明文件由交付人整理，不是声称 DBeaver 会自动生成的功能。需要重建真实表结构时，DBeaver 提供独立的 SQL Generation 能力；查询中包含连接、聚合或计算列时，应设计与结果列匹配的目标表，而不是盲目套用任一源表 DDL。

接收文件时如何避免二次转换

接收方应按字段说明显式指定读取类型。订单号、超过消费工具精度能力的整数标识都应按约定的精确表示处理；金额采用十进制类型。不要双击文件后再保存，就假定原始字符和精度仍然不变。

最终交付抽取几类边界值对照：前导零文本、长编号、高精度金额、空串与 NULL、含偏移的时间。若要求保留完整数据库类型、默认值、约束及索引，应交付结构与数据配套的迁移成果，CSV 导出设置无法独自完成这一目标。

换成 JSON 就能保留 DECIMAL(18,4) 吗？

不能据此保证。JSON 有字符串、数字等值类型，但不携带 DECIMAL 的精度和小数位声明，消费端解析数字的方式也会影响精度。仍需约定字段模式和解析规则。

文件中看见金额四位小数，就算类型保留了吗？

这只说明文字表达可能符合预期。接收方仍可能按浮点数或文本处理，应检查其实际读取类型和精度规则。

为什么导出的记录比查询预期少？

先检查是否只导出了 fetched rows、选中行或选中列，再看查询条件和任务错误。结果网格显示了一部分记录，不代表所有记录都已经取回。

结果列元数据：https://dbeaver.com/docs/dbeaver/Metadata-Panel/。数据格式：https://dbeaver.com/docs/dbeaver/Managing-Data-Formats/。结构 SQL：https://dbeaver.com/docs/dbeaver/SQL-Generation/。