手动安装 Dosi¶
用编程 Agent?可以跳过这一页
对 Agent 说 按照 https://dosi.datus.ai/agent-install.md 安装 Dosi,它会自己装好一切;
快速上手里有完整流程。Python 用 pip install dosi-engine,
见 Python API。
一条命令就能在 Linux 或 macOS 上装好 dosi 和 dosi-server,不需要另外装任何东西:
不需要工具链、不需要数据库、不需要客户端库。
脚本按你的系统和 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 |
下一步¶
-
从内置模型走到能自己核对的真实结果,大约十分钟。
-
把 Dosi 接到 Postgres、Snowflake、ClickHouse 等数仓。
-
在 Python 里加载模型、执行查询。