DoltgreSQL 是 Postgres 版的 Dolt!

DoltgreSQL (又名 Doltgres)是世界上第一个版本控制 SQL 数据库 Dolt 的创建者推出的 Postgres 风格版本。Doltgres 为您的 Postgres 数据库架构和数据提供了所有 Git 风格的日志、差异、分支和合并功能。您可以使用 Postgres 客户端连接到 Doltgres，并使用 Postgres SQL，而不是使用 MySQL 客户端和 MySQL SQL。Doltgres 就像 Git 和 Postgres 的结合体。

文档

Doltgres 有一个包含更详细文档的文档网站。

动机

Dolt 最初是以 MySQL 风格构建的。 Dolt 中没有 MySQL 代码。2019 年，当我们构想 Dolt 时，MySQL 是最流行的 SQL 风格。在过去的 5 年里，趋势更多地转向了 Postgres，尤其是在年轻公司中，这些公司是 Dolt 的目标市场。潜在客户一直在呼吁 Dolt 的 Postgres 版本。

此外，Dolt 最初被构想和构建为数据版的 Git。 Dolt 后来成为版本控制数据库。 DoltgreSQL 让我们有机会剔除一些数据版 Git 的部分，如命令行界面，直接为版本控制数据库用例构建。使用 Doltgres，您可以启动服务器，连接客户端，并使用 SQL 完成所有操作，这对 Postgres 用户来说是一种熟悉的体验。

Doltgres 随着时间的推移将与 Dolt 有所不同，成为一个专注的数据库版本控制解决方案。话虽如此，我们在 Dolt 上已经有五年的领先优势。Dolt 如今是一个生产级的版本控制数据库。Dolt 已达到 1.0 版本。如果您可以接受使用 MySQL 客户端，我们建议在所有用例中使用 Dolt。Doltgres 目前还处于实验阶段。

您如何帮助

Doltgres 处于实验阶段。我们需要您的反馈来了解我们应该在多大程度上投资它。如果您有兴趣现在或将来使用 Doltgres，请：

为此仓库加星以表示您的兴趣。
尝试 Doltgres
如果发现错误，请创建问题
为您想要的缺失功能创建问题
为您想要的功能贡献代码（参见贡献指南）

入门

下载最新版本的 doltgres
将 doltgres 添加到您的 PATH
运行 doltgres。这将在 ~/doltgres/databases 中创建一个 doltgres 用户和一个 doltgres 数据库（添加 --data-dir 参数或更改 DOLTGRES_DATA_DIR 环境变量以使用不同的目录）。

$ doltgres
成功初始化 dolt 数据仓库。
使用配置 HP="localhost:5432"|T="28800000"|R="false"|L="info"|S="/tmp/mysql.sock" 启动服务器

确保您安装了 Postgres 15 或更高版本。我在 Mac 上使用 Homebrew 安装了 Postgres。这需要我手动将 /opt/homebrew/opt/postgresql@15/bin 添加到我的路径中。在 Postgres 14 或更低版本中， \ 命令（如 \d、\l）尚不适用于 Doltgres。

export PATH="/opt/homebrew/opt/postgresql@15/bin:$PATH"

打开一个新终端。使用以下命令连接：psql -h localhost -U doltgres。这将使用 doltgres 用户连接到 doltgres 数据库。

$ psql -h 127.0.0.1 -U doltgres
psql (15.4 (Homebrew), 服务器 15.0)
输入 "help" 获取帮助。

doltgres=>

创建 getting_started 数据库。创建 getting_started 示例表。

doltgres=> create database getting_started;
--
(0 行)

doltgres=> \c getting_started;
psql (15.4 (Homebrew), 服务器 15.0)
您现在已连接到数据库 "getting_started"，用户为 "doltgres"。
getting_started=> create table employees (
    id int8,
    last_name text,
    first_name text,
    primary key(id));
--
(0 行)

getting_started=> create table teams (
    id int8,
    team_name text,
    primary key(id));
--
(0 行)

getting_started=> create table employees_teams(
    team_id int8,
    employee_id int8,
    primary key(team_id, employee_id),
    foreign key (team_id) references teams(id),
    foreign key (employee_id) references employees(id));
--
(0 行)

getting_started=> \d
              关系列表
 架构  |       名称       | 类型  |  所有者   
-------+-----------------+-------+----------
 public | employees       | 表    | postgres
 public | employees_teams | 表    | postgres
 public | teams           | 表    | postgres
(3 行)

进行 Dolt 提交。

getting_started=> select * from dolt_status;
    表名         | 已暂存 |   状态   
-----------------+--------+-----------
 employees       | 0      | 新表
 employees_teams | 0      | 新表
 teams           | 0      | 新表
(3 行)

getting_started=> call dolt_add('teams', 'employees', 'employees_teams');
 状态 
--------
      0
(1 行)
getting_started=> select * from dolt_status; 
    表名         | 已暂存 |   状态   
-----------------+--------+-----------
 employees       | 1      | 新表
 employees_teams | 1      | 新表
 teams           | 1      | 新表
(3 行)

getting_started=> call dolt_commit('-m', '创建初始架构');
               哈希               
----------------------------------
 peqq98e2dl5gscvfvic71e7j6ne34533
(1 行)

查看 Dolt 日志。

getting_started=> select * from dolt_log;
           提交哈希             |  提交者  |       邮箱        |        日期         |          消息           
----------------------------------+-----------+--------------------+---------------------+----------------------------
 peqq98e2dl5gscvfvic71e7j6ne34533 | doltgres  | doltgres@127.0.0.1 | 2023-11-01 22:08:04 | 创建初始架构
 in7bk735qa6p6rv6i3s797jjem2pg4ru | timsehn   | tim@dolthub.com    | 2023-11-01 22:04:03 | 初始化数据仓库
(2 行)

继续参考 Dolt 入门指南来测试更多 Doltgres 版本控制功能。

从源代码构建

请按照贡献者指南学习如何从源代码构建。

限制

没有像 Dolt 中那样用于版本控制的 Git 风格命令行界面，只有 SQL 接口。
无法推送到 DoltHub 或 DoltLab，只能推送到自定义远程仓库。
对 Postgres 特定类型和函数的支持有限。
没有 Postgres 系统表。
没有身份验证或用户。
数据库和架构模型被合并。
对 SSL 连接的支持有限（仅支持非验证连接）。
不支持 GSSAPI。
没有实现 PostgreSQL 函数，因此只能使用 MySQL 函数。
不支持复制、集群等。

性能

根据标准的 Sysbench 测试套件测量，Dolt 的速度比 MySQL 慢 1.7 倍。

我们使用相同的 Sysbench 测试来对 DoltgreSQL 进行基准测试，并将结果与 PostgreSQL 进行比较。

以下是 DoltgreSQL 版本 0.4.0 的基准测试结果。

读取测试	PostgreSQL	DoltgreSQL	倍数
oltp_point_select	0.13	0.54	4.2
oltp_read_only	2.35	12.75	5.4
select_random_points	0.2	1.04	5.2
select_random_ranges	0.4	1.03	2.6
读取平均倍数			4.4

写入测试	PostgreSQL	DoltgreSQL	倍数
oltp_insert	0.78	3.02	3.9
oltp_read_write	3.89	20.37	5.2
oltp_update_index	0.81	3.19	3.9
oltp_update_non_index	0.78	3.13	4.0
oltp_write_only	1.37	7.56	5.5
写入平均倍数			4.5