HuggingFace Datasets中Arrow文件提取协议的性能优化
2025-05-11 14:34:23作者:史锋燃Gardner
在HuggingFace Datasets库的实际使用过程中,开发者发现当处理.arrow格式文件时,特别是在启用流式传输模式(streaming=True)的情况下,数据加载性能会出现显著下降。这个问题源于底层文件处理机制中的一个关键设计细节。
问题本质分析
Datasets库内部通过_get_extraction_protocol方法来确定文件的处理方式。该方法首先会检查文件扩展名是否属于已知类型列表,对于未明确列出的扩展名,则会启用"魔术数字"检测机制。这种检测方式需要读取文件头部字节来识别压缩格式,对于存储在远程存储(如S3)的大量文件来说,这种逐个文件的检测操作会带来显著的网络I/O开销。
技术实现细节
当前实现中,魔术数字检测主要针对常见压缩格式:
- ZIP格式(504B0304等)
- BZ2格式(425A68)
- GZIP格式(1F8B)
- XZ格式(FD377A585A00)
- LZ4格式(04224D18)
- ZSTD格式(28B52FFD)
然而,Apache Arrow作为一种列式内存格式,其文件签名未被包含在这个检测列表中。Arrow文件本身是未压缩的二进制格式,理论上不需要进行压缩格式检测。
优化方案
解决方案非常直观:将.arrow扩展名明确添加到已知扩展名列表中。这样当遇到Arrow格式文件时:
- 系统会直接跳过耗时的魔术数字检测
- 立即返回None(表示无需特殊解压处理)
- 显著减少远程存储访问次数
对用户的影响
这一优化将直接惠及以下场景的用户:
- 使用Arrow格式存储大规模数据集的用户
- 采用流式模式加载远程存储中数据的用户
- 需要高频访问大量小文件的分布式训练场景
最佳实践建议
虽然该优化已合并到主分支,但用户在使用时仍应注意:
- 确保Arrow文件确实采用标准格式存储
- 对于自定义的压缩Arrow文件,可能需要特殊处理
- 定期更新Datasets库以获取性能改进
这个案例很好地展示了在数据处理框架中,对文件格式处理的优化如何能带来整体性能的显著提升,特别是在涉及远程存储和流式处理的场景下。
登录后查看全文
热门项目推荐
相关项目推荐
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0214
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0138
uni-appA cross-platform framework using Vue.jsJavaScript08
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03
热门内容推荐
最新内容推荐
项目优选
收起
deepin linux kernel
C
32
16
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
469
465
暂无描述
Dockerfile
778
5.08 K
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。
C++
877
2.03 K
Ascend Extension for PyTorch
Python
758
968
本项目是CANN提供的神经网络类计算算子库,实现网络在NPU上加速计算。
C++
697
1.4 K
昇腾LLM分布式训练框架
Python
185
231
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
1.1 K
1.14 K
本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本,由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用,3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。
Dart
1.04 K
271
JiuwenSwarm 是一款基于openJiuwen开发的智能AI Agent,它能够将大语言模型的强大能力,通过你日常使用的各类通讯应用,直接延伸至你的指尖。
Python
2.25 K
677