单反相机 0.4.0

数据库快照、列表和恢复

快速捕获您的本地Postgres数据库的快照。

这是什么？

DSLR是一个工具，允许您在编写数据库迁移、切换分支或操作SQL时快速创建和恢复数据库快照。

它旨在成为Stellar的精神继承者。

重要： DSLR仅适用于开发使用。不建议在生产数据库上使用DSLR。

性能

DSLR在快照方面比标准的pg_dump/pg_restore方法快得多。

与pg_dump/pg_restore方法相比，DSLR创建快照的速度快8倍，恢复快照的速度快3倍。

CREATE TABLE large_test (num1 bigint, num2 double precision, num3 double precision);

INSERT INTO large*test (num1, num2, num3)
SELECT round(random() * 10), random(), random() \_ 142
FROM generate_series(1, 20000000) s(i);

time dslr snapshot my-snapshot
time dslr restore my-snapshot
time pg_dump -Fc -f export.dump
time pg_restore --no-acl --no-owner export.dump

安装

pip install DSLR psycopg2 # or psycopg2-binary

使用pipx安装

pipx install DSLR[psycopg2] # or psycopg2-binary

注意：DSLR的export和import快照命令需要pg_dump和pg_restore在您的PATH中存在，因此如果您想使用这些命令，则需要Postgres CLI工具。

eval "$(_DSLR_COMPLETE=bash_source dslr)"

eval "$(_DSLR_COMPLETE=zsh_source dslr)"

eval (env _DSLR_COMPLETE=fish_source dslr)

_DSLR_COMPLETE=bash_source dslr > ~/.dslr-complete.bash

. ~/.dslr-complete.bash

_DSLR_COMPLETE=zsh_source dslr > ~/.dslr-complete.zsh

. ~/.dslr-complete.zsh

_DSLR_COMPLETE=fish_source dslr > ~/.config/fish/completions/dslr.fish

配置

您可以通过几种方式告诉DSLR要快照哪个数据库

DATABASE_URL

如果设置了DATABASE_URL环境变量，DSLR将使用它来连接到您的目标数据库。

export DATABASE_URL=postgres://username:password@host:port/database_name

dslr.toml

如果当前目录中存在dslr.toml文件，DSLR将从那里读取其设置。DSLR将优先考虑此设置而不是环境变量。

url = 'postgres://username:password@host:port/database_name'

--url选项

最后，您可以通过--url选项显式传递连接字符串。这将覆盖上述所有设置。

用法

$ dslr snapshot my-first-snapshot
Created new snapshot my-first-snapshot

$ dslr restore my-first-snapshot
Restored database from snapshot my-first-snapshot

$ dslr list

  Name                Created            Size
 ─────────────────────────────────────────────
  my-first-snapshot   2 minutes ago   3253 kB

$ dslr rename my-first-snapshot fresh-db
Renamed snapshot my-first-snapshot to fresh-db

$ dslr delete some-old-snapshot
Deleted some-old-snapshot

$ dslr export my-feature-test
Exported snapshot my-feature-test to my-feature-test_20220730-075650.dump

$ dslr import snapshot-from-a-friend_20220730-080632.dump friend-snapshot
Imported snapshot friend-snapshot from snapshot-from-a-friend_20220730-080632.dump

它如何工作？

DSLR通过使用Postgres的模板数据库功能来克隆数据库以获取快照。这是DSLR速度的主要来源。

这意味着创建快照只是使用主数据库作为模板创建一个新的数据库。还原快照只是删除主数据库并使用快照数据库作为模板创建一个新的数据库。如此类推。

贡献者

许可

MIT