快速入门

最近更新时间:2024-10-18 17:27:32

我的收藏
本文为您介绍创建 PostgreSQL for Serverless 实例,以及连接数据库实例的操作,为您提供从创建到开始使用实例的全程指导。

使用限制

公测版本限制单用户最大 QPS 40000,磁盘容量最大100GB。
当前仅支持通过云 API 进行创建实例 ServerlessDB。
当前仅开放北京三区、上海二区。

操作指南

步骤一:创建实例

通过 Serverless 应用中心 创建实例

可通过 Serverless 应用中心数据库组件 快速创建数据库实例。

通过云 API 创建实例

可通过云 API 创建 PostgreSQL for Serverless(ServerlessDB)实例,接口名:CreateServerlessDBInstance
下表描述了部分重要的输入参数,详情请参见 创建 ServerlessDB 实例
参数名
必填项
类型
介绍
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.rpm
yum install postgresql10 postgresql10.x86_64
3. 执行如下命令连接数据库。
说明:
内网连接时,需使用 云服务器 CVM 访问云数据库的内网地址,CVM 和数据库须是同一账号,且同一个 VPC 内(保障同一个地域)。
外网连接时,需先 开启实例外网
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

附录:开启实例外网

通过 OpenServerlessDBExtranetAccess 可开启外网连接功能,用户可通过外网连接访问数据库。
说明:
开启外网功能后,外部可以连接访问数据库,导致数据库存在安全隐患,请尽量使用私有网络进行实例访问。

相关操作

如您需要关闭实例的外网功能,可通过 CloseServerlessDBExtranetAccess 接口关闭外网。
如您需要销毁实例,可通过 DeleteServerlessDBInstance 接口销毁实例。
注意:
实例销毁后,数据无法恢复,请谨慎操作。
如您需要导入数据至 PostgreSQL for Serverless 实例,请参见 导入数据
可通过 Serverless Framwork 一键创建含 PostgreSQL for Serverless 的网站应用。