PipelineDB安装

安装PostgreSQL

PipelineDB是以PostgreSQL插件运行的,先从 安装PostgreSQL 开始。

注解

PipelineDB当前支持64位架构下的PostgreSQL版本:10.1,10.2,10.3,10.4,10.5,10.6和11.0。

安装好PostgreSQL后,您只需安装PipelineDB二进制包并且在PostgreSQL数据库中创建PipelineDB插件。您可以通过 aptyum 以及直接通过 安装包 进行安装。

apt

首先,添加 apt源 到系统源中(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源 到系统源中(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包。


您可以直接从我们的 github仓库 中直接下载二进制包。

RPM包安装

运行下面的指令以.rpm形式安装:

sudo rpm -ivh pipelinedb-postgresql-<pg version>_<pipelindb version>.rpm

Debian包安装

运行下面的指令以.deb形式安装:

sudo dpkg -i pipelinedb-postgresql-<pg version>_<pipelindb version>.deb

创建PipelineDB插件

为了PipelineDB能够运行,必须在Postgres数据目录下的 postgresql.conf 文件中设置好 shared_preload_libraries 参数,同时 max_worker_processes 也必须被设到一个合理并且足够大的值来保证PipelineDB的计算性能。

# At the bottom of <data directory>/postgresql.conf
shared_preload_libraries = 'pipelinedb'
max_worker_processes = 128

运行PostgreSQL

通过 pg_ctl 指令并指向新创建的数据目录,使PostgreSQL服务在后台运行:

pg_ctl -D <data directory> -l postgresql.log start

使用PostgreSQL的标准客户端 psql 连接运行中服务的默认database,执行以下指令创建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镜像,这使其可以很简单地在基于Unix架构的系统中运行,镜像中包含完整的依赖,无需额外安装即可直接运行。

您可以基于镜像,通过 docker run 启动PipelineDB实例:

docker run pipelinedb/pipelinedb-postgresql-{postgresql version}

PipelineDB Docker镜像基于 PostgreSQL image 构建,所有配置项及个性化参数均可以通过 PostgreSQL镜像 提供的接口进行设置。


此时PipelineDB已能正常工作!跳转到 流视图快速开始 部分来开始使用PipelineDB。

macOS/OSX

鉴于没有macOS/OSX平台下的标准PostgreSQL安装包,我们为这类平台提供了一通用的二进制安装包,您可以在PostgreSQL安装完毕后直接进行安装。

下载好最新的 安装包 后,您只需运行 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插件