# PolarDB
PolarDB是阿里巴巴自研的新一代云原生数据库。PolarDB共有三个引擎，分别为PolarDB MySQL版（PolarDB for MySQL，简称PolarDB-M）、PolarDB PostgreSQL版（PolarDB for PostgreSQL，简称PolarDB-PG）、PolarDB分布式版（PolarDB for Xscale，简称PolarDB-X）。
POLARDB采用存储和计算分离的架构，所有计算节点共享一份数据，提供分钟级的配置升降级、秒级的故障恢复、全局数据一致性和免费的数据备份容灾服务。POLARDB既融合了商业数据库稳定可靠、高性能、可扩展的特征，又具有开源云数据库简单开放、自我迭代的优势。
目前MapGIS仅支持PolarDB PostgreSQL引擎模式。下图为MapGIS使用PolarDB数据库的流程图：
# 
相关主题
# 配置PolarDB集群
使用PolarDB数据库前，需先在阿里云 (opens new window)官方网站购买/试用 "PolarDB PostgreSQL版" 集群。成功后，可在"集群列表"中查看到已购买的集群信息。
# 创建管理员用户
1. 创建管理员用户。点击集群名称，进入集群。点击"账号管理"->"创建账号"，可新建一个"高权限账号"。账户及密码要求详见网站上要求。
# 设置公网地址
1. 设置公网地址。默认无公网地址，用户需点击"申请"，按照页面提示申请一个公网地址，
2. 待审核通过后即可即可查看公网地址，包括地址和端口号。
# 设置集群白名单
1. 点击"集群白名单"->"新建IP白名单分组"，可新建白名单分组。白名单规则详见页面说明，可输入"0.0.0.0/0"来允许任何IP地址访问数据库集群。
# 新建数据库
# 新建数据库
PolarDB选购成功后，默认安装一个名为postgres的数据库。用户在业务应用中时，建议再新建一个独立的数据库及用户。
1. 利用数据库连接工具链接PolarDB数据库，如DBever。采用PostgreSQL模式，主机信息为公网地址，端口号为1521，数据库默认为postgres，用户可用之前新建的管理员。
2. 新建一个SQL查询，通过如下命令，新建用户。如下用户名为test1，密码为test。
create user test1 password 'test';
3. 新建一个新的数据库并属于新建的用户。如下数据库为test1，用户可自定义。
create database test1 owner test1;
# 启用postgis扩展
create extension postgis;
# 配置PolarDB数据源
# 
功能说明
PolarDB数据库配置完成后，即可在MapGIS中配置PostgreSQL数据源，用来管理PostgreSQL数据库。
# 
操作说明
1. 在MapGIS GDBCatalog面板，启动"客户端配置管理
"功能，弹出如下所示对话框：
2. 切换到"数据源"页面，点击"添加"，选择"POLARDBGanos数据源"。手动输入"[公网地址]:[端口]/[数据库名]"，并可点击"测试"，验证数据库连接有效性。
3. "确定"后，在MapGIS GDBCatalog中可添加该PolarDB数据源节点信息：
# 创建PolarDB地理数据库
# 功能说明
在MapGIS中配置PolarDB数据源后，需初始化PolarDB地理数据库。初始化成功后，用户即可基于该地理数据库进行数据转换、创建等数据管理相关操作。
# 操作说明
1. 在MapGIS GDBCatalog中，连接PolarDB数据源，需输入用户名密码信息；
2. 连接成功后，在PolarDB数据源节点，右键"创建地理数据库"，即可初始化PolarDB地理数据库。
- 【支持Z值】：勾选时，初始化的PolarDB地理数据库中数据版本为8.3，其中点/线/区简单要素类可支持z值；
- 【支持解析弧段】：勾选时，初始化的PolarDB地理数据库中数据版本为8.4，其中线/区简单要素类可支持弧段。
- 【类名和表名一致】：勾选时，PolarDB数据库中存储GIS数据类名和表名是一致的。由于PolarDB数据库中表名存在长度、特殊字符的限制，MapGIS默认PolarDB数据库中数据存储名称和实际名称是通过"mpdbmaster"->"mpdb_item"表存储对应关系。
3. 初始化成功后，用户即可基于该数据库进行数据转换、创建等数据管理相关操作。