数据导出功能,用于将查询结果集或者 Apache Doris 的表数据,使用指定的文件格式,写入指定的存储系统中的。

导出功能和数据备份功能有以下区别:

数据导出数据备份
数据最终存储位置HDFS、对象存储、本地文件系统HDFS、对象存储
数据格式Parquet、ORC、CSV 等开放格式Apache Doris 内部存储格式
执行速度中等(需要读取数据并转换成目标数据格式)快速(无需解析和转换,直接上传 Apache Doris 数据文件)
灵活度可以通过 SQL 语句灵活定义要导出的数据仅支持表级别全量备份
使用场景结果集下载、不同系统之间的数据交换数据备份、Apache Doris 集群间的数据迁移

选择导出方式

Apache Doris 提供以下三种不同的数据导出方式:

  • SELECT INTO OUTFILE:支持任意 SQL 结果集的导出。
  • EXPORT:支持表级别的部分或全部数据导出。
  • MySQL DUMP:兼容 MySQL Dump 指令的数据导出。

三种导出方式的异同点如下:

SELECT INTO OUTFILEEXPORTMySQL DUMP
同步/异步同步异步(提交 EXPORT 任务后通过 SHOW EXPORT 命令查看任务进度)同步
支持任意 SQL支持不支持不支持
导出指定分区支持支持不支持
导出指定 Tablets支持不支持不支持
并发导出支持且并发高(但取决于 SQL 语句是否有 ORDER BY 等需要单机处理的算子)支持且并发高(支持 Tablet 粒度的并发导出)不支持,只能单线程导出
支持导出的数据格式Parquet、ORC、CSVParquet、ORC、CSVMySQL Dump 专有格式
是否支持导出外表支持部分支持不支持
是否支持导出 View支持支持支持
支持的导出位置S3、HDFS、LOCALS3、HDFS、LOCALLOCAL

SELECT INTO OUTFILE

适用于以下场景:

  • 导出数据需要经过复杂计算逻辑的,如过滤、聚合、关联等。
  • 适合执行同步任务的场景。

EXPORT

适用于以下场景:

  • 大数据量的单表导出、仅需简单的过滤条件。
  • 需要异步提交任务的场景。

MySQL Dump

适用于以下场景:

  • 兼容 MySQL 生态,需要同时导出表结构和数据。
  • 仅用于开发测试或者数据量很小的情况。

导出文件列类型映射

Parquet、ORC 文件格式拥有自己的数据类型。Apache Doris 的导出功能能够自动将 Apache Doris 的数据类型导出为 Parquet、ORC 文件格式的对应数据类型。CSV 格式没有类型,所有数据都以文本形式输出。

以下是 Apache Doris 数据类型和 Parquet、ORC 文件格式的数据类型映射关系表:

  1. Doris 导出到 Orc 文件格式的数据类型映射表:

    Doris TypeOrc Type
    booleanboolean
    tinyinttinyint
    smallintsmallint
    intint
    bigintbigint
    largeIntstring
    datestring
    datev2string
    datetimestring
    datetimev2timestamp
    floatfloat
    doubledouble
    char / varchar / stringstring
    decimaldecimal
    structstruct
    mapmap
    arrayarray
    json不支持
  2. Apache Doris 导出到 Parquet 文件格式时,会先将 Apache Doris 内存数据转换为 Arrow 内存数据格式,然后由 Arrow 写出到 Parquet 文件格式。Apache Doris 数据类型到 Arrow 数据类的映射关系为:

    Doris TypeArrow Type
    booleanboolean
    tinyintint8
    smallintint16
    intint32
    bigintint64
    largeIntutf8
    dateutf8
    datev2Date32Type
    datetimeutf8
    datetimev2TimestampType
    floatfloat32
    doublefloat64
    char / varchar / stringutf8
    decimaldecimal128
    structstruct
    mapmap
    arraylist
    jsonutf8