本节主要介绍如何使用 psql 连接 TDSQL PG 。
一、前置条件
注意：说明：
注意：PostgreSQL 的 psql 客户端不支持分布键显示等功能。
通过 psql 连接 TDSQL PG 前，需要确保：
·本地已正确安装 TDSQL PG 的 psql 客户端。
·环境变量配置正确。
二、连接方式
psql 可以通过四种方式连接实例，分别是：使用参数连接、使用 conninfo 字符串或者 URI 连接、配置环境变量后快捷连接。
三、使用参数连接
使用 psql 工具通过参数连接 TDSQL 数据库，通常需要指定主机名 -h ，端口号 -p ，连接数据库的用户名 -U 和连接的数据库 -d ，如果不指定参数值，则取其默认值。
通过 psql 使用参数连接数据库的命令示例如下：
psql -h <数据库连接地址> -p <端口号> -U <用户名> -d <数据库名>
参数说明：
·-h 数据库IP，通常是 CN 的 IP。
·-p 数据库端口
·-U 数据库用户
·-d 需要访问的数据库名称
四、示例
指定数据库为 tdsql，用户为 tbase ，以 tbase 身份登录至 tdsql 数据库。
psql -h 10.211.55.39 -p 11345 -U tbase -d tdsql
五、使用 conninfo 字符串或者 URI 连接
使用 psql 通过 conninfo 字符串或者 URI 连接数据库，同样需要在 conninfo 和 URI 指定主机名称等参数，如果不指定，则取默认的参数值。
conninfo: psql "host=<数据库连接地址> port=<端口号> dbname=<数据库名> user=用户名"URI: postgresql://[user[:password]@][netloc][:port][,…][/dbname][?param1=value1&…]
六、示例
示例1: 通过 conninfo 连接数据库
psql "host=10.211.55.39 port=11345 dbname=tdsql user=tbase"
示例2: 通过 URI 连接数据库
psql postgresql://tbase@10.211.55.39:11345/tdsql
七、配置环境变量后快捷连接
TDSQL PG 支持通过在环境变量中指定主机名称，端口地址，数据库以及数据库用户后通过命令 psql 即可快速连接。相关环境变量分别为PGHOST，PGPORT，PGDATABASE，PGUSER。
八、示例
export PGUSER=tbaseexport PGHOST=10.211.55.39export PGDATABASE=tdsqlexport PGPORT=11345psql
九、psql 常用命令
| 命令 | 功能 | 命令 | 功能 |
| \\password | 设置密码 | \\dt[+] | 显示表格列表或表格的详细信息 |
| \\q \\quit | 退出 psql 程序 | \\dv[+] | 显示视图列表或视图的详细信息 |
| \\conninfo | 输出有关当前数据库连接的信息 | \\df[+] | 显示函数/过程列表或函数/过程的详细信息 |
| \\timing | 显式 SQL 语句打开和关闭的时间 | \\ds[+] | 显示序列列表或序列的详细信息 |
| \\i | 从指定文件中读取输入，并执行 | \\do[+] | 显示操作符列表或操作符的详细信息 |
| \\o | 指定结果输出文件 | \\du[+] | 显示用户列表或用户的详细信息 |
| \\l | 列出可用的数据库 | \\dn[+] | 显示模式列表或模式的详细信息 |
| \\copy | 执行一次前段拷贝 | \\di[+] | 显示索引列表或索引的详细信息 |
| \\x | 切换扩展表格格式化模式 | \\dx[+] | 显示插件列表或插件的详细信息 |
十、更多信息
如果在通过 psql 客户端连接 TDSQL PG 数据库的过程中遇到这篇档未涉及的问题，你可以查阅 PostgreSQL 客户端的使用文档。