跳转至

手动安装 Dosi

用编程 Agent?可以跳过这一页

对 Agent 说 按照 https://dosi.datus.ai/agent-install.md 安装 Dosi,它会自己装好一切; 快速上手里有完整流程。Python 用 pip install dosi-engine, 见 Python API。

一条命令就能在 Linux 或 macOS 上装好 dosi 和 dosi-server,不需要另外装任何东西: 不需要工具链、不需要数据库、不需要客户端库。

$ curl -fsSL https://dosi.datus.ai/install.sh | sh
$ curl -fsSL https://dosi.datus.ai/install.sh | DOSI_SHAPE=lean sh
$ curl -fsSL https://dosi.datus.ai/install.sh | DOSI_SOURCE=oss sh

脚本按你的系统和 CPU 下载对应的归档,校验 SHA-256,把 dosi 和 dosi-server 装到 ~/.local/bin;默认版还会把 DuckDB 的库文件放在旁边。这个目录不在 PATH 里的话,自己加上。 示例模型放在 ~/.local/share/dosi/examples。升级,或者在默认版和精简版之间切换,重新运行 脚本即可。

验证安装

$ dosi info
dosi       0.2.2
osi spec   0.3.0.dev0
datus-ext  1.14 (accepts 1.0 and up)
mode       datus
build      engine (DuckDB in process)
examples   /home/you/.local/share/dosi/examples
...

build 表示装的是哪个版本:默认版是 engine,精简版是 lean。examples 是示例模型所在 目录,文档里统一写作 $DOSI_EXAMPLES。设置好它,再确认模型能加载:

$ export DOSI_EXAMPLES=~/.local/share/dosi/examples
$ dosi validate --model $DOSI_EXAMPLES/orders/model.yaml
✓ 1 semantic model(s) valid

看到这一行,就可以继续命令行教程了。

选哪个版本?

选默认版。 只有机器上没有 C++ 运行时才选精简版:默认版在进程内运行 DuckDB,而 DuckDB 需要 libstdc++(GLIBCXX_3.4.22,GCC 6 及以上)。精简镜像、distroless 镜像和较老的发行版 是常见的原因。两个版本编译出的 SQL 一样,能连的数仓也一样,区别只在本地 DuckDB 查询。

默认版 精简版
本地 DuckDB 查询 进程内执行,Arrow 原生 通过 PATH 上的 duckdb 命令行执行
文件 dosi、dosi-server、libduckdb.so(macOS 上是 .dylib) dosi、dosi-server
Linux 上需要 glibc 2.28+、libstdc++ glibc 2.28+

精简版执行本地查询(--execute --db)时,运行 PATH 上的 duckdb 命令行;找不到时报 cannot start duckdb CLI。Dosi 针对 DuckDB 1.4.x 验证,遇到其他版本会提示一次。结果经 JSON 返回,所以大整数、DECIMAL 和 TIMESTAMPTZ 的表现取决于命令行版本。每条语句都在新进程里 执行,多次调用之间需要保留状态时,用数据库文件而不是内存数据库。

不用安装脚本

从发布页下载归档和 SHA256SUMS,校验后 安装文件:

$ VERSION=0.2.2 TARGET=x86_64-unknown-linux-gnu
$ BASE=https://github.com/Datus-ai/dosi-dist/releases/download/v$VERSION
$ curl -fsSLO $BASE/dosi-$VERSION-$TARGET.tar.gz
$ curl -fsSLO $BASE/SHA256SUMS
$ sha256sum --ignore-missing -c SHA256SUMS   # macOS: shasum -a 256 -c SHA256SUMS --ignore-missing
$ tar xzf dosi-$VERSION-$TARGET.tar.gz
$ sudo install dosi-$VERSION-$TARGET/dosi dosi-$VERSION-$TARGET/dosi-server /usr/local/bin/
$ sudo install -m 0644 dosi-$VERSION-$TARGET/libduckdb.so /usr/local/bin/
  • TARGET 取 x86_64-unknown-linux-gnu、aarch64-unknown-linux-gnu 或 aarch64-apple-darwin。精简版下载 dosi-$VERSION-$TARGET-lean.tar.gz,并跳过最后一行。 发布里的 manifest.json 列出了这次发布有哪些归档及其校验和。
  • 库文件要和可执行文件放在一起。 dosi 和 dosi-server 在自己所在的目录里找 libduckdb.so(macOS 上是 libduckdb.dylib),找不到就在启动时报 cannot open shared object file。移动可执行文件时,库文件一起带上。
  • 系统要求: Linux 需要 glibc 2.28 及以上(RHEL、Rocky、Alma 8,Ubuntu 20.04, Debian 10 及更新版本;CentOS 7 请用容器),macOS 需要 11 及以上。
  • 归档里还有: examples/,即安装脚本放到 ~/.local/share/dosi/examples 的示例模型; 以及 LICENSE,即 Elastic License 2.0。

安装脚本选项

在 sh 前面设置,例如 curl -fsSL https://dosi.datus.ai/install.sh | DOSI_SHAPE=lean sh。

变量 作用
DOSI_VERSION 安装指定版本(如 0.2.2),而不是最新版
DOSI_SHAPE=lean 安装精简版
DOSI_INSTALL_DIR 可执行文件的安装位置(默认 ~/.local/bin)
DOSI_SOURCE 下载来源:github(默认)、oss(阿里云镜像,中国大陆使用)或 cloudflare。不会自动换源:选定的来源失败,安装就失败
DOSI_OSS_MIRROR、DOSI_MIRROR 自建 OSS 或 Cloudflare 镜像的根地址,目录结构为 v<version>/<file>,manifest 另在 latest/manifest.json 放一份
DOSI_MANIFEST_URL 直接从这个地址读取 manifest

下一步