快速开始
1. 环境要求
-
硬件要求
配置参数 |
最低配置 |
推荐配置 |
CPU |
4核 |
16核 |
内存 |
4GB |
64GB |
存储 |
800MB,机械硬盘 |
5GB以上,SSD或NvMe |
网络 |
千兆网络 |
万兆网络 |
-
软件要求
IvorySQL数据库目前支持的操作系统包括但不限于CentOS 7.X和CentOS 8.X。
2. 快速安装
快速开始所使用的操作系统为CentOS 7.9。
2.1. 从yum源安装IvorySQL数据库
-
安装前准备
安装前请先创建一个用户,并赋予其root权限, 安装和使用均以该用户执行。这里以ivorysql用户为例。 如何创建sudo用户
-
下载安装
执行以下命令安装:
$ sudo yum install -y https://yum.highgo.ca/dists/ivorysql-rpms/repo/ivorysql-release-3.0-1.noarch.rpm
$ sudo yum install -y ivorysql3 ivorysql3-server ivorysql3-contrib ivorysql3-test --skip-broken
正确安装后,数据库将被安装在/usr/local/ivorysql路径下的ivorysql-version(如:ivorysql-3)文件夹内
执行以下命令为ivorysql用户赋权:
$ sudo chown -R ivorysql:ivorysql /usr/local/ivorysql
-
配置环境变量
将以下配置写入~/.bash_profile文件并使用source命令该文件使环境变量生效:
PATH=/usr/local/ivorysql/ivorysql-3/bin:$PATH
export PATH
LD_LIBRARY_PATH=/usr/local/ivorysql/ivorysql-3/lib
export LD_LIBRARY_PATH
PGDATA=/usr/local/ivorysql/ivorysql-3/data
export PGDATA
$ source ~/.bash_profile
-
数据库初始化
$ initdb -D /usr/local/ivorysql/ivorysql-3/data
其中-D参数用来指定数据库的数据目录。更多参数使用方法,请使用initdb --help命令获取。
-
启动数据库服务
$ pg_ctl -D /usr/local/ivorysql/ivorysql-3/data -l ivory.log start
其中-D参数用来指定数据库的数据目录,如果[配置环境变量] 配置了PGDATA,则该参数可以省略。-l参数用来指定日志目录。更多参数使用方法,请使用pg_ctl --help命令获取。
查看确认数据库启动成功:
$ ps -ef | grep postgres
ivorysql 3214 1 0 20:35 ? 00:00:00 /usr/local/ivorysql/ivorysql-3/bin/postgres -D /usr/local/ivorysql/ivorysql-3/data
ivorysql 3215 3214 0 20:35 ? 00:00:00 postgres: checkpointer
ivorysql 3216 3214 0 20:35 ? 00:00:00 postgres: background writer
ivorysql 3218 3214 0 20:35 ? 00:00:00 postgres: walwriter
ivorysql 3219 3214 0 20:35 ? 00:00:00 postgres: autovacuum launcher
ivorysql 3220 3214 0 20:35 ? 00:00:00 postgres: logical replication launcher
ivorysql 3238 1551 0 20:35 pts/0 00:00:00 grep --color=auto postgres
2.2. docker方式运行
-
从Docker Hub上获取IvorySQL镜像
$ docker pull ivorysql/ivorysql:3.2-ubi8
-
运行IvorySQL
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:3.2-ubi8
-
查看IvorySQL容器运行是否成功
$ docker ps | grep ivorysql
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
6faa2d0ed705 ivorysql:3.2-ubi8 "docker-entrypoint.s…" 50 seconds ago Up 49 seconds 5866/tcp, 0.0.0.0:5434->5432/tcp ivorysql
3. 数据库连接
psql连接数据库:
$ psql -d <database>
psql (16.2)
Type "help" for help.
ivorysql=#
其中-d参数用来指定想要连接到的数据库名称。IvorySQL默认使用ivorysql数据库,但较低版本的IvorySQL首次使用时需用户先连接postgres数据库,然后自己创建ivorysql数据库。较高版本的IvorySQL则已为用户创建好ivorysql数据库,可以直接连接。 更多参数使用方法,请使用psql --help命令获取。
Docker运行IvorySQL时,需要添加额外参数,如 psql -d ivorysql -U ivorysql -h 127.0.0.1 -p 5434 |
现在可以开始使用IvorySQL啦!就是这么简单!
想要获得更多安装方式,请参考安装指南