AntDB数据库基础用法指南

AntDB是一款企业级通用分布式关系型数据库，以其高效、可扩展和稳定的特点受到广泛关注。本文将介绍AntDB数据库的基础用法，包括安装、配置以及基本操作，帮助用户快速上手。

一、AntDB的安装

AntDB提供多种安装方式，包括RPM包安装和tar.gz安装包安装。以下是两种方式的详细步骤：

1. RPM包安装

1. 上传RPM包：将交付人员提供的RPM包上传到服务器上。
2. 安装RPM包：
   • 安装到默认路径：sudo rpm -ivh antdb-xxx.rpm
   • 自定义路径安装：sudo rpm -ivh antdb-xxx.rpm --relocate=/opt/app/antdb=$ADBHOME（$ADBHOME为自定义目录）
3. 修改目录权限：
   • sudo chown -R antdb:antdb $ADBHOME
   • sudo chmod -R 755 $ADBHOME
4. 配置环境变量：
   • 编辑当前用户的隐藏文件.bashrc，添加以下内容：export ADBHOME=/opt/app/antdb export PATH=$ADBHOME/bin:$PATH export LD_LIBRARY_PATH=$ADBHOME/lib:$LD_LIBRARY_PATH
   • 执行source ~/.bashrc使环境变量生效。

2. tar.gz安装包安装

1. 创建AntDB用户：
   • useradd -d /data/antdb -m antdb
   • passwd antdb（设置密码）
2. 上传并修改安装包权限：
   • 将安装包antdb-ce-7.2.0.centos7.x86_64.tar.gz拷贝到/data/antdb目录。
   • chown -R antdb:antdb antdb-ce-7.2.0.centos7.x86_64.tar.gz
3. 解压并安装：
   • 登录antdb用户：su - antdb
   • 解压安装包：tar -xzvf antdb-ce-7.2.0.centos7.x86_64.tar.gz
   • 进入解压目录：cd antdb-ce-7.2.0.centos7.x86_64
   • 执行安装脚本：
     • 交互式安装：sh antdb_install.sh
     • 静默安装：sh antdb_install.sh -s
   • 安装完成后，执行source /data/antdb/.bashrc使环境变量生效。

二、AntDB的配置

1. 初始化数据库：
   • 确定数据存放目录，例如/data/antdb/data。
   • 使用initdb命令初始化数据库：initdb -D /data/antdb/data --wal-segsize=1024
   • 确保AntDB用户对数据目录有读写权限。
2. 配置数据库参数： listen_addresses='*' superuser_reserved_connections=13 tcp_keepalives_idle=60 tcp_keepalives_interval=5 tcp_keepalives_count=10 work_mem=16MB min_wal_size=2GB maintenance_work_mem=1GB max_stack_depth=7000 wal_sync_method=open_datasync wal_compression=on wal_log_hints=on checkpoint_timeout=15min checkpoint_completion_target=0.9 archive_mode=on archive_command='/bin/date' wal_keep_segments=64 log_destination='csvlog' logging_collector=on log_directory='pg_log' log_rotation_size=100MB log_min_messages=error log_statement=ddl track_activity_query_size=2048 autovacuum_max_workers=5 autovacuum_vacuum_threshold=500 autovacuum_analyze_threshold=500 max_locks_per_transaction=256
   • 编辑postgresql.conf文件，修改数据库参数。例如：
3. 根据实际需求替换加粗斜体部分的参数，如port、max_connections等。
4. 配置访问白名单： host all all 10.0.0.0/8 md5
   • 编辑pg_hba.conf文件，配置访问白名单。例如：

三、AntDB的基本操作

1. 启动数据库：
   • 使用adb_ctl命令启动数据库：adb_ctl start -D /data/antdb/data
2. 登录数据库：
   • 使用psql命令登录数据库：psql -d postgres -p 5432
3. 使用adb客户端：
   • 在AntDB客户端中，可以通过\h cmd获取命令的帮助信息。
   • 示例：adb --help查看adb命令的帮助信息。

四、注意事项

• 环境变量：确保环境变量正确配置，并使用source命令使其生效。
• 权限问题：确保AntDB用户对数据目录有读写权限，否则初始化会失败。
• 配置文件：修改配置文件时，注意格式和语法，避免配置错误导致数据库无法启动。
• 连接端口：在集群环境中，客户端连接时需要指定gtmcoord或coord的连接端口，而非adbmgr的端口。