快速开始

本文介绍如何快速上手体验 PolarDB-X 数据库。要上手 PolarDB-X 数据库，你将使用到 PXD 工具。通过 PXD，你只需执行一行命令就可在本地快速拉起一个 PolarDB-X。

注意：

PXD 主要面向的是开发测试场景，生产环境请使用 polardbx-operator 在 K8S 上进行部署

准备工作

通过 PXD 工具部署 PolarDB-X 数据库需要先安装 Python3 和 Docker。下面给出不同操作系统的安装方式。注意请确保您的机器具备访问互联网的能力。

如果您使用的是阿里云ECS,可以参考文档：连接公网概述为云服务器开通访问互联网的能力。

在 macOS 上准备测试环境
在 CentOS（包括 Anolis OS）上准备测试环境（包括 Anolis OS ）
在 Ubuntu 上准备测试环境
在 Windows 上准备测试环境

在 macOS 上准备测试环境

1.安装 Python3

如果你的机器上已经安装了 python3，可以跳过

检查命令：which python3，如果有返回则代表 python3 已安装

推荐使用 Homebrew 安装 python3，如果没有 Homebrew，可参考 Homebrew 官方安装方法：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

brew install python

2.安装 Docker Desktop for Mac，参考文档：https://docs.docker.com/desktop/mac/install/

由于 Docker Desktop for Mac 的默认内存是 2G，无法满足 PolarDB-X 开发测试环境的最低要求，需要在 Docker Preferences 中将内存调整到8G，如下图所示：

3.安装 MySQL 命令行工具，参考 MySQL 官方文档：Installing MySQL Shell on macOS

在 CentOS 上准备测试环境

注：包括 Anolis OS

1.安装 Python3

如果你的机器上已经安装了 python3，可以跳过

检查命令：which python3，如果有返回则代表 python3 已安装

yum update -y
yum install -y python3

2.安装 Docker, 详见文档：https://docs.docker.com/engine/install/centos/

安装完成后执行 docker ps 命令验证。如果遇到如下报错，请参考：非 root 用户如何获取 docker 权限
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get http:///var/run/docker.sock/v1.26/images/json: dial unix /var/run/docker.sock: connect: permission denied
如果您在阿里云ECS部署，建议执行docker info检查 docker registry mirror配置，将其切换成上交的镜像源：docker.mirrors.sjtug.sjtu.edu.cn

3.安装 MySQL 命令行工具，参考 MySQL 官方文档：Installing MySQL Shell on Linux

在 Ubuntu 上准备测试环境

1.安装 Python3

可在shell中执行 python3 检查 Python3 是否已经安装，若已安装，直接执行第 2 步。

apt-get update
apt-get install python3.8 python3.8-venv

2.安装 Docker, 详见文档：https://docs.docker.com/engine/install/ubuntu/

安装完成后执行 docker ps 命令验证。如果遇到如下报错，请参考：非 root 用户如何获取 docker 权限
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get http:///var/run/docker.sock/v1.26/images/json: dial unix /var/run/docker.sock: connect: permission denied
如果您在阿里云ECS部署，建议执行docker info检查 docker registry mirror配置，将其切换成上交的镜像源：docker.mirrors.sjtug.sjtu.edu.cn

3.安装 MySQL 命令行工具，参考 MySQL 官方文档：Installing MySQL Shell on Linux

在 Windows 上准备测试环境

Windows 平台上一般使用 WSL 来运行 PolarDB-X。

1.安装 WSL，参考文档：https://docs.microsoft.com/en-us/windows/wsl/install ，使用默认的 Linux 发行版 Ubuntu

2.安装 Docker Desktop，参考文档：https://docs.docker.com/desktop/windows/wsl/

3.安装 Python3

如果你的机器上已经安装了 python3，可以跳过

apt-get install python3
apt-get install python3-venv

4.安装pip

apt-get install python3-pip

5.安装 MySQL 命令行工具，参考 MySQL 官方文档：Installing MySQL Shell on Microsoft Windows

安装 PXD

注意：推荐使用 virtual environment 安装 PXD 工具
python3 -m venv venv
source venv/bin/activate

安装前建议先执行如下命令升级 pip

pip install --upgrade pip

执行如下命令安装 pxd:

pip install pxd

注：部分国内用户从 pypi 下载包的速度较慢, 可以使用如下命令从阿里云的镜像安装：
pip install -i https://mirrors.aliyun.com/pypi/simple/ pxd

执行如下命令验证 pxd 是否安装成功：

pxd version

注意：如果执行上述命令报了如下错误:

Click discovered that you exported a UTF-8 locale but the locale system could not pick up from it because it does not exist.

请执行如下命令后重试：

export LC_ALL=en_US.utf-8
export LANG=en_US.utf-8

部署 PolarDB-X

部署 PolarDB-X 企业版集群

PolarDB-X 企业版是分布式架构集群，支持更大数据量，面向具备企业级超高并发、大规模数据复杂查询、加速分析的业务场景。直接运行 pxd tryout 命令会创建一个最新版本的 PolarDB-X 企业版集群，其中 GMS, CN, DN, CDC 节点各 1 个：

pxd tryout

如果需要创建指定版本的实例，您可以通过如下命令获取 PolarDB-X 各个组件的最新镜像tag：

curl -s "https://polardbx-opensource.oss-cn-hangzhou.aliyuncs.com/scripts/get-version.sh" | sh

输出内容如下所示(以 PolarDB-X V2.4.0 版本为例)：

CN polardbx/polardbx-sql:v2.4.0_5.4.19
DN polardbx/polardbx-engine:v2.4.0_8.4.19
CDC polardbx/polardbx-cdc:v2.4.0_5.4.19

通过如下命令，指定 CN，DN, CDC 节点的个数以及版本：

pxd tryout -cn_replica 1 -cn_version v2.4.0_5.4.19 -dn_replica 1 -dn_version v2.4.0_8.4.19 -cdc_replica 1 -cdc_version v2.4.0_5.4.19

tryout 模式创建的 GMS 和 DN 默认采用单副本模式，如果您想创建基于 Paxos 的三副本的集群，使用如下命令：

pxd tryout -leader_only false

注：三副本模式需要 pxd版本>=0.3.0

如果您因网络问题无法拉取docker镜像，建议使用PolarDB-X的私有镜像仓库，详见：私有镜像仓库说明

PolarDB-X 数据库创建完成后，会输出对应的连接信息:

注意：PolarDB-X 管理员账号的密码随机生成，仅出现这一次，请注意保存。

通过 MySQL Client 即可连接，执行如下 SQL 初步体验 PolarDB-X 的分布式特性。PolarDB-X SQL 详情请参考：SQL 概述

# 检查GMS 
select * from information_schema.schemata;

# 创建分区表
create database polarx_example partition_mode='partitioning';

use polarx_example;

create table example (
  `id` bigint(11) auto_increment NOT NULL,
  `name` varchar(255) DEFAULT NULL,
  `score` bigint(11) DEFAULT NULL,
  primary key (`id`)
) engine=InnoDB default charset=utf8 
partition by hash(id) 
partitions 8;

insert into example values(null,'lily',375),(null,'lisa',400),(null,'ljh',500);

select * from example;

show topology from example;

# 检查CDC
show master status ;
show binlog events in 'binlog.000001' from 4;


# 检查DN和CN
show storage ;  
show mpp ;

部署 PolarDB-X 标准版集群

PolarDB-X 标准版采用一主一备一日志的三节点架构，性价比高，通过多副本同步复制，确保数据的强一致性。面向具备超高并发、复杂查询及轻量分析的在线业务场景。

注：标准版集群创建依赖 pxd版本>=0.6.0

执行如下命令会创建一个最新版本的 PolarDB-X 标准版集群，其中 GMS, CN, CDC 个数为0，仅包含一个DN节点。
```
pxd tryout -t standard
```
tryout 模式创建的集群采用单副本模式，如果您想创建基于 Paxos 的一主一备一日志的三节点集群，使用如下命令：
```
pxd tryout -t standard -leader_only false
```
如果您因网络问题无法拉取docker镜像，建议使用PolarDB-X的私有镜像仓库，详见：私有镜像仓库说明

PolarDB-X 数据库创建完成后，会输出对应的连接信息:

注意：PolarDB-X 管理员账号的密码随机生成，仅出现这一次，请注意保存。

通过 MySQL Client 即可连接。执行如下 SQL 体验PolarDB-X 标准版三节点架构的特性：

# 查询三节点的拓扑信息与状态
select * from information_schema.alisql_cluster_global;

# 查询三节点的延迟信息
select * from information_schema.alisql_cluster_health;

查看 PolarDB-X 状态

执行如下命令，查看当前环境的 PolarDB-X 列表：

pxd list

清理 PolarDB-X

执行如下命令，即可清理本地环境所有的 PolarDB-X：

pxd cleanup

集群部署

PXD 除了支持在本地一键创建实例外，也支持在 Linux 集群部署 PolarDB-X，请参考：使用 PXD 在集群部署 PolarDB-X 。

FAQ

非 root 用户如何获取 docker 权限

1.创建 docker 用户组，其实 docker 安装时会自动创建一个名为 docker 的用户组，可以通过查看 /etc/group 确认 docker 用户组的存在，如若不存在则手动创建 docker 用户组

sudo groupadd docker

2.添加当前非 root 用户到 docker 用户组中

sudo gpasswd -a ${USER} docker

3.将当前非 root 用户的 group 切换到 docker 用户组或者退出后重新登录

newgrp docker

4.执行 docker ps 验证

PolarDB-X 端口占用说明

目前本地测试模式，CN，DN，GMS 节点各会占用一个端口，该端口随机生成，如果因为端口冲突导致 PolarDB-X 创建失败，请执行 pxd cleanup 或者 pxd delete {集群名} 清理后重新创建即可。

快速体验

快速开始

准备工作

在 macOS 上准备测试环境

在 CentOS 上准备测试环境

在 Ubuntu 上准备测试环境

在 Windows 上准备测试环境

安装 PXD

部署 PolarDB-X

部署 PolarDB-X 企业版集群

部署 PolarDB-X 标准版集群

查看 PolarDB-X 状态

清理 PolarDB-X

集群部署

FAQ

非 root 用户如何获取 docker 权限

PolarDB-X 端口占用说明

results matching ""

No results matching ""