购买并通过PostgreSQL客户端连接TaurusDB for PostgreSQL实例

进入购买云数据库TaurusDB页面购买TaurusDB for PostgreSQL实例。

1. 进入弹性云服务器控制台。
2. 查看是否有符合要求的Linux ECS。
   

   TaurusDB for PostgreSQL支持以下两种常用的客户端安装方式：

   • 下载PostgreSQL客户端安装包进行安装：PostgreSQL 15及以下版本推荐使用该方式，同时对ECS的镜像也有要求，详见PostgreSQL社区指导。
   • 下载源码进行安装：该方式对PostgreSQL版本及ECS的镜像没有要求。
   • 有Linux ECS，执行3。
   • 没有Linux ECS，需要购买ECS，购买时选择Linux操作系统，例如CentOS 7。

     由于需要在ECS下载PostgreSQL客户端，因此需要为ECS绑定弹性公网IP（EIP），并且选择与TaurusDB for PostgreSQL实例相同的区域、VPC和安全组，便于TaurusDB for PostgreSQL和ECS网络互通。

     购买Linux弹性云服务器请参考《弹性云服务器用户指南》中“购买弹性云服务器”章节。

3. 分别查看ECS的区域和VPC，以及TaurusDB for PostgreSQL实例的区域和VPC。确认ECS实例与TaurusDB for PostgreSQL实例处于同一区域、同一VPC内。
   图1 ECS基本信息
   
   图2 PostgreSQL概览
   

   • 如果不在同一区域，请重新购买ECS实例。不同区域的云服务之间内网互不相通，无法访问实例。请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。
   • 如果不在同一VPC，可以修改ECS的VPC，请参见切换虚拟私有云。

1. 登录ECS实例，请参见《弹性云服务器用户指南》中“Linux弹性云服务器远程登录（VNC方式）”。
2. 在TaurusDB“实例管理”页面，单击实例名称进入“概览”页面。
3. 在“网络信息”区域获取读写内网地址和数据库端口。
4. 在ECS上测试是否可以正常连接到TaurusDB for PostgreSQL实例内网地址的端口。

   curl -kv 192.168.0.7:5432

   • 如果可以通信，说明网络正常。
   • 如果无法通信，请检查安全组规则。
     • 查看ECS的安全组的出方向规则，如果目的地址不为“0.0.0.0/0”且协议端口不为“全部”，需要将TaurusDB for PostgreSQL实例的内网IP地址和端口添加到出方向规则。
     • 查看TaurusDB for PostgreSQL的安全组的入方向规则，需要将ECS实例的私有IP地址和端口添加到入方向规则。
5. 安装PostgreSQL客户端。

   源码安装方式，该安装方式对TaurusDB for PostgreSQL实例的版本以及ECS的操作系统没有限制。

   下面以Huawei Cloud EulerOS 2.0镜像的ECS为例，安装PostgreSQL 16.4版本客户端。

   图3 查看ECS镜像
   
   1. 要支持SSL，需要在ECS上提前下载openssl。

      sudo yum install -y openssl-devel

   2. 在官网获取代码下载链接，使用wget直接下载安装包或者下载到本地后上传到ECS上。

      wget https://ftp.postgresql.org/pub/source/v16.4/postgresql-16.4.tar.gz

   3. 解压安装包。

      tar xf postgresql-16.4.tar.gz

   4. 编译安装。

      cd postgresql-16.4
      ./configure --without-icu --without-readline --without-zlib --with-openssl
      make -j 8 && make install

      

      不指定--prefix，表示默认路径为“/usr/local/pgsql”，因为只安装客户端采用最简安装。

      图4 编译安装
      
   5. 配置环境变量，在“/etc/profile”文件中添加以下内容。

      export PATH=/usr/local/pgsql/bin:$PATH
      export LD_LIBRARY_PATH=/usr/local/pgsql/lib:$LD_LIBRARY_PATH
      source /etc/profile

   6. 测试psql是否可使用。

      psql -V

      图5 测试psql可用
      

1. 在TaurusDB“实例管理”页面，单击实例名称进入“实例概览”页面。
2. 在“网络信息”模块获取实例的内网地址和数据库端口。
3. 在ECS上执行以下命令连接TaurusDB for PostgreSQL实例。

   psql --no-readline -h <host> -p <port> "dbname=<database> user=<user> "

   示例：

   psql --no-readline -h 192.168.0.7 -p 5432 "dbname=postgres user=root"

   表1 参数说明

   参数	示例	说明
   <host>	192.168.0.7	在步骤3：测试连通性并安装PostgreSQL客户端中获取的内网地址。
   <port>	5432	在步骤3：测试连通性并安装PostgreSQL客户端中获取的数据库端口，默认5432。
   <database>	postgres	需要连接的数据库名，默认的管理数据库是postgres。
   <user>	root	管理员账号root。

4. 出现如下提示时，输入数据库账号对应的密码。

   Password:

   出现如下信息，表示连接成功。

   SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)