Umbra‐DB的商业化版本CedarDB的安装和使用 - l1t1/note GitHub Wiki

Umbra-DB的商业化版本CedarDB的安装和使用

二进制文件安装

curl https://get.cedardb.com | bash

安装程序在当前目录下建立子目录cedar后, 把二进制文件cedardb保存在那里。

其中还有一个简明的README文档, 用deepseek翻译如下:

CedarDB - 快速入门指南

CedarDB是一款关系型数据库管理系统,支持与PostgreSQL语法相似的标准SQL。您可以通过以下两种方式使用:

  • 本地交互模式:cedardb --interactive REPL环境
  • 客户端连接模式:通过PostgreSQL有线协议与cedardb服务端通信(兼容psql客户端)

CedarDB实现了与PostgreSQL的SQL语言兼容,完整功能文档请参阅:官方文档

安装说明

CedarDB可独立运行无需系统依赖,当前仅支持Linux系统。

使用模式

CedarDB提供两种主要交互模式:

交互模式(interactive)

提供直接操作数据库的交互式Shell:

# 创建新数据库(将在mydb子目录生成数据文件)
./cedardb --interactive --createdb mydb
# 查看所有参数选项:
./cedardb --help

在Shell中可直接执行SQL命令,导入数据示例:

create table example(i int);
copy example from 'example.csv' delimiter '|' null 'null';

完整语法参考:SQL语法文档

REPL环境支持常用快捷键:

  • CTRL+R 历史命令搜索
  • \i 执行SQL脚本文件
  • \? 查看所有命令帮助

服务端模式(server)

不添加interactive参数时,CedarDB以服务进程模式运行。首次启动时仅允许同系统用户通过本地域套接字连接:

# 启动服务(需预先创建数据库)
./cedardb mydb

# 另启终端以postgres超级用户连接:
psql -h /tmp -U postgres

通过SQL管理用户权限:

-- 创建管理用户
create user test superuser;  -- 可细化权限分配
create database test;
alter user test with password '1234';

配置网络访问:

# 启动服务监听所有网络接口(::表示IPv4/IPv6)
./server mydb/test.db --address=::

# 本地连接
psql -h localhost -U test
# 远程连接
psql -h cedardb.example.com -U test

资源管理

默认配置:

  • 内存分配:40%用于页面缓存,40%用于工作内存
  • 线程使用:自动调用全部CPU线程

自定义配置示例:

# 调整缓存大小
export BUFFERSIZE=1G

# 限制线程数(影响性能)
export PARALLEL=8

# 降低CPU优先级保证系统响应
nice ./cedardb mydb

版权声明

(c) CedarDB GmbH 保留所有权利
第三方组件许可信息查看:

./cedardb -license

初步使用感受

  • 兼容PostgreSQL语法,包括SQL和CLI命令
  • 速度快,约为DuckDB的2倍
  • 占内存大,可用环境变量设置,但执行过程还是会OOM
  • 界面简陋