dbn-cli

此包提供 CLI 工具 dbn，用于将 Databento 二进制编码 (DBN) 文件转换为文本格式，以及将旧版 DBZ 文件更新为 DBN。

有关 DBN 的更多信息，请参阅我们的 DBN 简介。

安装

要安装最新版本，请运行以下命令

cargo install dbn-cli

用法

dbn 目前支持 CSV 和 JSON（技术上为 行分隔 JSON）作为输出格式。默认情况下，dbn 将结果输出到标准输出，以便与基于文本的命令行实用程序一起使用。运行

dbn some.dbn --csv --limit 5

将在控制台打印出 some.dbn 的标题行和前 5 行数据，以 CSV 格式。同样，运行

dbn ohlcv-1d.dbn.zst --json | jq '.high'

将仅从 ohlcv-1d.dbn.zst 中提取高价。 dbn 可与未压缩和 Zstandard 压缩的 DBN 文件一起使用。

您还可以通过运行以下命令将结果直接保存到另一个文件

dbn some.dbn.zst --json --output some.json

dbn 将创建一个新文件 some.csv，其中包含从 some.dbn.zst 中的数据，格式化为 JSON。

当文件名通过 --output 或 -o 传递并以 .json 或 .csv 结尾时，可以省略 --json 和 --csv 标志。

dbn another.dbn.zst -o data.csv

这将把 another.dbn.zst 的内容以 CSV 格式写入到 data.json 中。

默认情况下，dbn 不会覆盖现有文件。要替换现有文件的内容并允许覆盖文件，请传递 -f 或 --force 标志。

压缩输出

除了读取 Zstandard 压缩文件外，dbn 还可以写入压缩的 JSON 和 CSV。

dbn ohlcv-1d.dbn -o ohclv-1d.json.zst

或显式地

dbn ohlcv-1d.dbn --json --zstd -o ohlcv-1d.json.zst

将 DBZ 文件转换为 DBN

DBN 是 DBZ 的演进，它需要 Zstandard。要将旧 DBZ 文件更新为 Zstandard 压缩 DBN，请运行

dbn 20221212.mbo.dbz -o 20221212.dbn.zst

或通过传递 --dbn 显式设置输出编码。

读取和写入片段

dbn 还可以读取和写入没有元数据头的 DBN 文件，这些称为“DBN 片段”。通过传递 --input-fragment 或 --input-zstd-fragment 标志来读取没有元数据头的 DBN 文件。

dbn 120000_121000.mbo.dbn.frag --input-fragment --json

您还可以使用 --fragment 或 -F 标志写入没有元数据头的 DBN 文件。

dbn ohlcv-1d.dbn -F -o ohlcv-1d.dbn.frag

许可证

根据 Apache 2.0 许可证 发布。