10 分钟快速入门

本文为您介绍 ProtonBase 快速上手的操作步骤，帮助您了解如何创建 Warebase、获取连接信息以及创建数据库进行数据写入和查询。

一、前置条件

1. 注册 ProtonBase 账号

前往 http://cn-app.protonbase.com/signup (opens in a new tab) 进入 ProtonBase 注册页，新用户使用邮箱进行注册。

2. 安装 psql 终端

参考 PostgreSQL 官网提供的客户端安装方法 (opens in a new tab) 安装 PSQL。

二、开通服务

1. 创建 Data Cloud

Data Cloud 是您使用和管理数据库存储和计算服资源的实体，您对数据的所有操作都需要在 Data Cloud 中完成。更多信息请参考 Data Cloud。

请登录 https://cn-app.protonbase.com (opens in a new tab) 访问 ProtonBase WEB 界面，打开 Data Cloud 管理页创建新的 Data Cloud，后续操作就可以在对应的 Data Cloud Center 完成。

2. 创建 Warebase

Warebase 是 ProtonBase 的计算模块，您对数据库的所有 DDL、DML 等操作均在 Warebase 中完成，进行 SQL 操作之前请创建 Warebase,更多信息请参考 Warebase。

您可以通过以下 2 个方式进入 Warebase 管理页点击"+Warebase"以新建 Warebase：

访问 https://cn-app.protonbase.com (opens in a new tab) 打开 Data Cloud 管理页，点击 Data Cloud 进 Data Cloud Center > Warebases。
访问 https://<cloud_regionid>-app.protonbase.com (opens in a new tab),直接进入Data Cloud Center > Warebases。
- <cloud_regionid>是云平台的 Region 的标识符，与云平台保持一致，更多信息请参考 ProtonBase 支持的云与 Region。

三、连接 Warebase

Warebase 默认开启的是 VPC 网络访问，本案例中请使用公网访问。

在 Warebases 详情页，点击网络链接，开启公网访问，即可获取 Warebase 的公网域名和端口，同时获得 psql 连接。

psql 连接格式：psql -U <Account> -d postgres -h <Host> -p 5432

<Account>：您的 ProtonBase 账号
<Host> ： Warebase 公网连接域名

四、创建对象

创建数据库

使用 CREATE DATABASE 命令创建 pb_test 数据库：

CREATE DATABASE  pb_test;

通过以下命令切换到刚刚创建的 pb_test 数据库

postgres=# \c pb_test
You are now connected to database "pb_test" as user "judy".
pb_test=#

创建数据表

使用 CREATE TABLE 命令创建 cars 表：

CREATE TABLE cars (
  brand VARCHAR(255),
  model VARCHAR(255),
  year INT
);

执行结果如下：

pb_test=# CREATE TABLE cars (
  brand VARCHAR(255),
  model VARCHAR(255),
  year INT
);
CREATE TABLE
pb_test=# \d cars
                       Table "public.cars"
 Column |          Type          | Collation | Nullable | Default
--------+------------------------+-----------+----------+---------
 brand  | character varying(255) |           |          |
 model  | character varying(255) |           |          |
 year   | integer                |           |          |
 
pb_test=#

五、写入与查询

写入数据

使用 INSERT INTO 命令往 cars 表写入数据：

INSERT INTO cars (brand, model, year)
VALUES ('Ford', 'Mustang', 1964);

执行结果如下：

pb_test=# INSERT INTO cars (brand, model, year)
VALUES ('Ford', 'Mustang', 1964);
INSERT 0 1

查询分析

使用 SELECT 命令查询刚刚数据写入结果。

SELECT * FROM cars;

执行结果如下：

pb_test=# select * from cars;
 brand |  model  | year
-------+---------+------
 Ford  | Mustang | 1964
(1 row)

更新数据

使用 UPDATE 命令更新已有数据。

UPDATE cars
SET model = 'NEWMustang'
WHERE brand = 'Ford';

执行结果如下：

pb_test=# UPDATE cars
SET model = 'NEWMustang'
WHERE brand = 'Ford';
UPDATE 1
pb_test=# select * from cars;
 brand |   model    | year
-------+------------+------
 Ford  | NEWMustang | 1964
(1 row)
 
pb_test=#