PolarPlus是一种兼容Oracle的PolarDB客户端连接工具。
下载客户端
PolarPlus提供压缩包免安装下载,解压后即可使用,其目录结构如下所示:
polarplus
├── bin
├── etc
│ └── sysconfig
├── help
└── lib
其中二进制都在bin目录下,如果需要,请将其添加到系统PATH路径。
bin
├── polarplusLauncher.sh
├── polarplus.sh
PolarPlus使用说明
PolarPlus是一个实用程序,可以为PolarDB提供命令行用户界面。PolarPlus支持SQL命令、SPL匿名块和PolarPlus命令。
PolarPlus提供了如下功能:
- 查询指定数据库对象
- 执行存储过程
- 格式化SQL命令的输出
- 执行批处理脚本
- 执行操作系统命令
- 记录输出内容
以下步骤将指导您如何下载并配置PolarPlus。
说明 该工具依赖如下:
- Java的jdk1.8环境(x64)。
- OpenSSL 1.1版本(x64)。
- 使用
wget
命令下载PolarPlus并解压,下载地址请参见下载客户端。
- 进入bin文件夹。
- 打开
polarplus.sh
文件。
- 修改
export base="{pwd}/polarplus"
,将{pwd}
替换为polarplus
所在的绝对路径。
- 在服务器上使用以下命令调用PolarPlus:
polarplus [ -S[ILENT ] ] [ login | /NOLOG ] [ @scriptfile[.ext ] ]
参数 |
说明 |
-S[ILENT ] |
如果指定该参数,则将取消显示PolarPlus登录横幅以及所有提示。 |
login |
用于连接到数据库服务器和数据库的登录信息。
登录采用以下格式: username[/password][@{connectstring | variable } ]
具体信息请参见表 1。
variable是在login.sql文件中定义的变量,该文件包含数据库连接字符串。
|
/NOLOG |
如果指定/NOLOG 启动PolarPlus,启动PolarPlus时将不会建立数据库连接。 需要连接数据库使用SQL命令或者PolarPlus命令请勿使用该模式。
说明 使用/NOLOG选项启动PolarPlus之后, 可以随后给出CONNECT命令以连接到数据库。
|
scriptfile[.ext ] |
scriptfile是位于当前工作目录中的文件名,包含SQL命令以及PolarPlus命令, 这些命令将在PolarPlus启动后自动执行。
.ext 是文件扩展名。 如果文件扩展名是sql, 可以在指定脚本文件时可以省略 .sql 扩展名。 创建脚本文件时,请使用扩展名命名该文件, 否则PolarPlus将无法访问该文件。
说明 PolarPlus将始终对未指定扩展名的文件名采用.sql 扩展名。
|
表 1. 登录信息
参数 |
说明 |
username |
用于连接数据库的数据库用户名。 |
password |
与指定用户名关联的密码。 |
connectstring |
具有以下格式的数据库连接字符串: host[:port][/dbname][?ssl={true | false}]
|
连接示例如下所示:
polarplus polardb/password@pc-bp1zxxxxxxxxxxx.o.polardb.rds.aliyuncs.com:1521/polardb