psql

前提条件

• 已获取AnalyticDB PostgreSQL版实例的连接地址。

  • 如果您的客户端部署在与AnalyticDB PostgreSQL版实例在同一地域且网络类型相同的ECS上，则可以使用内网地址进行连接。登录云原生数据仓库AnalyticDB PostgreSQL版控制台。在基本信息页面的数据库连接信息区域，即可查看内网地址。

  • 如果您的客户端部署在与AnalyticDB PostgreSQL版实例在不同地域或网络类型不同的ECS或者阿里云以外的系统上，则需要申请外网地址后使用外网地址进行连接。申请外网地址的方法，请参见管理外网地址。

• 已获取客户端的IP地址，并将客户端地址加入AnalyticDB PostgreSQL版实例白名单中。具体操作，请参见设置白名单。

下载及安装

1. 对于RHEL（Red Hat Enterprise Linux）和CentOS版本的6和7版本的平台，可以通过以下地址进行下载，解压后即可使用：

   引擎版本	系统版本	下载地址
   AnalyticDB PostgreSQL 7.0版	RHEL 7或CentOS 7	adbpg7_client_package.el7.x86_64.tar.gz
   AnalyticDB PostgreSQL 6.0版	RHEL 7或CentOS 7	ADBPG_client_package_el7
   	RHEL 6或CentOS 6	ADBPG_client_package_el6

2. 将客户端工具压缩包下载到本地后，需要进行解压并安装，具体方法如下：

   1. 在客户端工具压缩包目录下，解压文件，命令如下：

      tar -xzvf <文件名>

      例如解压客户端工具，示例如下：

      tar -xzvf adbpg_client_package.el7.x86_64.tar.gz

   2. 解压后切换到bin目录下，执行如下命令：

      cd adbpg_client_package/bin

   3. bin目录下包括客户端工具psql、pg_dump等，按照各工具参考文档，执行命令行。

      • psql连接客户端的具体操作，请参见连接数据库。

      • pg_dump是PostgreSQL的逻辑备份工具。pg_dump的使用方式，请参见pg_dump。

连接数据库

1. 通过如下任意一种方式进行连接：

   • 连接串的方式：

     psql "host=yourgpdbaddress.gpdb.rds.aliyuncs.com port=5432 dbname=postgres user=gpdbaccount password=gpdbpassword"

   • 指定参数的方式：

     psql  -h yourgpdbaddress.gpdb.rds.aliyuncs.com -p 5432 -d postgres -U gpdbaccount

     参数说明：

     • -h：指定主机地址。

     • -p：指定端口号。

     • -d：指定数据库（默认的数据库是postgres）。

     • -U：指定连接的用户。

     说明

     您可以通过psql --help查看更多选项。在psql中，可以执行\?查看更多psql中支持的命令。

2. 输入密码，进入psql的命令行页面。

此外也支持Docker形态的工具包，您可以在Docker官网找到对应平台的Docker安装地址。

运行AnalyticDB PostgreSQL 6.0版对应的工具镜像，操作示例如下：

docker run -idt --name=adbpgcli aliadbpg/adbpgcli:v6.3.0
docker exec -it adbpgcli /bin/bash -l

相关文档

• 关于Greenplum的psql的更多使用方法。详情请参见Greenplum psql。

• 您也可以使用PostgreSQL的psql命令，使用时请注意细节上的差异。详情请参见PostgreSQL psql。

• 如果在连接过程中出现could not connect to server xxx报错，请参见如何解决实例无法连接。