Кластеры Citus с одним узлом в Ubuntu или Debian

В этом разделе описаны шаги, необходимые для настройки кластера Citus с одним узлом на собственном компьютере Linux из пакетов deb.

1. Установите PostgreSQL 17 и расширение Citus

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

# install the server and initialize db
:::moniker range="<=citus-12"
sudo apt-get -y install postgresql-16-citus-12.1
:::moniker-end
:::moniker range="=citus-13"
sudo apt-get -y install postgresql-17-citus-13.0
:::moniker-end
:::moniker range=">=citus-14"
sudo apt-get -y install postgresql-18-citus-14.0
:::moniker-end

2. Инициализация кластера

Создайте базу данных на диске. Для удобства при подключении сокета домена PostgreSQL Unix используйте пользователя postgres.

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

# include path to PostgreSQL binaries
:::moniker range="<=citus-12"
export PATH=$PATH:/usr/lib/postgresql/16/bin
:::moniker-end
:::moniker range="=citus-13"
export PATH=$PATH:/usr/lib/postgresql/17/bin
:::moniker-end
:::moniker range=">=citus-14"
export PATH=$PATH:/usr/lib/postgresql/18/bin
:::moniker-end

cd ~
mkdir citus
initdb -D citus

Citus — это расширение PostgreSQL. Чтобы сообщить PostgreSQL использовать это расширение, добавьте его в переменную конфигурации с именем 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, Citus интегрируется с некоторыми глубокими частями PostgreSQL, заменяя планировщик запросов и исполнитель. Здесь вы загружаете пользовательную сторону Citus, например функции для вызова:

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

4. Убедитесь, что установка выполнена успешно

Чтобы убедиться, что установка выполнена успешно, и Citus установлен:

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

Вы увидите сведения о расширении Citus.

После завершения процесса установки вы будете готовы использовать кластер Citus. Чтобы помочь вам начать, см. Мультитенантные приложения. В этом руководстве содержатся инструкции по настройке кластера Citus с примерными данными за считанные минуты.

Связанный контент

  • Last updated on