使用JDBC或PSQL连接及通过SQL切换计算组-实时数仓 Hologres-阿里云

本文为您介绍如何使用JDBC、PSQL连接计算组实例。

使用JDBC连接Hologres实例

未在连接字符串中显式指定计算组时，将使用用户默认的计算组连接实例。
```
jdbc:postgresql:<Endpoint>:<Port>/<database_name>
```

显式指定计算组。

jdbc:postgresql://<Endpoint>:<Port>/<database_name>@<warehouse_name>

参数	是否必填	说明
Endpoint	是	Hologres实例的网络地址和端口。进入Hologres管理控制台，选择左侧导航栏实例列表，单击目标实例，在实例详情页网络信息中获取网络地址和端口。重要请根据SQL运行所在网络环境选择正确的网络地址和端口，否则将无法正常连接。
Port	是
database_name	是	Hologres的数据库名称。开通Hologres实例后，系统自动创建postgres数据库。您可以使用postgres数据库链接Hologres，但是该数据库分配到的资源较少，开发实际业务建议您新建数据库。详情请参见创建数据库。示例取值demo。
warehouse_name	否	连接实例使用的计算组名称。

未显式指定计算组
如下JDBC连接字符串连接Hologres时，系统会使用用户默认的计算组，连接到hgpostcn-cn-zz4xxxxxxxxxx实例的demo数据库。
```
jdbc:postgresql://hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com:80/demo
```
显式指定计算组
如下JDBC连接字符串连接Hologres时，系统会使用指定的计算组warehouse_1，连接到实例hgpostcn-cn-zz4xxxxxxxxxx的demo数据库。
```
jdbc:postgresql://hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com:80/demo@warehouse_1
```

未在连接字符串中显式指定计算组时，将使用用户默认的计算组连接实例。

PGUSER="<AccessKey_ID>" PGPASSWORD="<AccessKey_Secret>" psql -h <Endpoint> -p <Port> -d <database_name>

显式指定计算组。

PGUSER="<AccessKey_ID>" PGPASSWORD="<AccessKey_Secret>" psql -h <Endpoint> -p <Port> -d <database_name>@<warehouse_name>

参数	是否必填	说明
AccessKey_ID	是	阿里云账号：当前阿里云账号的AccessKey ID。您可以单击AccessKey 管理，获取AccessKey ID。自定义账号：自定义账号的用户名，例如BASIC$abc。
AccessKey_Secret	是	阿里云账号：当前阿里云账号的AccessKey Secret。自定义账号：自定义账号的密码。
Endpoint	是	Hologres实例的网络地址。进入Hologres管理控制台的实例详情页获取网络地址。
Port	是	Hologres实例的网络端口。进入Hologres管理控制台的实例详情页获取网络端口。
database_name	是	Hologres的数据库名称。开通Hologres实例后，系统自动创建postgres数据库。您可以使用postgres数据库链接Hologres，但是该数据库分配到的资源较少，开发实际业务建议您新建数据库。详情请参见创建数据库。示例取值demo。
warehouse_name	否	连接实例使用的计算组名称。

未显式指定计算组
如下PSQL连接字符串连接Hologres时，系统会使用用户默认的计算组，连接到hgpostcn-cn-zz4xxxxxxxxxx实例的demo数据库。
```
PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com -p 80 -d demo
```
显式指定计算组
如下PSQL连接字符串连接Hologres时，系统会使用指定的计算组warehouse_1，连接到hgpostcn-cn-zz4xxxxxxxxxx实例的demo数据库。
```
PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com -p 80 -d demo@warehouse_1
```

Hologres V4.0版本起，支持通过SQL切换当前连接的计算组。

-- 切换当前连接计算组
SET current_warehouse = <warehouse_name>;

-- 验证：查询当前连接计算组
SHOW current_warehouse;