构建连接 URL
使用连接 URL 向您正在访问的数据存储提供连接信息。以下是 Amazon Redshift JDBC 驱动程序 2.1 版本的连接 URL 的格式。此处,[主机] 是 Amazon Redshift 服务器的端点,[端口] 是服务器用于侦听客户端请求的传输控制协议 (TCP) 端口的编号。
jdbc:redshift://[Host]:[Port]
以下是指定某些可选设置的连接 URL 的格式。
jdbc:redshift://[Host]:[Port]/[database];[Property1]=[Value]; [Property2]=[Value];
如果您的 URL 值包含以下任何 URI 预留字符,则这些值必须经过 URL 编码:
-
;
-
+
-
{
-
}
-
[
-
]
-
&
-
=
-
?
-
一个空格
例如,如果 PWD
的值为 password:password
,则使用该值的连接 URL 将如下所示:
jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=password%3Apassword
例如,假设您希望在 Amazon 上连接到位于美国西部(加利福尼亚北部)区域的 Amazon Redshift 集群上的端口 9000。您还希望访问名为 dev
的数据库,并使用数据库用户名和密码对连接进行身份验证。在此情况下,您使用以下连接 URL。
jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=amazon
您可以使用以下字符将配置选项与 URL 字符串的其余部分分隔开:
-
;
-
?
例如,以下 URL 字符串等效:
jdbc:redshift://my_host:5439/dev;ssl=false;defaultRowFetchSize=100
jdbc:redshift://my_host:5439/dev?ssl=false;defaultRowFetchSize=100
您可以使用以下字符将 URL 字符串中的配置选项彼此分隔开:
-
;
-
&
例如,以下 URL 字符串等效:
jdbc:redshift://my_host:5439/dev;ssl=false;defaultRowFetchSize=100
jdbc:redshift://my_host:5439/dev;ssl=false&defaultRowFetchSize=100
以下 URL 示例指定日志级别 6 和日志的路径。
jdbc:redshift://redshift.amazonaws.com:5439/dev;DSILogLevel=6;LogPath=/home/user/logs;
不要复制连接 URL 中的属性。
有关可指定的配置选项的完整列表,请参阅 JDBC 驱动程序版本 2.1 配置的选项。
注意
连接时,请勿使用集群节点的 IP 地址或 VPC 端点的 IP 地址。请务必使用 Redshift 端点以避免不必要的中断。使用端点 URL 的唯一例外是使用自定义域名时。有关更多信息,请参阅使用自定义域名进行客户端连接。