云数据库 PostgreSQL
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 云数据库 PostgreSQL > ServerlessDB 相关 > 快速入门

快速入门

最近更新时间：2023-08-25 09:22:31

我的收藏

本页目录：

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

使用限制

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

操作指南

步骤一：创建实例

通过 Serverless Framework 创建实例

可通过 Serverless Framework 数据库组件 快速创建数据库实例。

通过云 API 创建实例

可通过云 API 创建 PostgreSQL for Serverless（ServerlessDB）实例，接口名：CreateServerlessDBInstance。
下表描述了部分重要的输入参数，详情请参见 创建 ServerlessDB 实例：
参数名
必填项
类型
介绍
Zone
是
string
可用区 ID，当前支持 ap-shanghai-2、ap-beijing-3、ap-guangzhou-2。
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 的网站应用。
中国站