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插件。您可以通过 apt、yum 以及直接通过 安装包 进行安装。
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仓库 中直接下载二进制包。
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镜像 提供的接口进行设置。
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插件。