Установка PipelineDB
Порядок установки PostgreSQL
Поскольку PipelineDB работает как расширение для PostreSQL, начните с установки PostgreSQL.
Примечание
На данный момент PipelineDB поддерживает версии PostgreSQL 10.1, 10.2, 10.3, 10.4, 10.5 и 11.0 на 64-битных архитектурах.
После установки PostgreSQL на своей системе, нужно установить бинарные файлы PipelineDB, а затем создать расширение PipelineDB в базе данных PostgreSQL. Можно установить бинарные файлы из наших репозиториев apt или yum, или загрузить пакеты из наших архивов и установить их напрямую.
apt
Сначала добавьте наш репозиторий apt в свою систему (inspect apt.sh):
curl -s http://download.pipelinedb.com/apt.sh | sudo bash
Теперь необходимо установить последний пакет PipelineDB:
\# PostgreSQL 10 sudo apt-get install pipelinedb-postgresql-10
\# PostgreSQL 11 sudo apt-get install pipelinedb-postgresql-11
yum
Добавьте наш репозиторий yum в свою систему (inspect yum.sh):
curl -s http://download.pipelinedb.com/yum.sh | sudo bash
Установите последний пакет PipelineDB:
\# PostgreSQL 10 sudo yum install pipelinedb-postgresql-10
\# PostgreSQL 11 sudo yum install pipelinedb-postgresql-11
Примечание
репозитории apt и yum нужно будет добавить в систему только один раз. После добавления репозиториев не нужно будет запускать эти скрипты снова. Чтобы получить новые версии PipelineDB нужно просто запустить команду установки.
Вы также можете загрузить бинарные пакеты из наших архивов и установить их напрямую.
Пакеты RPM
Чтобы установить пакет RPM PipelineDB, выполните:
sudo rpm -ivh pipelinedb-postgresql-<pg version>_<pipelindb version>.rpm
Пакеты Debian
Чтобы установить пакет Debian PipelineDB, выполните:
sudo dpkg -i pipelinedb-postgresql-<pg version>_<pipelindb version>.deb
Создание расширения PipelineDB
Для работы PipelineDB параметр конфигурации shared_preload_libraries
должен быть настроен в postgresql.conf
, который находится под вашим каталогом данных. Также рекомендуется установить max_worker_processes
на достаточно высокое значение, чтобы обеспечить рабочим процессам PipelineDB достаточно мощности:
# At the bottom of <data directory>/postgresql.conf
shared_preload_libraries = 'pipelinedb'
max_worker_processes = 128
Запуск PostgreSQL
Чтобы запустить сервер PostgreSQL в фоновом режиме, используйте драйвер pg_ctl
и укажите новый инициализированный каталог данных:
pg_ctl -D <data directory> -l postgresql.log start
Чтобы подключиться к работающему серверу, используйте стандартный клиент PostgreSQL, psql, который можно использовать для создания расширения PipelineDB:
psql -c "CREATE EXTENSION pipelinedb"
После создания расширения PipelineDB можно начать использовать PipelineDB!
Можно ознакомиться с разделом Быстрый старт, и сразу начать передачу данных в PipelineDB.
Конфигурация
По умолчанию PostgreSQL не принимает входящие подключения от удаленных хостов. Для разрешения входящих подключений сначала настройте следующую строку в postgresql.conf
:
listen_addresses = '*'
И в pg_hba.conf
добавьте строку, аналогичную следующей, чтобы разрешить входящие подключения:
host all all <ip address>/<subnet> md5
Например, чтобы разрешить входящие подключения с любого хоста:
host all all 0.0.0.0/0 md5
Docker
PipelineDB доступен в виде образа Docker image, что упрощает запуск на платформах, которые в настоящее время не имеют официальных пакетов. Расширение PipelineDB автоматически создается при инициализации базы данных, поэтому Создание расширения PipelineDB не требуется при использовании образа Docker.
Контейнер Docker PipelineDB можно запустить с помощью docker run
:
docker run pipelinedb/pipelinedb-postgresql-{postgresql version}
Образ Docker PipelineDB использует образ PostgreSQL `PostgreSQL image`_ в качестве родительского, поэтому всю конфигурацию и настройку можно выполнить через интерфейс, который предоставляет образ PostgreSQL `PostgreSQL image`_.
PipelineDB готов к работе! Ознакомьтесь с разделами Непрерывные представления или Быстрый старт, перед началом работы.
macOS/OSX
Поскольку на macOS/OSX стандартное местоположение установки PostgreSQL не предопределено, для этих платформ мы предоставляем общий архив tarball, с помощью которого можно добавить бинарные файлы PipelineDB в PostgreSQL.
После загрузки последнего релиза tarball из наших архивов, запустите простой скрипт install.sh
:
$ tar -xvf pipelinedb-postgresql-<pg version>-<pipelinedb version>.osx.tar.gz $ cd pipelinedb-postgresql-<pg version>-<pipelinedb version> $ sudo ./install.sh PipelineDB installation complete.
Далее переходим к Создание расширения PipelineDB.