本文为您介绍创建 PostgreSQL for Serverless 实例,以及连接数据库实例的操作,为您提供从创建到开始使用实例的全程指导。
使用限制
公测版本限制单用户最大 QPS 40000,磁盘容量最大100GB。
当前仅支持通过云 API 进行创建实例 ServerlessDB。
当前仅开放北京三区、上海二区。
操作指南
步骤一:创建实例
通过 Serverless 应用中心 创建实例
通过云 API 创建实例
参数名 | 必填项 | 类型 | 介绍 |
Zone | 是 | string | 可用区 ID,当前支持 ap-shanghai-2、ap-beijing-3。 |
DBInstanceName | 是 | string | 数据库实例名,同一个账号下该值必须唯一。 |
DBVersion | 是 | string | 数据库版本,目前仅支持10.4。 |
DBCharset | 是 | string | PostgreSQL 数据库字符集,目前支持 UTF8、LATIN1 两种。 |
VpcId | 否 | string | 私有网络 ID,若不指定此项,则为实例分配基础网络 IP 地址。 |
SubnetId | 否 | string | 私有网络子网 ID,与私有网络 ID 同时搭配使用。 |
执行成功后,输出示例如下:
{"Response": {"RequestId": "20304c-6fd7-4427-8e09-2b081e1","DBInstanceId": "postgres-xxxxxxx"}}
其中返回的 DBInstanceId 指实例 ID。
步骤二:连接实例
1. 通过 DescribeServerlessDBInstances 接口查看所有创建的 PostgreSQL for Serverless 实例信息。获取实例的 IP 地址、端口、数据库用户和初始密码。
{"Response": {"TotalCount": 1,"DBInstanceSet": [{"DBInstanceId": "postgres-xxxxxxx","DBInstanceName": "test","DBInstanceStatus": "running",#数据库实例状态"Region": "ap-shanghai","Zone": "ap-shanghai-2","ProjectId": 0,"VpcId": "vpc-test","SubnetId": "subnet-test","DBCharset": "UTF8","DBVersion": "10.4","CreateTime": "2020-03-23 11:43:56","DBInstanceNetInfo": [{"Address": "","Ip": "10.1.1.2", #IP 为示例,同一私有网络,子网内可访问"Port": 5432, #连接端口"Status": "opened","NetType": "private"},{"Address": "","Ip": "","Port": 0,"Status": "0","NetType": "public"}],"DBAccountSet": [{"DBUser": "tencentdb_xxxxxxx","DBPassword": "**************",#数据库密码,请根据实际情况获取,当修改过密码后,此接口返回的密码将不可使用"DBConnLimit": 100}],"DBDatabaseList": ["tencentdb_xxxxxxx"]}],"RequestId": "89583d-cfdd-4db1-bd32-64eb1dbfa"}}
2. 安装客户端,本文以 CentOS 7.2 64 位系统的云服务器为例,执行如下命令安装 PostgreSQL 客户端:
yum install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpmyum install postgresql10 postgresql10.x86_64
3. 执行如下命令连接数据库。
psql -U 数据库用户 -h IP地址 -p 端口
本例中提示
tencentdb_xx>
说明连接成功。
4. 连接成功后,可通过 SQL 语句管理数据,具体可参见 官网文档。
注意:
PostgreSQL for Serverless 不支持如下操作:
创建数据库
访问系统库 postgres
查看数据库参数
SET/RESET 语句
LOAD 语句
PRESERVE/DELETE ROWS temp tables+
LISTEN/NOTIFY
WITH HOLD CURSOR
PREPARE / DEALLOCATE
附录:开启实例外网
附录:开启实例外网
说明:
开启外网功能后,外部可以连接访问数据库,导致数据库存在安全隐患,请尽量使用私有网络进行实例访问。
相关操作
如您需要关闭实例的外网功能,可通过 CloseServerlessDBExtranetAccess 接口关闭外网。
如您需要销毁实例,可通过 DeleteServerlessDBInstance 接口销毁实例。
注意:
实例销毁后,数据无法恢复,请谨慎操作。
如您需要导入数据至 PostgreSQL for Serverless 实例,请参见 导入数据。
可通过 Serverless Framwork 一键创建含 PostgreSQL for Serverless 的网站应用。