Ubuntu 或 Debian

本节介绍在您自己的 Linux 机器上使用 deb 包设置单节点 Citus 集群所需的步骤。

1. 安装 PostgreSQL 14 和 Citus 扩展

# Add Citus repository for package manager
curl https://install.citusdata.com/community/deb.sh | sudo bash

# install the server and initialize db
sudo apt-get -y install postgresql-14-citus-beta-11.0

2. 初始化集群

让我们在磁盘上创建一个新数据库。为了方便使用 PostgreSQL Unix domain socket 连接,我们将使用 postgres 用户。

# this user has access to sockets in /var/run/postgresql
sudo su - postgres

# include path to postgres binaries
export PATH=$PATH:/usr/lib/postgresql/14/bin

cd ~
mkdir citus
initdb -D citus

Citus 是一个 Postgres 扩展。要告诉 Postgres 使用这个扩展,你需要将它添加到一个名为 shared_preload_libraries 的配置变量中:

echo "shared_preload_libraries = 'citus'" >> citus/postgresql.conf

3. 启动数据库服务器

最后,我们将为新目录启动一个 PostgreSQL 实例:

pg_ctl -D citus -o "-p 9700" -l citus_logfile start

在上面,您将 Citus 添加到 shared_preload_libraries 中。 这使得它能够连接到 Postgres 的一些深层部分,从而替换`查询计划器(query planner)`和`执行器(executor)`。 在这里,我们加载 Citus 面向用户的一面(例如您将很快调用的函数):

psql -p 9700 -c "CREATE EXTENSION citus;"

4. 验证安装是否成功

要验证安装是否成功,并且 Citus 已安装:

psql -p 9700 -c "select citus_version();"

您应该看到 Citus 扩展的详细信息。

在此步骤中,您已完成安装过程并准备好使用您的 Citus 集群。 为了帮助您入门,我们提供了一个 tutorial, 其中包含有关在几分钟内使用示例数据设置 Citus 集群的说明。