tencent cloud

文档反馈

快速入门

最后更新时间:2024-01-22 16:24:46
    本文为您介绍创建 PostgreSQL for Serverless 实例,以及连接数据库实例的操作,为您提供从创建到开始使用实例的全程指导。

    使用限制

    公测版本限制单用户最大 QPS 40000/s,磁盘容量最大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 的网站应用。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持